Componente Área de texto do JSF 1.2
Consulte também
O componente Área de texto
é uma área de entrada de texto na qual os usuários podem inserir várias linhas de texto. O equivalente HTML para este componente é <textarea>.
-
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:textArea.
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. Clique fora do componente e a sua entrada será salva na propriedade
text do componente. Você também pode vincular esta propriedade a um objeto ou a um campo de uma tabela de banco de dados que pode exibir um valor e receber o texto digitado pelo usuário, como descrito abaixo de Vincular aos dados.
- Selecione o componente e edite suas propriedades na janela Propriedades da Área de texto. Algumas propriedades típicas que você pode definir são:
- id. O nome do componente Área 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 TextArea.
- colunas. A largura em caracteres da área de texto. Se o usuário digitar mais caracteres do que cobem, os caracteres quebrarão automaticamente na próxima linha.
- 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 seu posicionamento em relação ao componente.
- linhas. O número de linhas de texto a serem exibidas de cada vez no componente. O usuário pode rolar o texto para cima e para abaixo se houver mais linhas do que o componente possa exibir de cada vez.
- Os navegadores da Web fazem suposições diferentes sobre o número de linhas a serem renderizadas para este componente. Uma solução alternativa é definir a propriedade
height na propriedade style. Por exemplo, altura: 100; define a altura para 100 pixels.
- texto O texto que o usuário insere. Este texto é enviado para o servidor quando a página é enviada. Você também pode especificar um valor a ser exibido inicialmente nesta 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 da Área 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