复选框组

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

设计时的组件

复选框组组件拖放到页面上:

“复选框组”组件按钮

复选框组组件在页面上看起来如下所示:

设计时的“复选框组”

运行时的组件

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

运行时的“复选框组”

属性视图和全部属性视图

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

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

配置选项

描述

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

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

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

表 1. 全部复选框组属性

属性名称

在“属性”视图中表示为

描述

accesskey

辅助功能 > 访问键

将单个键盘键指定为访问键。在运行时按指定的访问键可以使此组件具有焦点。在运行时按 ALT + 指定的访问键可以使此组件具有焦点,如果组件是一种按钮,则执行此组件。

binding

未表示

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

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”表示徳语。
注: 此选项不是“翻译”组件中的文本,而是标识组件的语言以便搜索、排序、整理以及类似操作能够正确完成。

布局

方向

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

readonly

未表示

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

rendered

未表示

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

required

未表示

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

样式

样式:属性

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

styleClass

样式:类

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

tabindex

辅助功能 > 跳进顺序索引

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

title

辅助功能 > 标题

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

validator

未表示

接受 FacesContext、UIComponent 和 Object 参数的方法(由 MethodBinding 表达式表示)。在验证过程中将调用它以确保组件值正确。

value

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

valueChangeListener

未表示

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

相关任务
定义输入字段的定制模式
相关参考
复选框
组合框
单选按钮组

反馈