Componente Rótulo do JSF 1.2
Consulte também
O componente Rótulo
é usado como um rótulo para outro componente.
-
Este componente possui suporte para funções JavaScript do lado do cliente que permitem realizar ações no cliente sem voltar ao servidor. Para obter mais informações sobre este recurso avançado, escolha Ajuda > Referência Javadoc > Biblioteca de marcas do Projeto Woodstock 4.2 e vá até webuijsf:label.
O componente Rótulo oferece suporte a navegadores de voz e permite aos navegadores visuais oferecerem recursos como a capacidade de clicar em um rótulo de texto para selecionar um campo de entrada ao qual o rótulo está associado. Se você quiser apenas um texto simples que não esteja diretamente associado ao componente, como em um título, um cabeçalho ou um conjunto de instruções, use o componente Texto estático.
- Muitos componentes, como campos de texto, caixas de seleção, botões de opção e listas suspensas, já possuem rótulos definidos com a propriedade
label do componente. As propriedades label destes componentes adicionam rótulos padrão que oferecem funcionalidades básicas e funcionam bem em páginas simples. Se quiser mais controle sobre seus rótulos, incluindo a capacidade de posicioná-los em um componente Painel de grade para alinhar os rótulos e os componentes separadamente, use o componente Rótulo.
O componente Rótulo é renderizado tanto como um elemento HTML <label> quanto um elemento <span>. Um elemento <span> é renderizado se o rótulo não estiver associado a um componente.
Depois de soltar um rótulo na página, é possível realizar algumas ações típicas como:
- Digitar o texto no rótulo. Ao pressionar Enter ou clicar fora do rótulo, a propriedade
text do rótulo é atualizada com o texto inserido.
- Definir a propriedade
for para associar o rótulo a um componente. Se a propriedade for não puder ser definida, nenhum componente da página aceitará um 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.
- Arrastar o rótulo para a posição em que quer que seja exibido, provavelmente próximo ao componente associado. Quando os dois componentes estiverem posicionados, você poderá selecionar ambos os componentes e alinhá-los conforme descrito em Alinhamento de componentes.
- Clicar com o botão direito do mouse no componente na janela Navegador e escolher um dos seguintes itens no menu pop-up:
- Vincular aos dados. Abre a caixa de diálogo que permite vincular a propriedade
text do componente a um objeto ou a um provedor de dados que define dinamicamente o texto exibido do rótulo. Para obter mais informações, consulte Caixa de diálogo Vincular aos dados.
- Vinculações de propriedade. Abre a caixa de diálogo que permite vincular as propriedades dos componentes, além da propriedade
text, 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ção Essa opção remove o atributo de vinculação do componente.
- Consulte também
- Janela Propriedades do componente Rótulo
- Vinculando propriedades do componente
- Trabalhando com componentes
- Tarefas de componente: referência rápida
- Sobre a Paleta do Visual Web
Notificações legais