表列组件是表组件的一部分,并始终与表中的表行组组件关联。将表组件添加到 Visual Web JSF 页时,将自动在表组件中添加包含三个表列组件的表行组组件。您可以将表列组件
拖到可视设计器中的 Visual Web JSF 页上并将其放在表行组的现有表列中,或者将其放在“导航”窗口中的表行组节点上。
表列组件相当于 HTML <td> 标记,并始终与表行组组件关联。表列组件在 JSP 代码中称为 tableColumn,页面 Bean 中的关联 Java 类为 TableColumn。
要使用表列组件,您可以在可视设计器或“导航”窗口中选择该组件,然后编辑其属性。如果在可视设计器中选择表列,则可以单击鼠标右键,然后从弹出式菜单中选择多个选项,其中的一些选项如下所述:
除了菜单中的那些组件以外,您可以添加其他组件,但是首先必须添加组面板组件,然后可以将该组件置于组面板中。最简单的方式是将组件放在“导航”窗口的组面板中。您可能需要将组件放在“导航”窗口中,然后在该窗口中移动该组件,以确保它实际位于组面板中。
表列组件用于定义 XHTML <td> 元素的属性,这些属性用于显示表数据单元格。但是,列表头和脚注的呈现由表行组组件处理。下表显示了表组件的布局,使用表列属性定义的区域显示为蓝色,表组件的剩余部分显示为灰色。
| 标题栏 | ||||||||||||
| 操作栏(顶部) | ||||||||||||
|
||||||||||||
| 操作栏(底部) | ||||||||||||
| 脚注 | ||||||||||||
“列表头”区域显示每个表列的表头。如果使用 headerText 属性指定列表头的文本,则将呈现表头的缺省实现。可以使用 extraHeaderHtml 属性将额外 HTML 代码添加到表头的呈现 <td> 元素中。
可以使用以下列属性来更改列表头排序的外观和行为:
sort - 指定排序键并使列可排序。
sortIcon - 指定主题标识符,以选择要用作排序图标的不同图像,该图标显示在可排序列的表头中。
sortImageURL - 指定要用作排序图标的图像路径,该图标显示在可排序列的表头中。
descending - 如果设置为 true,将会使列按降序进行排序。
severity - 指定每个单元格中警报的严重性;在使用了 sort 属性时,将会使列按 severity 值进行排序。 footerText 属性指定列脚注的文本,则将呈现脚注的缺省实现。您可以使用 extraFooterHtml 属性将额外的 HTML 代码添加到脚注的呈现 <td> 元素中。“表列脚注”区域在表底部显示列脚注。表列脚注在包含多个行组的表中非常有用。如果使用 tableFooterText 属性指定表列脚注的文本,则将呈现脚注的缺省实现。可以使用 extraTableFooterHtml 属性将额外 HTML 代码添加到表脚注的呈现 <td> 元素中。