Você vê a janela Propriedades de um componente Área de texto de linha múltipla do JavaServer Faces quando seleciona o componente em uma página que está editando no Visual Designer.
A maioria das propriedades do componente Área de texto são atributos JSP e propriedades do componente Java HtmlInputTextarea no bean de página.
Este componente JavaServer Faces padrão possui as propriedades a seguir.
Geral
id. Tipo: text
O nome do componente Área de texto no bean de página e o arquivo JSP.
Aparência
cols. Tipo: int
A largura em caracteres da área de texto. Se o usuário digitar mais caracteres do que cabe nesta área, o texto quebrará automaticamente na próxima linha.
disabled. Tipo: booleano
Se for selecionada, indicará que o componente nunca deverá receber o foco ou ser incluído em um envio. Consulte a observação abaixo da propriedade readOnly sobre os efeitos do uso da propriedade disabled em comparação ao efeito do uso da propriedade readOnly.
readonly. Tipo: booleano
Se selecionada, torna possível para o usuário indicar o texto, mas o valor será enviado.
Um campo somente leitura é incluído quando a página é enviada, ao contrário de um campo desativado, que não é incluído. Em praticamente cada caso em que você pense em usar a propriedade desativada para não permitir que o usuário altere o valor, use a propriedade readonly. Se você usar a propriedade disabled, o JavaServer Faces não detectará que algum valor tenha sido enviado.
rows. Tipo: int
O número de linhas de texto a serem exibidas de cada vez. O usuário pode rolar para cima e para baixo a fim de ver mais linhas de texto.
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.
style. Tipo: String
Regras de folha de estilo em cascata (CSS nível 2) a serem aplicadas ao componente. Esta propriedade sobrescreve as configurações do arquivo CSS do projeto. Por exemplo:
position: absolute; left: 288px; top: 312px
Você pode inserir valores diretamente ou clicar no botão de reticências (...) para usar o Editor de estilo.
Para obter uma lista de estilos CSS2, consulte a página da Web em
styleClass. Tipo: String
Indique uma lista separada por espaços de classes de estilo CSS2 a serem aplicadas quando o componente é renderizado. As classes do estilo devem ser definidas na folha de estilo do projeto. Se você clicar no botão de reticências (...), verá uma lista de todos os estilos que podem ser adicionados a esta propriedade. Para obter informações sobre a adição de classes CSS e regras na folha de estilos em cascata do projeto, consulte Editor CSS.
title. Tipo: String
Informações sobre o componente que podem ser lidas por um leitor de tela e podem ser exibidas como uma dica de ferramenta.
Se o componente for desativado, a dica de ferramenta não será exibida na maioria dos navegadores.
Dados
converter. Tipo: Conversor
Um conversor JavaServer Faces que produz o tipo correto do valor da propriedade value. Se o usuário inserir o tipo incorreto de valor, tal como uma palavra em vez de um número em um Conversor de inteiro, o conversor enviará uma mensagem que você poderá exibir em um componente Mensagem in-line.
required. Tipo: booleano
Se for selecionada, o usuário deverá inserir um valor no campo antes que a página seja enviada. Se o usuário não indicar o texto e tentar enviar a página, tudo o que ele vê é que o envio parece não fazer nada. Você deve adicionar o código que fornece uma mensagem, se quiser que o usuário seja notificado de que precisa indicar o texto.
validator. Tipo: MethodBinding
Indica o validador JavaServer Faces que é chamado quando o valor é enviado. Escolha um validador na lista suspensa. Se você escolher (null), nenhum validador será chamado. Se as condições definidas pelo validador não forem atendidas, o validador enviará uma mensagem que você pode exibir em um componente Mensagem in-line.
Se você escolher um validador, talvez também queira selecionar a propriedade required para garantir que o validador receba um valor.
Se você definir o seu próprio método de validação, por exemplo, clicando com o botão direito do mouse no componente e escolhendo Editar manipulador de eventos > validar, qualquer validador que você tenha especificado nesta propriedade será sobrescrito pelo nome do seu método de validação.
value. Tipo: Objeto
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.
Eventos
Defina as propriedades do evento, clicando com o botão direito no mouse no Visual Designer e escolhendo Editar manipulador de eventos > nome do evento.
validate. Indica o nome do método chamado para validar o valor do componente. Se você deseja codificar um método de validador em vez de escolher um validador JavaServer Faces para a propriedade validator, clique com o botão direito do mouse no componente e escolha Editar manipulador de eventos > Validar. O nome padrão do método é id-do-componente_validate, onde id-do-componente é o valor da propriedade id do componente. Quando você define este método desta forma, as propriedades validator e validate são definidas automaticamente para você. Se você definir um validador, selecione também a propriedade required para garantir que esse validador seja usado.
A configuração desta propriedade também define o valor da propriedade validator. Se você definir o seu próprio método de validação, não altere separadamente o valor da propriedade validator, ou você poderia perder a conexão com o método de validação.
valueChange. Indica o nome do método ouvinte de alteração de valor do componente que é chamado quando o valor do componente é alterado. Geralmente este método é definido no bean de página, clicando com o botão direito do mouse no componente na janela Navegador e escolhendo Editar manipulador de eventos > processValueChange. O nome padrão do método é id-do-componente_processValueChange, onde id-do-componente é o valor da propriedade id.
JavaScript
onblur. Tipo: String
JavaScript a ser executado quando o componente perde o foco.
onchange. Tipo: String
JavaScript a ser executado quando o componente perde o foco e seu valor é modificado depois de ganhar o foco.
onclick. Tipo: String
JavaScript a ser executado quando o usuário clica no componente.
ondblclick. Tipo: String
JavaScript a ser executado quando o usuário clica duas vezes no componente.
onfocus. Tipo: String
JavaScript a ser executado quando o componente recebe o foco.
onkeydown. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é pressionada.
onkeypress. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é pressionada e liberada.
onkeyup. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é liberada.
onmousedown. Tipo: String
JavaScript a ser executado quando o cursor do mouse está sobre o componente e o usuário pressiona o botão do mouse.
onmousemove. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse no componente.
onmouseout. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse para longe do componente, depois de estar sobre o componente.
onmouseover. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse para o componente.
onmouseup. Tipo: String
JavaScript a ser executado quando o cursor do mouse está sobre o componente e o usuário libera o botão do mouse.
onselect. Tipo: String
JavaScript a ser executado quando o usuário seleciona texto no componente.
Avançado
accesskey. Tipo: String
Uma tecla ou atalho de teclado, que ativa este campo de texto. Você pode indicar qualquer caractere válido que possa ser pressionado no teclado. Equivalente ao atributo accesskey da marca HTML <input>.
dir. Tipo: String
Um indicador da direcionalidade se o texto não herdar a direcionalidade (por exemplo, porque o texto está em inglês mas o idioma principal da página é hebraico). Equivalente ao atributo dir da marca HTML <input>.
Os valores podem ser:
LTR. Esquerda para direita.
RTL. Direita para esquerda.
immediate. Tipo: booleano
Se esta propriedade for selecionada, quando o usuário ativar o componente, o código na página será executado antes da validação, atualização de valores do modelo, etc. Finalmente, a execução do código acontece imediatamente no servidor que, em seguida, retorna a página.
O exemplo mais comum de uma ação imediata é um botão Cancelar. Você o torna imediato para que a validação normal e as etapas de atualização possam ser ignoradas, mas o manipulador de ações ainda poderá fazer o que for necessário. Geralmente, o manipulador de ações navegará de volta para alguma página anterior. Em alguns designs, o manipulador de ações também pode enfileirar uma mensagem informativa como "Transação cancelada". É possível fazer mais: por exemplo, uma aplicação deve registrar o fato de o usuário acessar parcialmente um formulário e, em seguida, cancelá-lo.
lang. Tipo: String
Código que descreve a linguagem usada na marcação gerada para o componente. Equivalente ao atributo lang da marca HTML <input>. Para escolher um código de idioma, clique no botão de reticências (...) para abrir o editor de propriedade. Alguns exemplos:
ar - árabe tradicional
de - alemão
en - inglês
es - espanhol
fr - francês
ja - japonês
Além dos códigos disponíveis no editor de propriedade, você também pode inserir códigos adicionais usando nomes ISP padrão. Alguns exemplos:
en-US - inglês dos Estados Unidos
ja-JP - japonês
zh-guoyu - mandarim ou chinês padrão
zh-Hans - script em chinês simplificado
zh-HansT - script em chinês tradicional
rendered. Tipo: booleano
Se for selecionada, o componente será renderizado e processado em qualquer envio de página subseqüente. Se não for selecionada, o componente não aparecerá na página, nem mesmo como um componente oculto. Você pode vincular esta propriedade a uma variável que determina quando o componente é renderizado. Por exemplo, um formulário de reserva de viagens pode mostrar uma área de texto para passageiros freqüentes e não mostrá-lo para o público em geral. Para vincular esta propriedade, clique com o botão direito do mouse no componente no Visual Designer e escolha Vinculações de propriedade e, em seguida, selecione Todos os botões de opção para exibir todas as propriedades para que você possa selecionar a propriedade rendered.
tabindex. Type: String
Especifica opcionalmente a posição do componente na ordem das abas do documento, determinando quando o componente terá o foco, se o usuário navegar no documento. O valor deve ser um inteiro entre 0 e 32767. Esta propriedade é equivalente ao atributo tabindex da marca HTML <img>.
valueChangeListener. Tipo: MethodBinding
Consulte a propriedade valueChange da seção Evento acima, que fornece uma forma mais fácil de definir o valor desta propriedade. A propriedade valueChangeListener é a propriedade MethodBinding que fica abaixo da propriedade do evento valueChange. A propriedade valueChangeListener é atualizada quando você define o método da propriedade do evento valueChange.
Se você clicar no botão de reticências ao lado da propriedade valueChange, poderá usar o editor de propriedade para escolher um método existente para se vincular, ou poderá criar um novo método ou desvincular um método existente. Se você for um especialista, em vez de usar a propriedade valueChange, pode digitar uma expressão MethodBinding diretamente nesta propriedade valueChangeListener, por exemplo, se quiser chamar um método que não esteja no bean de página.