Você vê a janela Propriedades de um componente Grupo de linhas da tabela quando o seleciona em um componente Tabela na . Um componente Grupo de linhas da tabela é parte de um componente Tabela, portanto, talvez você tenha que expandir o nó de uma tabela na janela Navegador para ver os componentes Grupo de linhas da tabela sob ele.
Você pode usar a caixa de diálogo Layout da tabela para definir muitas dessas propriedades. Esta caixa de diálogo não só é mais fácil de usar do que as janelas Propriedades individuais dos componentes Tabela, Coluna da tabela e Grupo de linhas da tabela, mas você também pode trabalhar nessa caixa de diálogo de forma mais natural com as tabelas e todas as suas colunas. Para abri-la, clique com o botão direito do mouse na tabela no Visual Designer e escolha Layout da tabela.
Este componente JavaServer Faces 1.2 possui as propriedades a seguir.
Geral
id. Tipo: String
O nome do componente Grupo de linhas da tabela no bean de página e o arquivo JSP.
Aparência
aboveColumnFooter.Tipo: booleano
Se for selecionada, o rodapé do grupo de linhas será exibido acima dos rodapés da coluna. O padrão é exibir o rodapé do grupo de linhas abaixo dos rodapés da coluna.
aboveColumnHeader.Tipo: booleano
Se for selecionada, o cabeçalho do grupo de linhas será exibido acima dos cabeçalhos da coluna. O padrão é exibir o cabeçalho do grupo de linhas abaixo dos cabeçalhos da coluna.
align.Tipo: String
Especifica o alinhamento horizontal da célula. Os valores possíveis são esquerda, centralizado, direita e justificado.
collapsed.Tipo: booleano
Se for selecionada, o grupo de linhas mostrará somente o cabeçalho e não as linhas, rodapé ou texto da coluna. Esta propriedade não é selecionada por padrão e o grupo de linhas da tabela é expandido com todas as linhas do grupo visíveis.
footerText.Tipo: String
O texto exibido para o rodapé do grupo de linhas, que fornece um rodapé geral do grupo de dados representado por este grupo de linhas.
groupToggleButton.Tipo: booleano
Se for selecionada, exibe um botão que o usuário pode clicar para expandir ou recolher o grupo de linhas.
headerText.Tipo: String
O texto exibido para o cabeçalho do grupo de linhas, que fornece um cabeçalho geral do grupo de dados representado por este grupo de linhas.
selectMultipleToggleButton. Tipo: booleano
Se for selecionada, adiciona um botão que permite que um usuário selecione todas as linhas exibidas na tabela de uma vez. Este botão é usado para alternar uma coluna de caixas de seleção, usando o ID fornecido para a propriedade selectId do componente Coluna da tabela.
selected. Tipo: booleano
Se esta propriedade for selecionada, a aparência da linha atual será alterada para indicar que ela está selecionada. Normalmente, esta propriedade é vinculada a uma propriedade JavaBeans que retorna um valor baseado no atributo de escopo da solicitação definido na propriedade sourceVar.
styleClasses. Tipo: String
Uma lista separada por espaços de classes de estilo CSS2 a serem aplicadas quando o componente é renderizado. As classes de estilo devem ser definidas na folha de estilo do projeto no arquivo CSS do tema. Se você clicar no botão de reticências (...), verá uma lista de todos os estilos que podem ser adicionados a esta propriedade. Para obter informações sobre a adição de classes CSS e regras na folha de estilos em cascata do projeto, consulte Editor CSS.
Esta propriedade substitui quaisquer configurações do tema ou do arquivo CSS desse componente. Se uma classe especificada nesta propriedade não surtir efeito, é porque uma área do componente está obscurecida por um componente filho que possui configurações de estilo diferentes.
Se você adicionar uma classe de estilo CSS a partir do tema atual ao arquivo CSS do projeto e redefinir a classe do estilo, a alteração afetará todos os componentes que usam essa classe de estilo. Entretanto, é possível adicionar suas próprias classes de estilo ao arquivo CSS do projeto que redefine as classes de estilo padrão e, em seguida, quando você adicionar as classes a esta propriedade, as alterações afetarão somente a instância deste componente.
valign. Tipo: String
Especifica a posição vertical na célula do conteúdo da célula. Os valores possíveis são:
top - Posiciona o conteúdo na parte superior da célula.
middle - O valor padrão, que centraliza o conteúdo verticalmente.
bottom - Posiciona o conteúdo na parte inferior da célula.
Layout
multipleColumnFooters. Tipo: booleano
Se for selecionada, serão mostrados vários rodapés de coluna. Se os componentes Coluna da tabela forem aninhados, os rodapés serão renderizados inversamente ao cabeçalhos da coluna. O valor padrão, não selecionado, mostra apenas um nível.
multipleTableColumnFooters. Tipo: booleano
Se for selecionada, serão mostrados vários rodapés de coluna da tabela. Se os componentes Coluna da tabela forem aninhados, os rodapés serão renderizados inversamente ao cabeçalhos da coluna. O valor padrão, não selecionado, mostra apenas um nível.
Dados
rows.Tipo: int
O número de linhas a serem exibidas para uma tabela paginada. O padrão é 25 linhas por página. Consulte a descrição da propriedade paginateButton na janela Propriedades da tabela para obter mais informações sobre tabelas paginadas.
sourceData.Tipo: Objeto
Os dados de origem deste componente, que podem ser do tipo TableDataProvider, ObjectArrayDataProvider, ObjectListDataProvider ou CachedRowSetDataProvider. Como esta propriedade é referenciada durante as fases de decodificação, validação, atualização e renderização enquanto avança nas linhas, o objeto vinculado a esta propriedade deve ser armazenado em cache, para que o objeto não seja criado com mais freqüência do que o necessário.
Se você soltar uma tabela de banco de dados no Grupo de linhas da tabela, esta propriedade será definida para você. Você também pode clicar no botão de reticências (...) à direita da propriedade e escolher um provedor de dados em uma lista. Por exemplo, existe um TableDataProvider para cada tabela de banco de dados adicionada à página.
sourceVar.Tipo: TableDataProvider
Nome do atributo de escopo da solicitação sob o qual os dados do modelo da linha atual são expostos enquanto avançam nos dados. Durante o processamento iterativo sobre as linhas de dados no provedor de dados, o TableDataProvider da linha atual é exposto como um atributo da solicitação sob a chave especificada por esta propriedade. Este valor deve ser exclusivo para cada tabela na página.
Comportamento
first.Tipo: int
O número de linha relativo ao zero da primeira linha a ser exibida em uma tabela paginada. Consulte a descrição da propriedade paginateButton na janela Propriedades da tabela para obter mais informações sobre tabelas paginadas.
toolTip. Tipo: String
O valor do atributo de título da coluna. O texto especificado será exibido como uma dica de ferramenta quando o cursor do mouse passar sobre uma célula na coluna.
Se o componente for desativado, a dica de ferramenta não será exibida na maioria dos navegadores.
visible. Tipo: booleano
Indica se o componente pode ser visto ou não pelo usuário na página HTML renderizada. Esta propriedade é selecionada por padrão, o que torna o Grupo de linhas visível por padrão. Se você desmarcar esta propriedade, as linhas do Grupo de linhas da tabela serão renderizadas como HTML, embora ocultas, apesar de qualquer cabeçalho, rodapé ou texto da coluna permanecer visível. Como é renderizado, embora oculto, o Grupo de linhas da tabela pode se tornar visível novamente através de uma ação do lado do cliente.
JavaScript
onClick. Tipo: String
JavaScript a ser executado quando o usuário clica no componente.
onDblClick. Tipo: String
JavaScript a ser executado quando o usuário clica duas vezes no componente.
onKeyDown. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é pressionada.
onKeyPress. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é pressionada e liberada.
onKeyUp. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é liberada.
onMouseDown. Tipo: String
JavaScript a ser executado quando o cursor do mouse está sobre o componente e o usuário pressiona o botão do mouse.
onMouseMove. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse no componente.
onMouseOut. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse para longe do componente, depois de estar sobre o componente.
onMouseOver. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse para o componente.
onMouseUp. Tipo: String
JavaScript a ser executado quando o cursor do mouse está sobre o componente e o usuário libera o botão do mouse.
Avançado
emptyDataMessage. Tipo: String
A mensagem exibida em uma única linha da tabela quando a tabela não contém dados. Esta linha, que consiste em uma célula que abrange todas as colunas, fica vazia exceto pelo texto fornecido por esta propriedade.
extraFooterHtml. Tipo: String
Código HTML extra a ser anexado ao elemento HTML <tr> que é renderizado para o rodapé do grupo de linhas. Use somente código que seja válido em um elemento HTML <td>. O código especificado é inserido no elemento HTML e não tem sua validade verificada. Por exemplo, você pode definir este atributo como nowrap='nowrap'.
extraHeaderHtml. Tipo: String
Código HTML extra a ser anexado ao elemento HTML <tr> que é renderizado para o cabeçalho do grupo de linhas. Use somente código que seja válido em um elemento HTML <td>. O código especificado é inserido no elemento HTML e não tem sua validade verificada. Por exemplo, você pode definir este atributo como nowrap='nowrap'.
rendered. Tipo: booleano
Se for selecionada, o componente será renderizado e processado em qualquer envio de página subseqüente. Se não for selecionado, o Grupo de linhas da tabela não mostrará nada na página, incluindo as linhas e qualquer cabeçalho, rodapé ou texto da coluna associado, e nenhuma informação estará em HTML. nem mesmo como componentes ocultos. Se esta propriedade não estiver selecionada (falso), ela substituirá as propriedades rendered de quaisquer componentes filhos.
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 Grupo de linhas da tabela para passageiros freqüentes e não mostrá-lo para o público 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.