O componente Coluna da tabela faz parte do componente Tabela e está sempre associado a um componente Grupo de linhas da tabela. Ao adicionar um componente Tabela a uma página JSF Visual Web, um componente Grupo de linhas da tabela com três componentes Coluna da tabela é automaticamente adicionado ao componente Tabela. Você pode arrastar um componente Coluna da tabela
para a página JSF Visual Web no Visual Designer e soltá-lo em uma Coluna da tabela existente de um Grupo de linhas da tabela, ou pode soltá-lo em um Grupo de linhas da tabela na janela Navegador.
Os componente Coluna da tabela são o equivalente das marcas <td> em HTML e são sempre associados a componentes Grupo de linhas da tabela. O componente Coluna da tabela é denominado tableColumn no código JSP e a classe Java associada no bean de página é TableColumn.
Para trabalhar com um componente Coluna da tabela, você pode selecioná-lo no Visual Designer ou na janela Navegador e editar suas propriedades. Com a Coluna da tabela selecionada no Visual Designer, você pode clicar com o botão direito do mouse e escolher várias opções no menu pop-up, algumas das quais estão descritas abaixo:
Você pode adicionar outros componentes que não estejam no menu, mas primeiro deve adicionar um componente Painel de grupo e, então, pode colocar o componente no Painel de grupo. É mais fácil soltar componentes no Painel de grupo na janela Navegador. Talvez você tenha que soltar o componente e movê-lo na janela Navegador para garantir que ele está realmente no Painel de grupo.
O componente Coluna da tabela é usado para definir atributos de elementos XHTML <td>, que são usados para exibir células de dados da tabela. No entanto, o processamento dos cabeçalhos e rodapés da coluna são manipulados pelo componente Grupo de linhas da tabela. A tabela seguinte mostra o layout de um componente Tabela, com as áreas definidas com as propriedades de Coluna da tabela em azul e o restante do componente Tabela em cinza.
| Barra de título | ||||||||||||
| Barra de ação (superior) | ||||||||||||
|
||||||||||||
| Barra de ação (inferior) | ||||||||||||
| Rodapé | ||||||||||||
A área do Cabeçalho da coluna exibe um cabeçalho para cada coluna da tabela. Se você especificar o texto de um cabeçalho de coluna com a propriedade headerText, a implementação padrão do cabeçalho é renderizada. Você pode adicionar um código HTML extra ao elemento <td> renderizado do cabeçalho com a propriedade extraHeaderHtml.
As propriedades Column seguintes podem ser usadas para alterar a aparência e o comportamento de classificação do cabeçalho da coluna:
sort - Especifica uma chave de classificação e torna a coluna classificável.
sortIcon - Especifica um identificador de tema para selecionar uma imagem diferente a ser usada como ícone de classificação que é exibido no cabeçalho de uma coluna classificável.
sortImageURL - Especifica um caminho para uma imagem a ser usada como ícone de classificação que é exibido no cabeçalho de uma coluna classificável.
descending - Quando definido como true faz com que a coluna seja classificada em ordem decrescente.
severity - Especifica o grau de seriedade de um alarme em cada célula e faz com que a coluna classifique o valor de seriedade se usado com o atributo sort. footerText, a implementação padrão do rodapé é renderizada. Você pode adicionar um código HTML ao elemento <td> renderizado do rodapé com a propriedade extraFooterHtml.A área do Rodapé de coluna da tabela exibe rodapés de coluna na parte inferior da tabela. Os rodapés de coluna da tabela são úteis em tabelas com vários grupos de linhas. Se você especificar o texto dos rodapés de coluna com a propriedade tableFooterText, a implementação padrão do rodapé é renderizada. Você pode adicionar um código HTML extra ao elemento <td> renderizado do rodapé da tabela com a propriedade extraTableFooterHtml.