Você vê a janela Propriedades de um componente Grupo de caixas de seleção
quando seleciona o componente em uma página que está editando no Visual Designer. 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 CheckboxGroup.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 está definida para a primeira caixa de seleção do 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 uma caixa de seleção. A propriedade value de uma instância de Option representa o valor de uma caixa de verificação selecionada. 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.MultipleSelectOptionsList com um nome semelhante a checkboxGroup1DefaultOptions, cujo nó você pode ver na . Este objeto serve simplesmente para preencher o grupo com as caixas de verificaçã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 item.
Tipo: ObjetoO componente Grupo de caixas de seleção pode ter mais de um valor, o que tem implicações sobre qual tipo de valor pode ser usado.
Object ou uma matriz de primitivos. Os elementos individuais desta matriz representam os valores selecionados no momento no conjunto de todas as opções possíveis. checkboxGroup.getValue() será uma matriz Object.Uma forma comum de processar os valores escolhidos pelo usuário é vincular este componente a uma matriz Object e verificar os valores da matriz quando o usuário enviar a página. A propriedade selected deve ser uma expressão de vinculação de valor que é interpretada para ler e gravar um Object. Um valor Object lido a partir da expressão de vinculação de valor identifica a caixa de seleção selecionada. 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 uma caixa de seleção for selecionada, 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 dos 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 escolher um validador, também deverá 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.
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.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 a conexão com o método de validação será perdida. 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 caixas de seleçã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.