Você vê a janela Propriedades de um componente Rótulo de componente do JavaServer Faces quando seleciona a parte externa do componente em uma página que está editando no Visual Designer ou seleciona a parte Rótulo do componente desse componente composto na janela Navegador.
O componente Rótulo de componente consiste em um componente Texto de saída incorporado em um componente Rótulo de componente. Quando seleciona este componente no Visual Designer, você também o vê na janela Navegador, onde pode selecionar a parte do componente na qual deseja trabalhar.
Este componente JavaServer Faces padrão possui as propriedades a seguir.
Geral
id. Tipo: text
O nome do componente Rótulo de componente no bean de página e o arquivo JSP.
Aparência
for. Tipo: String
O componente para o qual o Rótulo de componente fornece um rótulo.
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 Rótulo de 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.
JavaScript
onblur. Tipo: String
JavaScript a ser executado quando o componente perde 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.
Avançado
accesskey. Tipo: String
Uma tecla ou atalho de teclado, que ativa o Rótulo de componente. Você pode indicar qualquer caractere válido que possa ser digitado 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.
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 Rótulo de componente será renderizado e processado em qualquer envio de página subseqüente. Se não for selecionada, o Rótulo de 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 Rótulo de componente é renderizado. Por exemplo, um formulário de reserva de viagens pode mostrar um Rótulo de componente 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 Rótulo de componente na ordem das abas do documento, determinando quando o Rótulo de 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>.