面板 - 组框 - 网格

此复合组件用来布局其它组件。它将它包含的所有组件都排列到一个具有指定列数的表中。

设计时的组件

网格组件拖放到页面上:
“网格”组件按钮

网格组件在页面上看起来为如下所示:
设计时的“网格”

运行时的组件

在运行时,网格组件随添加的组件不同而不同。

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

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

“网格”组件的这些常见属性显示在“属性”视图中的 hx:panelGrid选项卡上。要获取完整的属性列表,请参阅全部网格属性表。面板项的其它配置选项位于 hx:panelGrid> 项选项卡上:

表 1. “网格”配置选项

配置选项

描述

面板中各项的顺序

允许您使用“上移”和“下移”按钮来指定面板中各个组件的顺序。

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

表 2. 全部“网格”属性

属性名称

在“属性”视图中表示为

描述

bgcolor

背景色

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

border

未表示

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

binding

未表示

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

cellpadding

填充

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

cellspacing

间隔

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

columnClasses

未表示

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

cols

大小:列数

指定网格中的列数。

dir

未表示

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

footerClass

未表示

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

frame

未表示

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

headerClass

未表示

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

id

标识

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

lang

未表示

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

rendered

未表示

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

rowClasses

未表示

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

rules

未表示

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

size

大小:高度

指定组件的高度(用行数、像素或占屏幕的百分比来表示)。

style

样式:属性

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

styleClass

样式:类

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

summary

未表示

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

title

未表示

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

width

大小:宽度

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

相关概念
使用 JavaServer Faces 创建数据访问 Web 应用程序
相关任务
创建 Faces 应用程序 - 概述
相关参考
Faces 组件参考
Faces 组件的属性
面板 - 组框
面板 - 组框 - HTML 面板(面板 - JSP)
面板 - 组框 - 列表
面板 - 组框 - 贴紧边框
面板 - 菜单栏
面板 - 选项卡式
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.