Você pode arrastar o componente Lista de caixas de verificação padrão do JavaServer Faces da categoria Padrão da Paleta para o Visual Designer a fim de criar uma tabela que inicialmente contém três caixas de verificação em uma única linha.
Este componente é uma implementação de referência JavaServer Faces que não usa temas. O componente Grupo de caixas de verificação na categoria Básico da Paleta não suporta temas e fornece outros recursos que melhoram o uso.
Uma Lista de caixas de verificação é um componente composto que possui os seguintes elementos:
O componente de fechamento, checkboxList, gerencia o estilo e o comportamento da lista em si. Além disso, quando o usuário envia a página, a propriedade value deste componente é uma matriz Object que contém as opções do usuário. Você pode vincular a propriedade value deste componente a uma matriz Object e usar esse objeto para testar quais foram as opções do usuário.
O componente interno, checkboxListSelectItems, deve ser usado para vincular um provedor de dados que especifica os itens reais na lista.
Um terceiro, elemento relacionado, checkboxListDefaultItems, contém uma matriz de caixas de verificação iniciais da lista. Esta matriz é usada para preencher a lista somente se a lista não estiver vinculada a um provedor de dados. Cada caixa de verificação neste terceiro componente possui um rótulo com o texto padrão (item1, item2, item3).
Depois de arrastar o componente para o Visual Designer, você pode:
Selecionar o componente Lista de caixas de verificação e arrastá-lo para outro local da página.
Clique com o botão direito do mouse no componente checkboxList na e escolha Vinculações de propriedade para vincular sua propriedade value a uma matriz Object que você adicionou ao bean de sessão como uma propriedade. Você pode usar esta propriedade do bean sessão para avaliar o que o usuário escolhe depois que a página é enviada.
Para obter mais informações, consulte a descrição da propriedade value abaixo.
Clique com o botão direito do mouse no componente checkboxListSelectItems na janela Navegador e vincule-o a um provedor de dados que será usado para preencher a lista.
Selecione o componente Lista de caixas de seleção da página no Visual Designer e edite suas propriedades na janela Propriedades da Lista de caixas de seleção. Estas propriedades afetam o estilo e o comportamento global da lista. Algumas propriedades típicas que você pode definir são:
id. O nome do componente Lista de caixas de verificação. No arquivo JSP, este nome é o valor do atributo id do componente. No bean de página, o valor desta propriedade é o nome do objeto HiddenField.
layout. A orientação da lista. A orientação padrão é lineDirection: a lista é disposta horizontalmente, da esquerda para direita. Se você escolher pageDirection, a lista é disposta verticalmente, de cima para baixo.
value. Os dados enviados quando a página é enviada.
O componente Lista de caixas de verificação pode ter mais de um valor, o que tem implicações sobre qual tipo de valor pode ser usado.
Se você usar uma expressão de vinculação de valor, a mesma deverá apontar para uma matriz de objetos ou primitivos. Os elementos individuais desta matriz representam os valores selecionados no momento no conjunto de todas as opções possíveis.
Se não usar uma expressão de vinculação de valor, o objeto retornado quando você chama checkboxList.getValue() será uma matriz Object.
Não existe uma forma de vincular este componente aos dados do banco de dados, pois o valor será normalmente representado por várias linhas em alguma tabela de detalhe.
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.
Clique com o botão direito do mouse no componente Lista de caixas de verificação no Visual Designer e escolha uma dentre várias ações:
Editar manipulador de eventos. Escreva o código de um dos seguintes manipuladores de eventos.
validate. Abre o Editor de Java com o cursor posicionado no método validate da lista de caixas de verificação para que você possa inserir o código para validar o valor da lista de caixas de verificação.
processValueChange. Abre o Editor Java com o cursor posicionado no método processValueChange da lista de caixas de verificação para que você possa inserir o código quando o valor dessa lista de caixas de alteração for alterado (por exemplo, o usuário marca duas caixas e envia o formulário).
Vincular aos dados. Vincule a propriedade value do componente a um objeto ou a um provedor de dados, conforme descrito em Caixa de diálogo Vincular aos dados.
Vinculações de propriedade. Abre a caixa de diálogo que permite vincular as propriedades do componente a outros objetos ou propriedades que podem atualizar automaticamente as propriedades deste 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.