Você vê a janela Propriedades de um componente Rótulo do JavaServer Faces quando seleciona o componente em uma página que está editando no Visual Designer ou seleciona o nó Rótulo do componente na janela Navegador.
Este componente JavaServer Faces 1.2 possui as propriedades a seguir.
Geral
id. Tipo: String
O nome do componente Rótulo no bean de página e o arquivo JSP.
Aparência
for. Tipo: String
O componente para o qual o Rótulo fornece um rótulo. Clique na lista suspensa para ver quais componentes podem ser associados ao rótulo. Ao ser definida, esta propriedade não colocada o rótulo ao lado do componente — isso deve ser feito arrastando e posicionando os componentes — mas oferece as seguintes vantagens.
Ao associar um componente Rótulo a um componente de entrada, como o componente Campo de texto, o componente Rótulo acata as configurações e altera o componente associado. Especificamente, se a propriedade required do componente for true, o componente Rótulo exibe um asterisco. Se o servidor recusar o registro da página devido à entrada ser inválida, a página exibirá em vermelho o texto do componente Rótulo.
labelLevel. Tipo: int
Um número que afeta a aparência do rótulo. 1 (Forte) é grande e em negrito. 2 (Médio), o padrão, é menor e em negrito. 3 (Fraco), é menor e normal (não está em negrito). Esta propriedade tem efeito somente se a propriedade do rótulo for definida.
requiredIndicator. Tipo: booleano
Indica que o componente ao qual o rótulo está associado deve ser preenchido pelo usuário. Use esta propriedade se o componente associado não tiver uma propriedade required ou se a propriedade required do componente associado não estiver definida. Quando esta propriedade ou a propriedade required no componente a ser rotulado for selecionada, o ícone required é exibido ao lado do rótulo.
style. Tipo: String
Regras de folha de estilo em cascata (CSS nível 2) a serem aplicadas ao componente. 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.
Esta propriedade substitui quaisquer configurações do tema ou do arquivo CSS desse componente. Se um estilo especificado nesta propriedade não surtir efeito, é porque uma área do componente está obscurecida por um componente filho que possui configurações de estilo diferentes.
Para obter uma lista de estilos CSS2, consulte a página da Web em
styleClass. Tipo: String Uma lista separada por espaços de classes de estilo CSS2 a serem aplicadas quando o componente é renderizado. As classes de estilo devem ser definidas na folha de estilo do projeto no arquivo CSS do tema. 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.
Consulte a observação acima abaixo da descrição da propriedade style para obter uma explicação do porquê uma classe adicionada a esta propriedade talvez pareça não ter efeito no componente.
Se você adicionar uma classe de estilo CSS a partir do tema atual ao arquivo CSS do projeto e redefinir a classe do estilo, a alteração afetará todos os componentes que usam essa classe de estilo. Entretanto, é possível adicionar suas próprias classes de estilo ao arquivo CSS do projeto que redefine as classes de estilo padrão e, em seguida, quando você adicionar as classes a esta propriedade, as alterações afetarão somente a instância deste componente.
text. Tipo: String
O texto que é exibido no rótulo. Esta propriedade é atualizada quando você digita o texto diretamente no componente do rótulo na página.
Dados
converter. Tipo: Conversor
Um conversor JavaServer Faces que converte o valor da propriedade text String para que ela possa ser exibida. 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 que não esteja definido na lista de conversores, você precisa 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.
Comportamento
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.
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.
JavaScript
onClick. Tipo: String
JavaScript a ser executado quando o usuário clica no componente.
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
hideIndicators. Tipo: String
Se for selecionada, evitará a visualização dos ícones required e invalid com o rótulo. Quando a propriedade required no componente a ser rotulado for selecionada, o ícone required é exibido ao lado do rótulo. Se o usuário enviar a página com um valor inválido para o componente, o ícone invalid será exibido. Esta propriedade será útil se o componente possuir mais de um rótulo e se apenas um rótulo deve mostrar os ícones.
rendered. Tipo: booleano
Se for selecionada, o rótulo será renderizado e processado em qualquer envio de página subseqüente. Se não for selecionada, o rótulo não aparecerá na página, nem mesmo como um componente oculto.