Componente Campo de texto do JSF 1.1
Consulte também
Você pode arrastar o componente Campo de texto
da Paleta para o Visual Designer a fim de fornecer um campo de entrada de texto onde os usuários podem digitar ou colar linhas de texto únicas. O HTML equivalente para este componente é <input type ="text">.
-
Este é um componente JavaServer Faces 1.1. Você vê os componentes que usam essa
versão do JavaServer Faces quando o seu projeto usa J2EE 1.4 ou J2EE 1.3.
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.
- 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.
- 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.
- colunas. A largura do campo de texto em caracteres. Se o usuário digitar mais caracteres dos que cabem, o campo rola horizontalmente.
- Clique com o botão direito do mouse no componente e escolha um dos seguintes itens no menu pop-up:
- Editar texto. Digita o texto que aparecerá por padrão quando o componente for exibido. Quando você pressiona Enter ou clica fora do componente, a propriedade
text é atualizada com o texto.
- Editar 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çãoEssa opção remove o atributo de vinculação do componente.
- Configurar formulários virtuais. Permite adicionar o componente a um formulário virtual.
- Consulte também
- Vinculando propriedades do componente
- Trabalhando com componentes
- Tarefas de componente: referência rápida
- Sobre a Paleta do Visual Web
Notificações legais