数据表

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

设计时的组件

数据表组件拖放到页面上:
“数据表”组件按钮

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

运行时的组件

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

“属性”视图和“全部属性”视图

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

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

表 1. “数据表”配置选项

配置选项

描述

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

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

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

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

添加高级分页控件

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

添加“转至”分页控件

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

添加页面信息

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

将选择列添加至表

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

添加将处理对标题的选择的操作

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

添加简单分页控件

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

添加 web 样式分页控件

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

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

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

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

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

显示页脚

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

显示页眉

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

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

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

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

表 2. 全部“数据表”属性

属性名称

在“属性”视图中表示为

描述

bgcolor

背景色

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

border

边框

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

binding

未表示

表示此组件的 UIComponent,通常在备份文件中。

cellpadding

填充

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

cellspacing

间隔

指定单元格之间要保留的空白间距量(以像素计)。

columnClasses

列类

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

dir

未表示

指定当在运行时呈示时组件的方向。值可以是:
  • ltr - 从左到右
  • rtl - 从右到左

first

未表示

要显示的第一行的索引。

footerClass

页脚类

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

frame

未表示

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

headerClass

标题类

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

id

标识

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

lang

未表示

指定组件的属性值和文本内容的基本语言。采用 ISO 标准语言缩写代码(例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语)。

rendered

未表示

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

rowClasses

行类

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

rows

每页的行数

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

rules

未表示

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

style

样式:属性

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

styleClass

样式:类

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

summary

未表示

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

title

未表示

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。

value

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

var

未表示

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

width

宽度

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

相关概念
使用 JavaServer Faces 创建数据访问 Web 应用程序
相关任务
创建 Faces 应用程序 - 概述
相关参考
Faces 组件参考
Faces 组件的属性
复选框
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.