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