Observação:

o suporte ao ColdFusion foi removido do Dreamweaver CC e posterior.

Sobre formulários do ColdFusion

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.

Ativar os aprimoramentos feitos no ColdFusion

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.

  1. Caso você ainda não tenha feito isso, defina um site do Dreamweaver para o projeto do ColdFusion.
  2. Selecione Site > Gerenciar sites, selecione seu site da lista e clique em Editar.
  3. Selecione a categoria Servidores e especifique um computador que esteja executando o ColdFusion MX 7 ou posterior como sendo o servidor de teste para o site do Dreamweaver. Verifique se você especificou um URL da Web.
  4. Abra um documento qualquer do ColdFusion.

    Você não verá nenhuma alteração visível feita no espaço de trabalho do Dreamweaver até abrir um documento do ColdFusion.

Criar formulários do 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.

  1. Abra uma página do ColdFusion e coloque o ponto de inserção onde você deseja que o formulário do ColdFusion seja exibido.
  2. Selecione Inserir > Objetos do ColdFusion > CFForm > CFForm ou selecione a categoria CFForm do painel Inserir e clique no ícone CF Form.

    O Dreamweaver insere um formulário do ColdFusion vazio. Na visualização Design, o formulário é indicado por um contorno vermelho pontilhado. Caso você não veja esse contorno, verifique se Exibir > Auxílios visuais > Elementos invisíveis está selecionado.

  3. Verifique se o formulário ainda está selecionado e use o Inspetor de propriedades para definir qualquer uma das seguintes propriedades do formulário.

    CFForm

    Define o nome 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.

    Alvo

    Permite que você modifique o valor do atributo-alvo da tag cfform.

    Tipo de codificação

    Especifica o método de codificação usado na transmissão dos dados do formulário.

    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.

    Arquivamento

    Especifica o URL das classes Java para download dos controles de applet cfgrid, cfslider e cftree. O local padrão é /CFIDE/classes/cfapplets.jar.

    Altura

    Especifica a altura do formulário.

    Largura

    Especifica a largura do formulário.

    Exibir Editor de tags para cfform

    Permite que você edite as propriedades não listadas no Inspetor de propriedades.

  4. Insira os controles de formulário do ColdFusion.

    Coloque o ponto de inserção onde deseja que o controle seja exibido no formulário do ColdFusion e selecione o controle no menu Inserir (Inserir > Objetos do ColdFusion > CFForm) ou na categoria CFForm do painel Inserir.

  5. Se necessário, defina as propriedades do controle usando o Inspetor de propriedades.

    Verifique se o controle está selecionado na visualização Design e defina as propriedades no Inspetor de propriedades. Para obter mais informações sobre as propriedades, clique no ícone Ajuda do Inspetor de propriedades.

  6. Ajuste o layout do formulário do ColdFusion.

    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.

Inserir controles de formulário do ColdFusion

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.

  1. Na visualização Design, coloque o ponto de inserção dentro do contorno do formulário.
  2. Selecione o controle no menu Inserir (Inserir > Objetos do ColdFusion > CFForm) ou na categoria CFForm do painel Inserir.
  3. Clique no controle da página para selecioná-la e definir suas propriedades no Inspetor de propriedades.

    Para obter informações sobre as propriedades de controles específicos, consulte os tópicos sobre os controles.

Inserir campos de texto do ColdFusion

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.

Inserir virtualmente um campo de texto do ColdFusion

  1. Na visualização Design, coloque o ponto de inserção dentro do contorno do formulário.
  2. Na categoria CFForm do painel Inserir, clique no ícone Campo de texto do CF ou selecione Inserir > Objetos do ColdFusion > CFForm > CFtextfield.

    Um campo de texto é exibido no formulário.

  3. Selecione o campo de texto e defina suas propriedades no Inspetor de propriedades.
  4. Para identificar o campo de texto na página, clique ao lado dele e digite o texto do rótulo.

Inserir visualmente um campo de senha

  1. Repita as etapas 1 e 2 do procedimento anterior para inserir um campo de texto.
  2. Selecione o campo de texto inserido para exibir o seu Inspetor de propriedades.
  3. Selecione o valor Senha no menu pop-up Modo de texto do Inspetor de propriedades.

Opções de CFTextField (ColdFusion)

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:

CFtextfield

Define o atributo id da tag <cfinput>.

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.

Somente leitura

Permite que você torne o texto exibido somente leitura.

Comprimento máximo

Define o número máximo de caracteres aceitos pelo campo de texto.

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".

Validar

Especifica o tipo de validação do campo atual.

Validar em

Especifica quando o campo é validado: onSubmit, onBlur ou onServer.

Rótulo

Permite que você especifique um rótulo para o campo de texto.

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.

Largura

Permite que você especifique a largura do controle, em pixels.

Tamanho

Permite que você especifique o tamanho do controle.

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.

