创建一个数据表,在该表中,行对应于数据记录,列对应于字段或类别。功能包括分页控件、页眉及页脚和对行选择及操作的支持。
将数据表组件拖放到页面上:
设计时页面上的数据表组件:
运行时页面上的数据表组件:
组件的“属性”视图显示可以对组件设置的最常见属性的集合,并且根据组件的不同,您还可以看到用于添加控件、操作或其它组件的选项。要打开“属性”视图,单击窗口 > 显示视图 > 属性;但是,缺省情况下,该视图是打开的。
“数据表”组件的这些常见属性显示在“属性”视图中的 h:dataTable、显示选项和行操作选项卡上。要获取完整的属性列表,请参阅全部数据表属性表。用于添加操作和更改表显示和导航的其它配置选项位于 h:dataTable> 显示选项和 h:dataTable> 行操作选项卡上:
配置选项 |
描述 |
---|---|
添加当单击一行时就会执行的操作 |
允许您创建单击一行时将发生的运行时操作。 |
添加编辑列,它可以启动对行内容进行就地编辑的表单 |
允许您在运行时提供行内编辑。 |
添加高级分页控件 |
向页脚区域添加一个组件,该组件通过使用箭头在页面之间移动。 |
添加“转至”分页控件 |
向页脚区域添加一个组件,该组件允许您从下拉列表中选择一页。 |
添加页面信息 |
向页脚区域添加一个组件,该组件将显示有关页面的统计信息。 |
将选择列添加至表 |
允许您添加具有与表内容相关的选项的列。 |
添加将处理对标题的选择的操作 |
允许您创建处理标题信息的操作。 |
添加简单分页控件 |
向页脚添加一个组件,它将创建简单下拉菜单以便移至下一页。 |
添加 web 样式分页控件 |
将每个页码添加至页脚区域,以便用户可以单击期望的页码。 |
分类 > 将列添加到分类表行中 分类 > 除去分类表行中的列 |
添加具有行分类组件的列,可以在该组件中设置表排序值并将图标或文本添加至该列。一旦添加了该列,“分类”图标就会更改为“除去”。 |
列 |
在表中添加列组件,或从表中除去列组件。可以对每个列设置标注、宽度和标识,并将它们移到表中。 |
显示页脚 |
选择此框时将把页脚区域 f:facet (footer) 和 h:panelBox 插入到数据表中,然后可以向该页脚区域中填充其它组件。 |
显示页眉 |
选择此框时将把页眉区域 f:facet (header) 和 h:panelBox 插入到数据表中,然后可以向该页眉区域中填充其它组件。 |
单击以创建/编辑定制验证代码 |
切换至“快速编辑”视图,以便可以为用户启动的各种事件输入脚本或代码段。 |
“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,单击“属性”视图的右上角中的全部属性图标 。
属性名称 |
在“属性”视图中表示为 |
描述 |
---|---|---|
bgcolor |
背景色 |
用以 # 符号开头的 6 位十六进制 RGB 值指定背景色,或者通过输入颜色名称(例如,黑色、白色和蓝色等)来指定背景色。 |
border |
边框 |
指定表的边框大小(以像素计)。 |
binding |
未表示 |
表示此组件的 UIComponent,通常在备份文件中。 |
cellpadding |
填充 |
指定单元格边框与单元格内容之间的间隔距离。如果此属性的值是一个像素长度,则内容与四个边的距离都应是这一距离。 |
cellspacing |
间隔 |
指定单元格之间要保留的空白间距量(以像素计)。 |
columnClasses |
列类 |
为数据表组件的列指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才可以使用它。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。 |
dir |
未表示 |
指定当在运行时呈示时组件的方向。值可以是:
|
first |
未表示 |
要显示的第一行的索引。 |
footerClass |
页脚类 |
为数据表组件的列标题指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才可以使用它。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。 |
frame |
未表示 |
指定网格框的哪几条边可视。 |
headerClass |
标题类 |
为数据表组件的列标题指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才可以使用它。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。 |
id |
标识 |
对组件指定一个名称。它应该是 JSP 内的唯一名称。 |
lang |
未表示 |
指定组件的属性值和文本内容的基本语言。采用 ISO 标准语言缩写代码(例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语)。 |
rendered |
未表示 |
可设置为 true 或 false:
|
rowClasses |
行类 |
在显示行时循环出现的一组类。这可以手工定义,也可以通过单击按钮并从窗口中选择期望的类来定义。 |
rows |
每页的行数 |
指定在运行时显示的行数。 |
rules |
未表示 |
指定哪些标尺将出现在表的单元格之间:
|
style |
样式:属性 |
指定组件的 CSS 样式信息(例如,style="font-size : 8pt ; color : red")。定义所选组件的属性(例如,字体和颜色)。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。 |
styleClass |
样式:类 |
当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须在生成的标记上作为“class”属性传递。定义所选组件的类(例如,样式表)。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。 |
summary |
未表示 |
指定详细总结字符串,供处理非可视媒体的用户代理使用。 |
title |
未表示 |
指定标题文本,它在运行时以工具提示的形式显示在浏览器中。 |
value |
值 |
指定在运行时显示的组件的初始文本值。包含要显示的信息,它采用指定值或者指向动态值的指针的形式。 |
var |
未表示 |
使用 value 属性指定可用数据的引用变量名。 |
width |
宽度 |
指定组件的宽度(以像素计或以百分比计)。要指定要使用百分比,将 % 追加至值。 |