Você vê a janela Propriedades de um componente Grupo de botões de opção
quando seleciona o componente em uma página que está editando no Visual Designer ou na janela Navegador.
Este componente possui as propriedades a seguir.
Tipo: Stringid do componente. No bean de página, o valor desta propriedade é o nome do objeto RadioButtonGroup.Tipo: int<table>. O número de linhas é definido pelo tamanho da matriz items. O número de colunas é definido pelo atributo de colunas. O layout padrão é uma única coluna vertical. Tipo: String for do rótulo é definida para o primeiro botão de opção no grupo.
label não é tão flexível quanto o componente Rótulo. Você pode usar o componente Rótulo se quiser ter mais controle sobre a aparência do rótulo, tal como o seu posicionamento em relação ao componente. Tipo: int label estiver definida. Tipo: String 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
Tipo: Stringstyle para obter uma explicação do porquê uma classe adicionada a esta propriedade talvez pareça não ter efeito no componente. As classes de estilo CSS defaulttheme deste componente são:
css_master.css
.CbDis, .RbDis {background-color:#E1E4E5;color:#848687}
.Cb {}
.Rb {}
.RbSpn input {vertical-align: 1px}
.CbSpn input {vertical-align: -1px}
.CbGrp td, .RbGrp td {text-align: left}
.CbGrp label, .RbGrp label {vertical-align: 6px}
css_ie55up.css
/* ADDITIONAL CSS FOR IE5.5+ SUPPORT */
.RbSpn input, .CbSpn input {vertical-align: 3px;}
Tipo: Conversorvalue selecionada. Tipo: Objeto com.sun.rave.web.ui.model.Option. Cada instância de Option representa um botão de opção. A propriedade value de uma instância de Option representa o valor de um botão de opção selecionado. Se a propriedade items estiver vazia ou a matriz, mapa ou coleção estiver vazia, nada será renderizado.
Para obter informações sobre com.sun.webui.jsf.model.Option, inclua esta classe no modo de visualização Java de uma página, coloque o cursor no nome da classe e pressione Alt-F1 para ver sua descrição de Javadoc.
Por padrão, esta propriedade é associada a um objeto com.sun.webui.jsf.model.SingleSelectOptionsList com um nome semelhante a radioButtonGroup1DefaultOptions, cujo nó você vê na Este objeto serve simplesmente para preencher o grupo com botões de opção padrão. Ele está no bean de página.
Tipo: booleanofor a este componente, será exibida uma mensagem de erro se o usuário tentar enviar a página sem selecionar um botão de opção.
Tipo: Objeto Pelo menos um botão de opção deve ser selecionado pela aplicação. A propriedade selected deve ser definida como uma expressão de vinculação de valor que é interpretada para ler e gravar um Object. Quando um valor Object é lido a partir da expressão de vinculação de valor, ele identifica o botão de opção selecionado. O valor Object deve ser igual ao atributo value de pelo menos uma instância de Option especificada na matriz obtida a partir da expressão de vinculação de valor atribuída à propriedade items.
O método de gravação da expressão de vinculação de valor da propriedade selected é chamado durante a UPDATE_MODEL_PHASE do ciclo de vida do JavaServer Faces. Se um botão de opção for selecionado, um valor Object será passado como um argumento para o método write(). O valor Object é o valor do botão de seleção escolhido.
Consulte o link para o tutorial Usando componentes Caixa de listagem no fim da página para obter mais informações.
Tipo: MethodBinding(null), nenhum validador será chamado. Se você escolher um validador, selecione também a propriedade required para garantir que o validador seja usado.
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.
validator, clique com o botão direito do mouse no componente e escolha Editar manipulador de eventos > validate. 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, selecione também a propriedade required para garantir que esse validador seja usado.
validator. Se você definir o seu próprio método de validação, não altere separadamente o valor da propriedade validator, ou você poderia perder a conexão com o método de validação.null. Você geralmente define este método no bean de página, clicando com o botão direito do mouse no componente no Visual Designer 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 do componente. Tipo: booleanoreadOnly sobre os efeitos do uso da propriedade disabled em comparação ao efeito do uso da propriedade readOnly. Tipo: booleanodisabled, o JavaServer Faces não detectará que algum valor tenha sido enviado. Tipo: String title do componente. O valor do texto desta propriedade será exibido se o usuário passar o cursor do mouse sobre o rótulo do grupo de botões de opção.
Tipo: booleanorendered. Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: booleanoO 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.
Tipo: booleanovisible em vez desta propriedade.
Você pode vincular esta propriedade a uma propriedade JavaBeans que determina quando o componente é renderizado. Por exemplo, um formulário de reserva de viagens pode mostrar um componente para passageiros freqüentes e não mostrá-lo para o público em geral. Para vincular esta propriedade, clique no botão de reticências (...) à direita da propriedade e escolha Usar vinculação na caixa de diálogo.
Tipo: MethodBindingvalueChange da seção Evento acima, que fornece uma forma mais fácil de definir o valor desta propriedade. A propriedade valueChangeListener é a propriedade MethodBinding que fica abaixo da propriedade do evento valueChange. A propriedade valueChangeListener é atualizada quando você define o método da propriedade do evento valueChange.
Se você clicar no botão de reticências ao lado da propriedade valueChange, poderá usar o editor de propriedade para escolher um método existente para se vincular, ou poderá criar um novo método ou desvincular um método existente. Se você for um especialista, em vez de usar a propriedade valueChange, pode digitar uma expressão MethodBinding diretamente nesta propriedade valueChangeListener, por exemplo, se quiser chamar um método que não esteja no bean de página.