Componente Campo de texto do JSF 1.2
Consulte também
O componente Campo de texto
é um campo de entrada de texto no qual os usuários podem inserir linhas únicas de texto. O HTML equivalente para este componente é <input type ="text">.
-
Este componente possui suporte para funções JavaScript do lado do cliente que permitem realizar ações no cliente sem voltar ao servidor. Para obter mais informações sobre este recurso avançado, escolha Ajuda > Referência Javadoc > Biblioteca de marcas do Projeto Woodstock 4.2 e vá até webuijsf:textField.
Depois de arrastar o componente para o Visual Designer, você pode:
- Alterar o texto exibido do componente, selecionando o componente e digitando o novo texto. Pressione Enter para salvar o texto na propriedade
text do componente. Você também pode vincular esta propriedade a um objeto ou campo de uma tabela de banco de dados que pode exibir um valor e receber o texto digitado pelo usuário.
- Edite as propriedades do componente na janela Propriedades do Campo de texto. Algumas propriedades típicas que você pode definir são:
- id. O nome do componente Campo de texto. No arquivo JSP, este nome é o valor do atributo
id do componente. No bean de página, o valor desta propriedade é o nome do objeto TextField.
- colunas. A largura do campo de texto em caracteres. Se o usuário digitar mais caracteres dos que cabem, o campo rola horizontalmente.
- rótulo. Texto descritivo que é exibido à esquerda do campo.
- A propriedade
label não é tão flexível quanto o componente Rótulo. Você pode usar o componente Rótulo se quiser ter mais controle sobre a aparência do rótulo, tal como o posicionamento do rótulo em relação ao componente.
- texto. O texto que o usuário indica. Este texto é enviado para o servidor quando a página é enviada. Você também pode especificar um valor a ser exibido inicialmente para esta propriedade ou pode clicar no botão de reticências e vincular a propriedade a uma tabela de banco de dados ou objeto para que o valor da propriedade possa ser definido e selecionado dinamicamente.
- Clique com o botão direito do mouse no componente e escolha um dos seguintes itens no menu pop-up:
- Editar in-line Seleciona o componente ou o rótulo para que você possa digitar diretamente.
- Texto. Digita o texto que aparecerá por padrão quando o componente for exibido. Quando você clica fora do componente, a propriedade
text é atualizada com o texto.
- Rótulo. Digita o texto de um rótulo que aparecerá ao lado do componente. Pressione Enter para atualizar a propriedade
label com este texto.
- A propriedade
label não é tão flexível quanto o componente Rótulo. Você pode usar o componente Rótulo se quiser ter mais controle sobre a aparência do rótulo, tal como o seu posicionamento em relação ao componente.
- Editar manipulador de eventos. Escreve o código de um dos manipuladores de eventos a seguir.
- validate. Abre o Editor de Java com o cursor posicionado no método
validate do componente para que você possa inserir o código para validar o valor do componente.
- processValueChange. Abre o Editor Java com o cursor posicionado no método
processValueChange do componente para que você possa inserir o código que é executado quando o valor deste componente sofrer alterações (por exemplo, quando o usuário altera o valor de outro componente que está controlando o valor deste componente).
- Definir foco inicial Coloca o foco neste componente quando o usuário abre a página e coloca um cursor de edição no campo.
- Enviar automaticamente ao alterar Faz com que o formulário seja enviado automaticamente se o valor do componente sofrer alterações. Define a propriedade onclick JavaScript do componente como
common_timeoutSubmitForm(this.form, 'id-do-componente');. Em tempo de execução, este código faz com que o formulário seja enviado automaticamente se o usuário alterar o valor do componente. Depois de o formulário ter sido enviado, ocorre a conversão e a validação no servidor, quaisquer métodos ouvintes de alteração de valor são executados e, em seguida, a página é reexibida.
Um componente configurado como Enviar automaticamente ao alterar pode usar formulários virtuais para limitar os campos de entrada processados quando o formulário é enviado. Se o componente de envio automático for definido para enviar um formulário virtual, somente os participantes de tal formulário virtual serão processados quando o envio automático ocorrer.
- Vincular aos dados. Abre uma caixa de diálogo que permite vincular a propriedade
text do componente a um objeto ou provedor de dados, conforme descrito no tópico Caixa de diálogo Vincular aos dados.
- Vinculações de propriedade. Abre a caixa de diálogo que permite vincular as propriedades dos componentes, além da propriedade
text, a outros objetos ou beans de propriedades que atualizam automaticamente estas propriedades do componente.
- Adicionar atributo de vinculação. Essa opção adiciona um atributo de vinculação ao componente
- Observação: se você planeja fazer o script do componente em código Java, deve adicionar um atributo de vinculação manualmente, que é vinculado usando uma expressão vinculadora de valor a uma propriedade do bean da página de backup.
- Remover atributo de vinculação Essa opção remove o atributo de vinculação do componente.
- Configurar formulários virtuais. Permite adicionar o componente a um formulário virtual.
- Observação: as alças de redimensionamento foram removidas deste componente a fim de ativar o comportamento do Ajax.
- Consulte também
- Janela Propriedades do Campo de texto
- Vinculando propriedades do componente
- Trabalhando com componentes
- Tarefas de componente: referência rápida
- Sobre a Paleta do Visual Web
Notificações legais