复选框组

一组复选框。此组件通常用来从许多选项中选择一项或多项。可以静态方式定义选项列表,也可以将选项列表绑定至数据存储器,例如,数据库和/或 Bean。通常将整个组绑定至数据存储器。当提交具有“复选框组”组件的页面时,会将所选复选框的值存储在指定位置(例如,数据库中的列或 bean 的属性)。

设计时的组件

复选框组组件拖放到页面上:
“复选框组”组件按钮

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

运行时的组件

在运行时,复选框组组件在页面上看起来为如下所示:
运行时的“复选框组”

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

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

“复选框组”组件的这些常见属性显示在“属性”视图中的 h:selectManyCheckbox辅助功能选项卡上。要获取完整的属性列表,请参阅全部复选框组属性表。复选框组选项的其它配置选项位于 h:selectManyCheckbox 选项卡上:

配置选项

描述

对组中的每个复选框添加选项

允许您指定“复选框组”组件中各个框的名称、值和顺序。可以添加单个选项或一组选项。

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

表 1. 全部“复选框组”属性

属性名称

在“属性”视图中表示为

描述

accesskey

辅助功能 > 访问键

将单个键盘键指定为访问键。在运行时按指定的访问键就可以使此组件具有焦点。

binding

未表示

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

border

未表示

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

converter

未表示

指定要将值转换至的数据类型。JavaServer Faces 实现提供了一组“转换器”实现,可以使用它们来将组件数据转换为其处理器不支持的类型。

dir

未表示

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

disabled

未表示

如果 disabled 设置为 true,则在运行时将显示组件,但它不起作用。如果保留为空白,则缺省值为 false。

disabledClass

未表示

与组件关联的备用 CSS 类名。使用这些类名的情况可从名称确定。

enabledClass

未表示

与组件关联的备用 CSS 类名。使用这些类名的情况可从名称确定。

id

标识

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

immediate

未表示

如果为 true,则直接跳至生命周期的呈示阶段。

lang

未表示

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

layout

方向

指定布局(水平或垂直):
  • line_direction = Horizontal
  • page_direction = Vertical

readonly

未表示

指定组件的初始值不可更改。

rendered

未表示

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

required

未表示

必须指定组件。选择此项以要求用户输入值。

style

样式:属性

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

styleClass

样式:类

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

tabindex

辅助功能 > 跳进顺序索引

指定 JSP 中按跳进顺序排列的组件的位置。此值必须是 0 与 32767 之间的数。

title

辅助功能 > 标题

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

validator

未表示

要实例化的验证器的类名。

value

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

valueChangeListener

未表示

当组件的值更改时要通知的方法。

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