数据表

创建一个数据表,在该表中,行对应于数据记录,列对应于字段或类别。功能包括分页控件、页眉和页脚以及对行选择和操作的支持。

设计时的组件

数据表组件拖放到页面上:

“数据表”组件按钮

设计时页面上的数据表组件:

设计时的“数据表”

运行时的组件

运行时页面上的数据表组件:

运行时的“数据表”

属性视图和全部属性视图

组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击窗口 > 显示视图 > 属性

“数据表”组件的这些常见属性显示在“属性”视图中的 h:dataTable显示选项行操作选项卡上。要获取完整的属性列表,请参阅全部数据表属性表。用于添加操作和更改表显示和导航的其他配置选项位于 h:dataTable> 显示选项h:dataTable> 行操作选项卡上:

表 1. 数据表配置选项

配置选项

描述

添加当单击行时就会执行的操作

允许您创建在单击行时将发生的运行时操作。

添加编辑列,它可以启动对行内容进行就地编辑的表单

允许您在运行时提供行内编辑。

添加高级分页控件

对页脚区域添加一个组件,该组件通过使用箭头在页面之间移动。

添加“转至”分页控件

对页脚区域添加一个组件,该组件允许您从下拉列表中选择一页。

添加页面信息

对页脚区域添加一个组件,该组件将显示有关页面的统计信息。

将选择列添加至表

允许您添加具有与表内容相关选项的列。

添加将处理所选标题的操作

允许您创建处理标题信息的操作。

添加简单分页控件

对页脚添加一个组件,该组件将创建简单下拉菜单以便移至下一页。

添加 Web 样式分页控件

将每个页码添加至页脚区域,以便用户可以单击期望的页码。

分类 > 将列添加到分类表行中

分类 > 除去分类表行中的列

添加具有行分类组件的列,可以在该组件中设置表排序值并将图标或文本添加至该列。一旦添加了该列,“分类”图标就会更改为“除去”。

在表中添加列组件,或从表中除去列组件。可以对每个列设置标签、宽度和 ID,并将它们移到表中。

显示页脚

选择此框会将页脚区域 f:facet (footer)h:panelBox 插入到数据表中,然后可以向该页脚区域中填充其他组件。

显示页眉

选择此框会将页眉区域 f:facet (header)h:panelBox 插入到数据表中,然后可以向该页眉区域中填充其他组件。

单击以创建/编辑定制验证代码

切换至“快速编辑”视图,以便可以为用户启动的各种事件输入脚本或代码段。

“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 “全部属性”图标

表 2. 全部数据表属性

属性名称

在“属性”视图中表示为

描述

bgcolor

背景色

使用以 # 符号开头的 6 位十六进制 RGB 值指定背景色,或者通过输入颜色名称(例如,黑色、白色或蓝色)来指定背景色。

border

边框

指定表的边框大小(以像素计)。

binding

未表示

该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。

cellpadding

填充

指定单元格边框与单元格内容之间的间隔距离。如果此属性的值是一个像素长度,则内容与四个边的距离都应是这一距离。

cellspacing

间隔

指定单元格之间要保留的间隔大小(以像素计)。

columnClasses

列类

为数据表组件的列指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。

dir

未表示

指定当在运行时呈示时组件的方向。值可以是:
  • ltr - 从左到右
  • rtl - 从右到左
如果未指定方向,则使用适合于对组件进行编码的方向。

first

未表示

要显示的第一行的索引。

footerClass

页脚类

为数据表组件的列标题指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。

框架

未表示

指定网格框的哪几条边可视。

headerClass

标题类

为数据表组件的列标题指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。

id

标识

对组件指定一个名称。它在 JSP 内应该是唯一名称。

lang

未表示

组件的值和文本内容所用的语言。如果语言被忽略,则它会从包含标记(特别是视图)继承。指定为符合 ISO 标准的语言缩写代码。例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语。
注: 此选项不是“翻译”组件中的文本,而是标识组件的语言以便搜索、排序、整理以及类似操作能够正确完成。

rendered

未表示

可设置为 true 或 false:
  • false - 将不会在运行时向浏览器呈示组件。
  • true - 将呈示组件。这是缺省值。

rowClasses

行类

在显示行时循环出现的一组类。这可以手工定义,也可以通过单击按钮并从窗口中选择期望的类来定义。

rows

每页的行数

指定在运行时显示的行数。

规则

未表示

指定哪些规则将出现在表的单元格之间:
  • none
  • groups
  • rows
  • cols
  • all

样式

样式:属性

指定组件的 CSS 样式信息,例如,style="font-size : 8pt ; color : red"。定义所选组件的属性,例如,字体和颜色。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。

styleClass

样式:类

当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须作为生成标记上的类属性来传递。定义所选组件的类,例如,样式表。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。

summary

未表示

指定详细总结字符串,供用户代理呈示非可视媒体。

title

未表示

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。

value

指定在运行时显示的组件的初始文本值。包含要显示的信息,它采用指定值或者指向动态值的指针的形式。

var

未表示

使用 value 属性指定可用数据的引用变量名。

width

宽度

指定组件的宽度(以像素计或以百分比计)。要指定要使用百分比,请在值后面追加 %。

相关任务
添加并配置数据表
相关参考
输入
输入 - 隐藏
输入 - 密码
输入 - 文本区域
文件上载
丰富文本格式区域

反馈