Nesta página
- Sobre formulários do ColdFusion
- Ativar os aprimoramentos feitos no ColdFusion
- Criar formulários do ColdFusion
- Inserir controles de formulário do ColdFusion
- Inserir campos de texto do ColdFusion
- Inserir campos ocultos do ColdFusion
- Inserir áreas de texto do ColdFusion
- Inserir botões do ColdFusion
- Inserir caixas de seleção do ColdFusion
- Inserir botões de opção do ColdFusion
- Inserir caixas de seleção do ColdFusion
- Inserir campos de imagem do ColdFusion
- Inserir campos de arquivo do ColdFusion
- Inserir campos de data do ColdFusion
- Modificar controles de formulário do ColdFusion
- Validar dados de formulário do ColdFusion
Observação:
o suporte ao ColdFusion foi removido do Dreamweaver CC e posterior.
Os formulários do ColdFusion fornecem vários mecanismos incorporados para validar os dados de formulários. Por exemplo, você pode fazer uma verificação para garantir que um usuário digitou uma data válida. Alguns controles de formulários possuem recursos adicionais. Vários não têm correspondentes em HTML e outros suportam diretamente o preenchimento dinâmico de controles de fontes de dados.
O Dreamweaver fornece vários aprimoramentos para os desenvolvedores do ColdFusion que usam o ColdFusion MX 7 ou posterior como servidor de desenvolvimento. esses aprimoramentos incluem mais botões do painel Inserir, itens de menu e inspetores de propriedades para que você possa criar e definir rapidamente as propriedades de formulários do ColdFusion. Você também pode gerar um código que valide as informações fornecidas pelos visitantes do site. Por exemplo, você pode verificar se o endereço de email fornecido por um usuário contém o símbolo @ ou se um campo de texto obrigatório contém um determinado tipo de valor.
Alguns desses aprimoramentos exigem que você defina um computador em que o ColdFusion MX 7 ou posterior esteja em execução como um servidor de teste para o Dreamweaver. Por exemplo, os inspetores de propriedades para controles de formulário só permanecem disponíveis caso você especifique o servidor de teste correto.
Você define um servidor de teste apenas uma vez. Em seguida, o Dreamweaver detecta automaticamente a versão do servidor de teste e faz os aprimoramentos disponíveis caso ele detecte o ColdFusion.
Você pode usar vários botões do painel Inserir, itens de menu e inspetores de propriedades para criar rapidamente formulários do ColdFusion e definir as propriedades no Dreamweaver.
Observação:
esses aprimoramentos só estão disponíveis caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Verifique se o formulário ainda está selecionado e use o Inspetor de propriedades para definir qualquer uma das seguintes propriedades do formulário.
Ação
Permite que você especifique o nome da página do ColdFusion a ser processada quando o formulário for enviado.
Método
Permite que você defina o método usado pelo navegador para enviar os dados do formulário para o servidor:
POST
Envia os dados usando o método post do HTTP; esse método envia os dados em uma mensagem separada para o servidor.
GET
Envia os dados usando o método get do HTTP, que coloca o conteúdo do campo do formulário na sequência de caracteres de consulta do URL.
Observação:
O tipo de codificação não se refere à codificação de caracteres. Esse atributo especifica o tipo de conteúdo usado no envio do formulário para o servidor (quando o valor do método é post). O valor padrão desse atributo é application/x-www-form-urlencoded.
Formato
Determina o tipo de formulário criado:
HTML
Gera um formulário em HTML e o envia para o cliente. Os controles filhos cfgrid e cftree podem estar em Flash ou no formato applet.
Flash
Gera um formulário em Flash e o envia para o cliente. Todos os controles estão no formato Flash.
XML
Gera XForms em XML e coloca os resultados em uma variável com o nome de formulário do ColdFusion. Não envia nada para o cliente. Os controles filhos cfgrid e cftree podem estar em Flash ou no formato applet.
Estilo
Permite que você especifique um estilo para o formulário. Para obter mais informações, consulte a documentação do ColdFusion.
Capa Flash/XML
Permite que você especifique uma cor halo para estilizar a saída. O tema determina a cor usada para elementos realçados e selecionados.
Preservar dados
Determina se é preciso substituir os valores de controle iniciais pelos valores enviados quando o formulário é postado.
Caso seja Falso, os valores especificados nos atributos da tag de controle são usados.
Caso seja Verdadeiro, são usados os valores enviados.
Origem dos scripts
Especifica o URL, relativo à raiz da Web, do arquivo JavaScript que contém o código do cliente usado pela tag e pelas tags filhas. O atributo é útil caso o arquivo não esteja no local padrão. Esse atributo pode ser necessário em alguns ambientes de hospedagem e configurações que bloqueiam o acesso ao diretório /CFIDE. O local padrão é definido no Administrador do ColdFusion; por padrão, ele é /CFIDE/scripts/cfform.js.
-
-
Caso esteja criando um formulário baseado em HTML, você pode usar quebras de linha, quebras de parágrafo, textos pré-formatados ou tabelas para formatar os formulários. Você não pode inserir um formulário do ColdFusion em outro formulário do ColdFusion (ou seja, não é possível sobrepor tags), mas pode incluir mais de um formulário do ColdFusion em uma página.
Caso você esteja criando um formulário baseado em Flash, use os estilos Folhas de estilos em cascatas (CSS) no layout do formulário. O ColdFusion ignora qualquer HTML no formulário.
Lembre-se de identificar os campos do formulário do ColdFusion com um texto descritivo para que os usuários saibam ao que estão respondendo. Por exemplo, crie um rótulo “Digite o seu nome” para solicitar informações sobre o nome.
Use o painel Inserir ou o menu Inserir para inserir rapidamente os controles de formulário do ColdFusion em um formulário do ColdFusion. Você precisa criar um formulário do ColdFusion em branco antes de inserir controles nele.
Observação:
esses aprimoramentos só estão disponíveis caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
Você pode inserir visualmente um campo de texto do ColdFusion ou campo de senha no formulário e definir suas opções.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
Para definir as opções de um campo de texto ou de senha do ColdFusion, defina uma das seguintes opções no Inspetor de propriedades de CFTextField:
Valor
Permite que você especifique o texto a ser exibido no campo quando a página for aberta pela primeira vez em um navegador. As informações podem ser estáticas ou dinâmicas.
Para especificar um valor dinâmico, clique no ícone de raio ao lado da caixa Valor e selecione a coluna de um conjunto de registros na caixa de diálogo Dados dinâmicos. A coluna do conjunto de registros fornece um valor para o campo de texto quando você exibe o formulário em um navegador.
Modo de texto
Permite que você alterne os campos de entrada de texto e de senha padrão. O atributo modificado por esse controle é type.
Máscara
Permite que você especifique uma máscara para o texto solicitado. Você usa essa propriedade para validar a entrada do usuário. O formato da máscara é constituído pelos caracteres A, 9, X e ? .
Observação:
o atributo mask é ignorado para a tag cfinput type="password".
Padrão
Permite que você especifique um padrão de expressão regular JavaScript para validar a entrada. Omita barras à esquerda e à direita. Para obter mais informações, consulte a documentação do ColdFusion.
Obrigatório
Permite que você especifique se o campo de texto deve ou não conter dados para que o formulário seja enviado ao servidor.
Exibir editor de tags
Permite que você edite as propriedades não listadas no Inspetor de propriedades.
Você pode inserir visualmente um campo oculto do ColdFusion no formulário e definir suas propriedades. Use campos ocultos para armazenar e enviar informações não inseridas pelo usuário. As informações permanecem ocultas ao usuário.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Valor
Permite que você especifique um valor para o campo oculto. Os dados podem ser estáticos ou dinâmicos.
Para especificar um valor dinâmico, clique no ícone de raio ao lado da caixa Valor e selecione a coluna de um conjunto de registros na caixa de diálogo Dados dinâmicos. A coluna do conjunto de registros fornece um valor para o campo de texto quando você exibe o formulário em um navegador.
Rótulo
Permite que você especifique um rótulo para o controle. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Padrão
Permite que você especifique um padrão de expressão regular JavaScript para validar a entrada. Omita barras à esquerda e à direita. Para obter mais informações, consulte a documentação do ColdFusion.
Altura
Permite que você especifique a altura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Largura
Permite que você especifique a largura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Tamanho
Permite que você especifique o tamanho do controle. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Você pode inserir visualmente uma área de texto do ColdFusion no formulário e definir suas propriedades. Uma área de texto é um elemento de entrada que consiste em várias linhas de texto.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Quebra automática de linha
Permite que você especifique como quebrar automaticamente a linha do texto digitado pelos usuários.
Obrigatório
Permite que você especifique se o usuário deve inserir dados no campo (marcado) ou não (desmarcado).
Valor inicial
Permite que você especifique o texto a ser exibido na área de texto quando a página for inicialmente aberta em um navegador.
Estilo
Permite que você especifique um estilo para o controle. Para obter mais informações, consulte a documentação do ColdFusion.
Altura
Permite que você especifique a altura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Você pode inserir visualmente um botão do ColdFusion no formulário e definir suas propriedades. Os botões do ColdFusion controlam as operações de formulário do ColdFusion. Eles podem ser usados no envio dos dados de formulário do ColdFusion para o servidor ou na redefinição do formulário do ColdFusion. Os botões padrão do ColdFusion costumam estar identificados com os rótulos Enviar, Redefinir ou Enviar. Você também pode atribuir outras tarefas de processamento definidas em um script. Por exemplo, o botão pode calcular o custo total dos itens selecionados com base em valores atribuídos.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
Você pode inserir visualmente uma caixa de seleção do ColdFusion no formulário e definir suas propriedades. Use as caixas de seleção para permitir que os usuários escolham mais de uma opção em um conjunto de opções.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Selecione a caixa de seleção na página e defina uma das seguintes opções no Inspetor de propriedades:
Valor marcado
Permite que você especifique um valor a ser retornado pela caixa de seleção caso o usuário a marque.
Estado inicial
Permite que você especifique se a caixa de seleção permanece marcada quando a página é aberta pela primeira vez em um navegador.
Padrão
Permite que você especifique um padrão de expressão regular JavaScript para validar a entrada. Omita barras à esquerda e à direita. Para obter mais informações, consulte a documentação do ColdFusion.
Altura
Permite que você especifique a altura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Largura
Permite que você especifique a largura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Tamanho
Permite que você especifique o tamanho do controle. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Você pode inserir visualmente um botão de opção do ColdFusion no formulário e definir suas propriedades. Use botões de opção quando quiser que os usuários selecionem apenas uma dentre um conjunto de opções. Os botões de opção costumam ser usados em grupos. Todos os botões de opção em um grupo devem ter o mesmo nome.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Valor marcado
Permite que você especifique um valor a ser retornado pelo botão de opção caso o usuário a marque.
Estado inicial
Permite que você especifique se o botão de opção permanece selecionado quando a página é aberta pela primeira vez em um navegador.
Padrão
Permite que você especifique um padrão de expressão regular JavaScript para validar a entrada. Omita barras à esquerda e à direita. Para obter mais informações, consulte a documentação do ColdFusion.
Altura
Permite que você especifique a altura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Largura
Permite que você especifique a largura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Tamanho
Permite que você especifique o tamanho do controle. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Você pode inserir visualmente uma caixa de seleção do ColdFusion no formulário e definir suas propriedades. Uma caixa de seleção permite que um visitante selecione um ou mais itens de uma lista. As caixas de seleção são úteis quando você tem uma quantidade de espaço limitada, mas precisa exibir muitos itens. Elas também são muito úteis quando você deseja controlar os valores retornados ao servidor. Diferentemente dos campos de texto, nos quais os usuários digitam o que querem, inclusive dados inválidos, com as caixas de seleção, você pode definir os valores exatos retornados por um menu.
Você pode inserir dois tipos de caixas de seleção em um formulário: um menu que é “suspenso” quando o usuário clica nele ou um menu que exibe uma lista rolável de itens que o usuário pode selecionar.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Selecione a caixa de seleção na página e defina uma das seguintes opções no Inspetor de propriedades:
Tipo
Permite que você escolha um menu pop-up ou uma lista. Caso você selecione o tipo lista, as opções Listar altura e Permitir várias seleções de lista são disponibilizadas.
Listar altura
Permite que você especifique o número de linhas a serem exibidas no menu da lista. Só disponível caso você selecione o tipo lista.
Permitir várias seleções de lista
Permite que você especifique se o usuário pode selecionar mais de uma opção da lista por vez. Só disponível caso você selecione o tipo lista.
Editar valores
Abre uma caixa de diálogo que permite que você adicione, edite ou remova opções da caixa de seleção.
Selecionados inicialmente
Permite que você especifique a opção selecionada por padrão. Você pode selecionar mais de uma opção caso tenha selecionado a opção Permitir várias seleções de lista.
Conjunto de registros
Permite que você especifique o nome da consulta do ColdFusion que deseja usar para preencher a lista ou o menu.
Exibir coluna
Permite que você especifique a coluna do conjunto de registros para fornecer o rótulo de exibição de cada elemento da lista. Usado com a propriedade Conjunto de registros.
Coluna de valor
Permite que você especifique a coluna do conjunto de registros para fornecer o valor de cada elemento da lista. Usado com a propriedade Conjunto de registros.
Altura do Flash
Permite que você especifique a altura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Largura do Flash
Permite que você especifique a largura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Mensagem
Especifica a mensagem a ser exibida se a propriedade Obrigatório for definida como Sim e o usuário deixar de fazer uma seleção antes de enviar o formulário.
Você pode inserir visualmente um campo de imagem do ColdFusion no formulário e definir suas opções. Use os campos de imagem para criar botões personalizados.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Na categoria CFForm do painel Inserir, clique no ícone Campo de imagem do CF. Navegue para selecionar a imagem a ser inserida e clique em OK. Se desejar, você pode digitar o caminho do arquivo de imagem na caixa Origem.
Observação:
caso a imagem esteja fora da pasta raiz do site, você deve copiar a imagem para a pasta raiz. As imagens que estão fora da pasta raiz talvez não estejam acessíveis quando você publicar o site.
-
Selecione o campo da imagem na página e defina uma das seguintes opções no Inspetor de propriedades:
Editar imagem
Abra a imagem no editor de imagens padrão.
Para definir um editor de imagens padrão, selecione Editar > Preferências > Tipos de arquivos / editores. Do contrário, o botão Editar imagem não realiza nenhuma ação.
Padrão
Permite que você especifique um padrão de expressão regular JavaScript para validar a entrada. Omita barras à esquerda e à direita. Para obter mais informações, consulte a documentação do ColdFusion.
Tamanho
Permite que você especifique o tamanho do controle. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Você pode inserir visualmente um campo de arquivo do ColdFusion no formulário e definir suas propriedades. Use um campo de arquivo para permitir que os usuários selecionem um arquivo do computador como, por exemplo, um documento de processamento de textos ou um arquivo gráfico e carreguem-no servidor. Um campo de arquivo do ColdFusion é semelhante aos demais arquivos de texto, exceto por também conter um botão Procurar. Os usuários podem digitar manualmente o caminho do arquivo que desejam carregar ou usar o botão Procurar para localizar e selecionar o arquivo.
Os campos de arquivo exigem que você use o método POST para transmitir os arquivos do navegador para o servidor. O arquivo é postado no endereço que você especificou na caixa Ação do formulário. Entre em contato com o administrador do sistema para confirmar se há permissão para carregamentos de arquivo anônimos antes de usar um campo de arquivo no formulário.
Os campos de arquivo também exigem que a codificação do formulário seja definida como multipart/form. O Dreamweaver define isso automaticamente quando você insere um controle do campo de arquivo.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Selecione o campo de arquivo na página e defina uma das seguintes propriedades no Inspetor de propriedades:
Comprimento máximo
Permite que você especifique o número máximo de caracteres que o caminho do arquivo pode ter.
Padrão
Permite que você especifique um padrão de expressão regular JavaScript para validar a entrada. Omita barras à esquerda e à direita. Para obter mais informações, consulte a documentação do ColdFusion.
Altura
Permite que você especifique a altura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Largura
Permite que você especifique a largura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.
Embora você não possa inserir visualmente um campo de data do ColdFusion no Dreamweaver, é possível definir visualmente suas propriedades. Um campo de data do ColdFusion é um tipo de campo de texto especial que permite aos usuários selecionar uma data em um calendário pop-up e inseri-la no campo de texto.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
Alterne para a visualização Design, selecione o campo de data na página e defina uma das seguintes opções no Inspetor de propriedades:
Valor
Permite que você especifique uma data a ser exibida no campo quando a página for aberta pela primeira vez em um navegador. A data pode ser estática ou dinâmica.
Para especificar um valor dinâmico, clique no ícone de raio ao lado da caixa Valor e selecione a coluna de um conjunto de registros na caixa de diálogo Dados dinâmicos. A coluna do conjunto de registros fornece um valor para o campo de data quando você exibe o formulário em um navegador.
Padrão
Permite que você especifique um padrão de expressão regular JavaScript para validar a entrada. Omita barras à esquerda e à direita. Para obter mais informações, consulte a documentação do ColdFusion.
Você pode alterar visualmente as propriedades dos controles de formulário do ColdFusion independentemente de estar trabalhando na visualização Design ou Código.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
Você pode criar formulários do ColdFusion no Dreamweaver que verifiquem o conteúdo de campos especificados para garantir que o usuário inseriu o tipo de dados correto.
Observação:
esse aprimoramento só está disponível caso você tenha acesso a um computador que esteja executando o ColdFusion MX 7 ou posterior.
-
A parte inferior de cada Inspetor de propriedades de entrada contém controles que ajudam a definir a regra de validação específica. Por exemplo, talvez você queira especificar se um campo de texto deve conter um número de telefone. Para isso, selecione Telefone no menu pop-up Valor do Inspetor de propriedades. Você também pode especificar quando validar no menu pop-up Validar em.
As publicações do Twitter™ e do Facebook não são cobertas pelos termos do Creative Commons.