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
Este componente JavaServer Faces 1.2 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. Tipo: Conversorenum como parâmetro, conforme descrito em Conversor de Enum. Tipo: Objeto com.sun.webui.jsf.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ê pode ver na . Este objeto serve simplesmente para preencher o grupo com os 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: MethodExpressionEscolha um validador na lista suspensa. Se você escolher (null), nenhum validador será chamado. Se você escolher um validador, talvez também queira selecionar a propriedade required para garantir que o usuário insira um valor.
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.
Se você deseja codificar um método de validação em vez de escolher um validador JavaServer Faces para a propriedade validatorExpression, clique com o botão direito do mouse no componente e escolha Editar manipulador de eventos > Validar. 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, talvez também queira selecionar a propriedade required para garantir que o usuário insira um valor.
validatorExpression. Se você definir o seu próprio método de validação, não altere separadamente o valor da propriedade validatorExpression, 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.