Inserir campos ocultos do ColdFusion

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.

  1. Na visualização Design, coloque o ponto de inserção dentro do contorno do formulário.
  2. Na categoria CFForm do painel Inserir, clique no ícone Campo oculto do CF.

    Um marcador é exibido no formulário do ColdFusion. Se você não vir o marcador, selecione Exibir > Auxílios visuais > Elementos invisíveis.

  3. Selecione o campo oculto na página e defina uma das seguintes opções no Inspetor de propriedades:

    Cfhiddenfield

    Permite que você especifique o nome exclusivo do campo oculto.

    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.

    Validar

    Especifica o tipo de validação do campo atual.

    Validar em

    Especifica quando o campo é validado: onSubmit, onBlur ou onServer.

    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.

    Obrigatório

    Permite que você especifique se o campo oculto 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.

Inserir áreas de texto do ColdFusion

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.

  1. Coloque o ponto de inserção dentro do contorno do formulário.
  2. Na categoria CFForm do painel Inserir, clique no ícone Área de texto do CF.

    Uma área de texto é exibida no formulário do ColdFusion.

  3. Selecione a área de texto na página e defina uma das seguintes opções no Inspetor de propriedades:

    Cftextarea

    Permite que você especifique um nome exclusivo para o controle.

    Largura do caractere

    Permite que você defina o número de caracteres por linha.

    Número de linhas

    Permite que você defina o número de linhas a serem exibidas na área de texto.

    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.

    Validar

    Especifica o tipo de validação do campo.

    Validar em

    Especifica quando o campo é validado: onSubmit, onBlur ou onServer.

    Rótulo

    Permite que você especifique um rótulo para o controle.

    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.

    Largura

    Permite que você especifique a largura do controle, em pixels. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.

    Exibir editor de tags

    Permite que você edite as propriedades não listadas no Inspetor de propriedades.

  4. Para identificar a área de texto, clique ao lado dela e digite o texto do rótulo.

Inserir botões do ColdFusion

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.

  1. Coloque o ponto de inserção dentro do contorno do formulário do ColdFusion.
  2. Na categoria CFForm do painel Inserir, clique no ícone Botão do CF.

    Um botão é exibido no formulário do ColdFusion.

  3. Selecione o botão na página e defina uma das seguintes opções no Inspetor de propriedades:

    Cfbutton

    Permite que você especifique um nome exclusivo para o controle.

    Ação

    Permite que você especifique o tipo de botão a ser criado.

    Exibir editor de tags

    Permite que você edite as propriedades não listadas no Inspetor de propriedades.

    As demais propriedades são ignoradas pelo servidor do ColdFusion durante o runtime.

Inserir caixas de seleção do ColdFusion

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.

  1. Coloque o ponto de inserção dentro do contorno do formulário.
  2. Na categoria CFForm do painel Inserir, clique no ícone Caixa de seleção do CF.

    Uma caixa de seleção é exibida no formulário do ColdFusion.

  3. Selecione a caixa de seleção na página e defina uma das seguintes opções no Inspetor de propriedades:

    Cfcheckbox

    Permite que você especifique um nome exclusivo para o controle.

    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.

    Validar

    Especifica o tipo de validação da caixa de seleção.

    Validar em

    Especifica quando a caixa de seleção é validada: onSubmit, onBlur ou onServer.

    Rótulo

    Permite que você especifique um rótulo para a caixa de seleçã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.

    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.

    Obrigatório

    Permite que você especifique se a caixa de seleção deve permanecer marcada 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.

  4. Para identificar a caixa de seleção, clique ao lado dela na página e digite o texto do rótulo.

Inserir botões de opção do ColdFusion

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.

  1. Coloque o ponto de inserção dentro do contorno do formulário.
  2. Selecione Inserir > Objetos do ColdFusion > CFForm > CFradiobutton.

    Um botão de opção é exibido no formulário do ColdFusion.

  3. Selecione o botão de opção na página e defina uma das seguintes opções no Inspetor de propriedades:

    Cfradiobutton

    Permite que você especifique um nome exclusivo para o controle.

    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.

    Validar

    Especifica o tipo de validação do botão de opção.

    Validar em

    Especifica quando o botão de opção é validado: onSubmit, onBlur ou onServer.

    Rótulo

    Permite que você especifique um rótulo para o botão de opçã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.

    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.

    Obrigatório

    Permite que você especifique se o botão de opção deve permanecer selecionado 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.

  4. Para identificar o botão de opção, clique ao lado dele na página e digite o texto do rótulo.

Inserir caixas de seleção do ColdFusion

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.

  1. Coloque o ponto de inserção dentro do contorno do formulário.
  2. Na categoria CFForm do painel Inserir, clique no ícone Marcação do CF.

    Uma caixa de seleção é exibida no formulário do ColdFusion.

  3. Selecione a caixa de seleção na página e defina uma das seguintes opções no Inspetor de propriedades:

    Cfselect

    Permite que você especifique um nome exclusivo para o controle.

    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.

    Rótulo do Flash

    Permite que você especifique um rótulo para a caixa de seleção.

    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.

    Obrigatório

    Permite que você especifique se um item de menu deve permanecer selecionado 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.

