面板 - 组框 - 列表

此复合组件用来布局其它组件。它将它包含的所有组件都排列到单行或单列中。

设计时的组件

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

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

运行时的组件

在运行时,列表组件随添加的组件不同而不同。

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

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

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

表 1. “列表”配置选项

配置选项

描述

面板中各项的顺序

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

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

表 2. 全部“列表”属性

属性名称

在“属性”视图中表示为

描述

align

对齐:水平

指定组件是应该向左对齐、居中对齐还是向右对齐。

bgcolor

背景色

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

binding

未表示

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

border

未表示

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

cellpadding

填充

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

cellspacing

间隔

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

height

大小:高度

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

id

标识

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

layout

面板的布局:方向

指定组件是水平定向还是垂直定向:
  • 水平
  • 垂直

rendered

未表示

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

style

样式:属性

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

styleClass

样式:类

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

title

未表示

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

valign

对齐:垂直

指定单元格中数据的垂直位置:
  • 顶部对齐
  • 中间对齐
  • 底部对齐

width

大小:宽度

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

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