Janela Propriedades do componente Área de texto do JSF 1.2
Consulte também
Você vê a janela Propriedades de um componente Área de texto
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 TextArea no bean de página.
Este componente JavaServer Faces 1.2 possui as propriedades a seguir.
Geral
- id.
Tipo: String
O nome do componente Área de texto no bean de página e o arquivo JSP.
Aparência
Dados
- converter.
Tipo: Conversor
Um conversor JavaServer Faces que produz o tipo correto do valor da propriedade text. 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. O componente selecionará o conversor correto da propriedade text, se houver, o que torna desnecessário definir esta propriedade em muitos casos. Se a propriedade text estiver vinculada a um valor cujo tipo não está definido na lista de conversores, você deve fornecer seu próprio conversor e definir esta propriedade.
- Se você usar um conversor de Enum com este componente, deverá editar a declaração Java do conversor para usar uma classe
enum como parâmetro, conforme descrito em Conversor de Enum.
- required.
Tipo: booleano
Se for selecionada, o usuário deverá inserir um valor no campo antes que a página seja enviada. Se você adicionar um componente Mensagem à página e vincular sua propriedade for a este componente, será exibida uma mensagem de erro se o usuário tentar enviar a página sem inserir um valor.
- validatorExpression.
Tipo: MethodExpression
Indica a expressão do validador JavaServer Faces usada quando o valor é enviado. Um validador garante que o valor correto é inserido por um usuário. Se as condições definidas pelo validador não forem atendidas, o validador enviará uma mensagem que você pode exibir em um componente Mensagem.
Escolha um validador na lista suspensa. Se você escolher (null), nenhum validador será chamado. Se você escolher um validador, talvez também queira selecionar a propriedade required para garantir que o usuário insira um valor.
- Você pode definir 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. Se você definir o seu próprio método, qualquer valor que tenha definido nesta propriedade será substituído.
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.
- valueChange. Indica o nome do método ouvinte de alteração de valor do componente que é chamado quando o valor do componente é alterado. Você geralmente define este método 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.
- validate. Indica o nome do método chamado para validar o valor do componente.
Se você deseja codificar um método de validação em vez de escolher um validador JavaServer Faces para a propriedade validatorExpression, 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, talvez também queira selecionar a propriedade required para garantir que o usuário insira um valor.
- A definição desta propriedade também define o valor da propriedade
validatorExpression. Se você definir o seu próprio método de validação, não altere separadamente o valor da propriedade validatorExpression, ou você poderia perder a conexão com o método de validação.
Comportamento
- autoSave.
Tipo: longo
Indica com que freqüência você deve verificar as alterações e salvar automaticamente o componente Área de texto do processamento do lado do servidor usando o ciclo de vida parcial das extensões do JavaServer Faces. O valor desta propriedade é um intervalo medido em milissegundos. Os dados serão enviados somente se o componente Área de texto tiver sido modificado durante este intervalo. O valor padrão, 0, indica que o salvamento automático está desativado. Um número negativo possui o mesmo efeito que zero.
- autoValidate.
Tipo: booleano
Selecionar esta propriedade faz com que uma solicitação do AJAX para o validador no componente seja disparada pelo evento JavaScript OnBlur e, se a validação passar, o conteúdo do componente Área de texto a ser enviado para o processamento do lado do servidor usando o ciclo de vida parcial das extensões JavaServer Faces. Por padrão, esta propriedade é desmarcada (falso) e a validação automática não ocorre. A definição autoValidate também configura a propriedade ajaxify como verdadeira. Além disso, se você definir autoValidate, deverá fornecer um validador para este componente. (O que acontece se você defini-la e não houver um validador?) Consulte a propriedade validatorExpression acima para obter mais informações sobre como fornecer um validador.
- disabled.
Tipo: booleano
Se for selecionada, indicará que o componente nunca deverá receber o foco ou ser incluído em um envio. Use esta propriedade quando o componente não se aplicar à página. 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 for selecionada, tornará impossível para o usuário inserir valores, mas ainda possibilitará o envio do valor do componente. Use esta propriedade quando o componente se aplica mas não deve ser alterado.
- Um campo somente leitura é incluído quando a página é enviada, ao contrário de um campo desativado, que não é incluído quando a página é enviada. Se você usar a propriedade
disabled, o JavaServer Faces não detectará que algum valor tenha sido enviado.
- toolTip.
Tipo: String
Renderizada como o atributo HTML title do componente, que pode ser lido por um leitor de tela e pode ser exibido como uma dica de ferramentas.
- Se o componente for desativado, a dica de ferramenta não será exibida na maioria dos navegadores.
- trim.
Tipo: booleano
Se for selecionada, os espaços iniciais ou finais serão eliminados antes da conversão para o tipo de dados de destino. Esta propriedade é selecionada por padrão.
- visible.
Tipo: booleano
Indica se o componente pode ser visto ou não pelo usuário na página HTML renderizada. Esta propriedade é selecionada por padrão. Se você desmarcar esta propriedade, o código HTML do componente será renderizado na página, mas o componente não ficará visível no navegador porque ele estará oculto por uma configuração de estilo. Como o código HTML é renderizado, o componente ainda pode ser processado em envios de formulário, e os usuários que vêem o código-fonte no navegador podem ver o código HTML. Além disso, sua aplicação Web pode usar JavaScript do lado cliente para mostrar ou ocultar o componente.
- Se você precisar ocultar completamente o componente, por exemplo, porque ele contém informações confidenciais que determinados usuários não podem ver, desmarque a propriedade
rendered.
Acessibilidade
- tabIndex.
Tipo: String
Especifica opcionalmente a posição do componente na ordem das guias 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. Equivalente ao atributo tabindex da marca HTML <input>.
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
- 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. Uma forma mais simples de obter esta funcionalidade é associar o componente a um formulário virtual e, em seguida, clicar com o botão direito do mouse no componente e escolher Enviar automaticamente ao alterar.
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 que o usuário cancelou a operação atual.
- 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 propriedade JavaBeans que determina quando o componente é renderizado. Para vincular esta propriedade, clique no botão de reticências (...) à direita da propriedade e escolha Usar vinculação na caixa de diálogo.
- Consulte também
- Componente Área de texto
- Trabalhando com componentes
- Tarefas de componente: referência rápida
Notificações legais