Inserir campos de imagem do ColdFusion

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.

  1. Na visualização Design, coloque o ponto de inserção dentro do contorno do formulário.
  2. 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.

  3. Selecione o campo da imagem na página e defina uma das seguintes opções no Inspetor de propriedades:

    Cfimagefield

    Permite que você especifique um nome exclusivo para o controle.

    Origem

    Permite que você especifique o URL da imagem inserida.

    Alt

    Permite que você especifique uma mensagem quando a imagem não puder ser exibida.

    Alinhar

    Permite que você especifique o alinhamento da figura.

    Borda

    Permite que você defina a largura da borda da imagem.

    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.

    Validar

    Especifica o tipo de validação do campo de imagem.

    Validar em

    Especifica quando o campo é validado: onSubmit, onBlur ou onServer.

    Rótulo

    Permite que você especifique um rótulo para o botão de opçã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.

    Altura

    Permite que você especifique a altura do controle, em pixels.

    Largura

    Permite que você especifique a largura do controle, em pixels.

    Tamanho

    Permite que você especifique o tamanho do controle. Essa propriedade é ignorada pelo servidor do ColdFusion durante o runtime.

    Obrigatório

    Permite que você especifique se o controle 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.

Inserir campos de arquivo do ColdFusion

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.

  1. Na visualização Design, selecione CFForm para exibir o Inspetor de propriedades.

    Para selecionar rapidamente o formulário, clique em qualquer lugar do contorno na tag<cfform> do seletor na parte inferior da janela Documento.

  2. No Inspetor de propriedades, defina o método do formulário como POST.
  3. No menu pop-up Tipo de codif., selecione multipart/form-data.
  4. Posicione o ponto de inserção dentro do contorno do formulário onde você deseja que o campo de arquivo seja exibido.
  5. Selecione Inserir > Objetos do ColdFusion > CFForm > CFfilefield.

    Um campo de arquivo é exibido no documento.

  6. Selecione o campo de arquivo na página e defina uma das seguintes propriedades no Inspetor de propriedades:

    Cffilefield

    Permite que você especifique um nome exclusivo para o controle.

    Comprimento máximo

    Permite que você especifique o número máximo de caracteres que o caminho do arquivo pode ter.

    Validar

    Especifica o tipo de validação do campo.

    Validar em

    Especifica quando o campo é validado: onSubmit, onBlur ou onServer.

    Rótulo

    Permite que você especifique um rótulo para o campo.

    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.

    Obrigatório

    Permite que você especifique se o campo de arquivo 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.

Inserir campos de data do ColdFusion

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.

  1. Na visualização Design, selecione CFForm para exibir o Inspetor de propriedades.

    Para selecionar rapidamente o formulário, clique em qualquer lugar do contorno na tag<cfform> do seletor na parte inferior da janela Documento.

  2. No Inspetor de propriedades, defina a propriedade Formato do formulário como Flash.

    O controle do campo de data só pode ser processado em formulários do ColdFusion baseados em Flash.

  3. Alterne para a visualização Código (Exibir > Código) e insira a seguinte tag em qualquer lugar entre as tags CFForm de abertura e de finalização:
    <cfinput name="datefield" type="datefield">
  4. 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:

    Cfdatefield

    Permite que você especifique um nome exclusivo para o controle.

    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.

    Validar

    Especifica o tipo de validação do campo.

    Validar em

    Especifica quando o campo é validado: onSubmit, onBlur ou onServer.

    Rótulo

    Permite que você especifique um rótulo para o campo.

    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.

    Largura

    Permite que você especifique a largura do controle, em pixels.

    Tamanho

    Permite que você especifique o tamanho do controle.

    Obrigatório

    Permite que você especifique se o campo de data deve ou não conter um valor 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.

Modificar controles de formulário 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.

  1. Na visualização Design, selecione o controle de formulário na página; na visualização Código, clique em qualquer lugar dentro da tag do controle.

    O Inspetor de propriedades exibe as propriedades do controle de formulário.

  2. Altere as propriedades do controle no Inspetor de propriedades.

    Para obter mais informações, clique no ícone Ajuda do Inspetor de propriedades.

  3. Para definir mais propriedades, clique no botão Exibir editor de tags do Inspetor de propriedades e defina as propriedades no Editor de tags exibido.

Validar dados de formulário do ColdFusion

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.

  1. Crie um formulário do ColdFusion que inclua pelo menos um campo de entrada e um botão Enviar. Verifique se todos os campos do ColdFusion que você deseja validar têm um nome exclusivo.
  2. Selecione um campo no formulário que você deseja validar.
  3. No Inspetor de propriedades, especifique como você deseja validar o campo.

    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.

Esta obra está licenciada sob uma licença não adaptada da Creative Commons Attribution-Noncommercial-Share Alike 3.0  As publicações do Twitter™ e do Facebook não são cobertas pelos termos do Creative Commons.

Avisos legais   |   Política de privacidade online