Componente Área de texto de linha múltipla padrão do JSF
Consulte também
Você pode arrastar o componente Área de texto de linha múltipla padrão do JavaServer Faces
da Paleta para o Visual Designer a fim de fornecer uma área de texto de entrada onde os usuários pode digitar ou colar várias linhas de texto. O equivalente HTML para este componente é <textarea>.
- Este componente é uma implementação de referência JavaServer Faces que não usa temas. O componente Área de texto na categoria Básico da Paleta não suporta temas e fornece outros recursos que melhoram o uso.
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 do valor do componente.
- Selecionar o componente e arrastá-lo para outro local da página.
- 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 de linha múltipla. 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.
- valor. 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 inicialmente exibido nesta propriedade para que o usuário saiba qual tipo de texto deve ser indicado, e pode clicar no botão de reticências e vincular a propriedade a uma tabela de banco de dados ou objeto, a fim de que o valor da propriedade possa ser definido dinamicamente.
- cols. 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.
- 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.
- Clique com o botão direito do mouse no componente e escolha um dos seguintes itens no menu pop-up:
- 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 esteja controlando o valor deste componente).
- Vincular aos dados. Abre a caixa de diálogo que permite vincular a propriedade
value a um objeto ou a um provedor de dados para que a aplicação possa avaliá-lo quando a página for enviada. Para obter mais informações, consulte Caixa de diálogo Vincular aos dados.
- 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 o valor do componente for alterado. 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.
- Configurar formulários virtuais. Permite adicionar o componente a um formulário virtual.
- Vinculações de propriedade. Abre a caixa de diálogo que permite vincular as propriedades do componente a outros objetos ou propriedades que fornecem dados para os valores destas 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.
- Consulte também
- Trabalhando com componentes
- Tarefas de componente: referência rápida
- Sobre a Paleta do Visual Web
Notificações legais