Componente Botão de opção do JSF 1.1

Consulte também

Você pode arrastar o componente Botão de opção ícone do componente Botão de opção da categoria Básico da Paleta para o Visual Designer para criar um único botão de opção com um rótulo opcional.

Os componentes Botão de opção são geralmente usados em um grupo. Se você quiser que um conjunto de botões de opção seja pré-formatado com rótulos, use um componente Grupo de botões de opção.

Você também pode soltar o botão de opção em um componente Recipiente, como uma célula da tabela ou caixa de grupo.

Um botão de opção pode representar qualquer objeto, seja o objeto de uma classe predefinida como Boolean, Byte, Character, Double, Float, Integer, Long, Short, String ou de uma classe definida pelo usuário. Um botão de opção também pode representar um valor primitivo.

Um valor Boolean é útil para indicar se um item, tal como uma linha da tabela, está selecionado. Um valor String é útil para passar valores para seleções de botão de opção feitas na interface. Um valor Object ou instância de classe definida pela aplicação pode ser usado para manter mais informações relacionadas a uma seleção do botão de opção.

Um único botão de opção pode ser usado para representar vários tipos de dados:

Um grupo de botões de opção pode ser usado para representar:

O componente Botão de opção pode ser útil em situações em que o layout do componente Grupo de botões de opção não é desejável, tal como em uma linha da tabela.

Detectando um botão de opção selecionado

O componente Botão de opção usa as propriedades selected e selectedValue para passar informações sobre o status da seleção do botão de opção. A propriedade selected é usada para indicar que o botão de opção está selecionado, e uma indicação de que o botão está selecionado é exibida na página. A propriedade selectedValue é usada para passar um valor de dados para o botão de opção. Um botão de opção é considerado selecionado quando o valor da propriedade selected é igual ao valor da propriedade selectedValue. Você pode exibir um botão de opção como selecionado na visualização inicial da página, atribuindo o mesmo valor às propriedades selectedValue e selected.

Se a propriedade selectedValue não for especificada ou se o seu valor for null, o botão de opção se comportará como um controle booleano, como descrito na próxima seção.

Uma expressão de vinculação de valor interpretada como um valor primitivo pode ser atribuída às propriedades selected e selectedValue.

Usando um componente Botão de opção como um controle booleano

Se a propriedade selectedValue não for especificada ou se o seu valor for null, o botão de opção se comportará como um controle booleano.

Para usar o botão de opção como um controle booleano, não especifique um valor para a propriedade selectedValue. A botão de opção será selecionado se a propriedade selected não for nula e tiver o valor de uma instância Boolean verdadeira ou um valor booleano primitivo. Se o botão de opção não estiver selecionado, o valor da propriedade selecionada será uma instância Boolean falsa ou booleano primitivo.

Usando um botão de opção para representar um valor definido pela aplicação

Um objeto definido pela aplicação pode ser atribuído à propriedade selectedValue para representar o valor de um botão de opção selecionado. Se o botão de opção for marcado, será atribuído o valor da propriedade selectedValue ao valor da propriedade selected.

Se o valor da propriedade selectedValue for um objeto definido pela aplicação, um conversor deverá ser registrado para converter para e de um valor String. O conversor é usado para codificar o valor do botão de opção como o valor do elemento HTML <input> e para decodificar o valor enviado em uma solicitação. Além disso, o objeto deve aceitar um método equals() que retorne true quando o valor da propriedade selectedValue for comparado com o valor da propriedade selected a fim de detectar um botão de opção selecionado.

Usando um botão de opção como um controle em um grupo

A propriedade name determina se um botão de opção é parte de um grupo. Todos os botões de opção em grupo tem o mesmo valor da propriedade name. O grupo se comporta como uma única lista de seleção na qual somente um botão de opção pode ser selecionado. O valor da propriedade name deve ser exclusivo no escopo da página que contém os botões de opção.

Consulte também
Janela Propriedades do componente Botão de opção
Vinculando propriedades do componente
Trabalhando com componentes
Tarefas de componente: referência rápida
Sobre a Paleta do Visual Web

Notificações legais