标准的 JSF“复选框列表”组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上选择 JavaServer Faces 复选框列表组件
时(在将该组件添加到页面上后),将显示该组件的“属性”窗口。此组件具有以下属性。
常规
- id。
类型:文本
页面 Bean 和 JSP 文件中组件的名称。在 JSP 文件中,该名称是该组件的 id 属性的值。在页面 Bean 中,该属性的值是 HtmlSelectManyCheckbox 对象的名称。
- selectedValues。
类型:对象
在提交页面时发送的数据。这是 value 属性的别名。
外观
- border。
类型:整型
表示包含复选框列表的表的边框大小。如果该值没有设置或为零 (0),则没有边框。
- disabled。
类型:布尔型
如果选定,则表示该组件应该从不接收焦点或被包含在提交中。请参见 readonly 属性下面有关使用 disabled 属性与使用 readonly 属性的效果对比说明。
- disabledClass。
类型:字符串
页样式表或其 <head> 部分中定义的 CSS 样式类(要应用于列表中禁用的复选框的标签)。
- enabledClass。
类型:字符串
页样式表或其 <head> 部分中定义的 CSS 样式类(要应用于列表中启用的复选框的标签)。
- 可通过设置或清除用于初始化列表选项的
SelectItems 组件的 disabled 属性,禁用或启用该选项。
- layout。列表的方向。缺省方向是 lineDirection:将列表从左到右水平排列。如果选择 pageDirection,则将列表从上到下垂直排列。
- readonly。
类型:布尔型
如果选定该属性,则用户无法更改复选框列表,但将提交其值。
- 在提交页面时将包含 readonly 字段,这一点与 disabled 字段恰好相反。在您能想到的几乎每种应该使用 disabled 属性禁止用户更改值的情况下,都应该使用 readonly 属性替代。如果您使用 disabled 属性,JavaServer Faces 根本检测不到提交的任何值。
- style。
类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。此属性将覆盖项目 CSS 文件中的所有设置。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
- styleClass。
类型:字符串
呈现组件时应用的以空格分隔的 CSS2 样式类列表。这些样式类必须在项目的样式表中进行定义。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器。
- title。
类型:字符串
有关此组件的建议性标题信息,可以由屏幕阅读器读取并显示为工具提示。
- 如果禁用该组件,则在大多数浏览器中将不显示工具提示。
数据
- converter。
类型:转换器
为值属性生成正确类型的值的 JavaServer Faces 转换器。如果用户输入了错误类型的值(如为整型转换器输入词语而不是数值),转换器将发送一条可以在内联消息组件中显示的消息。
- required。
类型:布尔型
如果选中此属性,则要求用户为组件提供值。
- validator。
类型:方法绑定
指示提交值时将调用 JavaServer Faces 验证器。可以从下拉列表中选择一个验证器。如果选择 (null),则不会调用任何验证器。如果不满足验证器定义的条件,验证器将发送一条可以在内联消息组件中显示的消息。
如果选择了验证器,您还可选择 required 属性以确保该验证器接收值。
- 如果您定义了自己的验证方法(例如,通过右键单击该组件并选择“编辑事件处理程序”> "validate"),该验证方法的名称将覆盖您在此属性中可能已指定的任何验证器。
- value。
类型:对象
在提交页面时发送的数据。
复选框列表组件可能具有多个值,这与可使用的值类型有关。
- 如果使用值绑定表达式,则表达式必须指向对象数组。此数组中的各个元素表示当前从所有可能的选项集合中选定的值。
- 如果没有使用值绑定表达式,则在调用
checkboxList.getValue() 时返回的对象为对象数组。
- 无法将此组件绑定到数据库数据。
一种处理用户所选值的方法是:将此组件绑定到某个对象数组,并在用户提交页面时检查数组值。
事件
要设置事件属性,请在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "<事件名称>"。
- validate。表示为验证组件值而调用的方法的名称(如果存在)。如果要编写验证器方法代码,而不为
validator 属性选择 JavaServer Faces 验证器,请右键单击该组件,然后选择“编辑事件处理程序”> "validate"。该方法的缺省名称为 component-id_validate,其中 component-id 是组件的 id 属性的值。按照这种方式定义该方法时,将自动设置 validator 和 validate 属性。如果定义验证器,应同时选择 required 属性,以确保使用该验证器。
- 设置此属性时,还将设置
validator 属性的值。如果定义您自己的 validate 方法,请不要单独更改 validator 属性的值,否则可能会断开 validate 方法连接。
- valueChange。表示在更改组件值时调用的组件值更改侦听程序方法的名称。如果未定义此方法,则此属性的值为
null。要在页面 Bean 中定义此方法,通常可以在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "processValueChange"。该方法的缺省名称为 component-id_processValueChange,其中 component-id 是组件的 id 属性的值。
JavaScript
- onblur。
类型:字符串
组件失去焦点时执行的 JavaScript。
- onchange。
类型:字符串
组件失去焦点以及获得焦点后其值被修改时执行的 JavaScript。
- onclick。
类型:字符串
用户单击组件时执行的 JavaScript。
- ondblclick。
类型:字符串
用户双击组件时执行的 JavaScript。
- onfocus。
类型:字符串
组件获得焦点时执行的 JavaScript。
- onkeydown。
类型:字符串
组件具有焦点并按下某个键时执行的 JavaScript。
- onkeypress。
类型:字符串
组件具有焦点并按下及释放某个键时执行的 JavaScript。
- onkeyup。
类型:字符串
组件具有焦点并释放某个键时执行的 JavaScript。
- onmousedown。
类型:字符串
在鼠标光标位于组件上方且用户按下鼠标按钮时执行的 JavaScript。
- onmousemove。
类型:字符串
用户在组件中移动鼠标光标时执行的 JavaScript。
- onmouseout。
类型:字符串
在鼠标光标位于组件上方后用户将其从组件移开时执行的 JavaScript。
- onmouseover。
类型:字符串
用户将鼠标光标移动到组件上方时执行的 JavaScript。
- onmouseup。
类型:字符串
鼠标光标位于组件上方且用户释放鼠标按钮时执行的 JavaScript。
- onselect。
类型:字符串
用户选择组件中的文本时执行的 JavaScript。
高级
- accesskey。
类型:字符串
激活此组件的键盘按键或快捷键。可以输入任何可在键盘上按下的有效字符。相当于 HTML <input> 标记的 accesskey 属性。
- dir。
类型:字符串
文本未继承方向(例如,文本为英语,但页面原来的语言为希伯莱语)时的方向指示符。相当于 HTML <input> 标记的 dir 属性。
值可以为:
- immediate。
类型:布尔型
如果选定此属性,当用户激活组件时,将先执行页面 Bean 中的代码,然后再执行验证、更新模型值等操作。实际上,代码在服务器中立即执行,然后返回该页面。
immediate 操作的最常见示例是“取消”按钮。可以将其设置为 immediate 以跳过常规验证和更新步骤,但操作处理程序仍可以执行所需的操作。通常,操作处理程序将导航至先前的某个页面。在某些设计中,操作处理程序可能还会将信息消息放在队列中,例如“事务已取消”。还可以执行其他操作,例如,应用程序可能记录以下情况:用户填写了表单的一部分,并随后取消了该操作。
- lang。
类型:字符串
描述为组件生成的标记中所用语言的代码。相当于 HTML <input> 标记的 lang 属性。要选择语言代码,可以单击省略号按钮 (...) 打开属性编辑器。例如:
ar - 传统阿拉伯语
de - 德语
en - 英语
es - 西班牙语
fr - 法语
ja - 日语
除了属性编辑器中可用的代码,还可以使用 ISO 标准名称输入其他代码。例如:
en-US - 美国英语
ja-JP - 日语
zh-guoyu - 普通话或标准汉语
zh-Hans - 简体中文脚本
zh-HanT - 繁体中文脚本
- rendered。
类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理组件。如果未选定该属性,则组件将不出现在页面中,甚至不作为隐藏组件出现。可以将此属性绑定到用来确定何时呈现该组件的变量。例如,机票预订表单可能只为经常乘坐飞机的人显示组件,而不为一般大众显示它。要绑定此属性,请在可视设计器中右键单击组件并选择“属性绑定”,然后选择“全部”单选按钮以显示所有属性。
- tabindex。
类型:字符串
(可选)按文档的 Tab 键顺序指定组件的位置,从而确定当用户使用 Tab 键在文档中移动时组件成为焦点的时间。该值必须为 0 至 32767 之间的整数。相当于 HTML <input> 标记的 tabindex 属性。
- valueChangeListener。
类型:方法绑定
请参见上述“事件”类别的 valueChange 属性,它提供了一种更简便的方法来设置此属性的值。valueChangeListener 属性是作为 valueChange 事件属性基础的方法绑定属性。为 valueChange 事件属性设置该方法后,将会更新 valueChangeListener 属性。
如果单击 valueChange 属性旁边的省略号按钮,则可以使用该属性的属性编辑器来选择要绑定到的现有方法,或者创建新的方法或取消绑定现有方法。如果您是专家,则可以在此 valueChangeListener 属性中直接键入方法绑定表达式,而不使用 valueChange 属性(例如,如果您要调用不在页面 Bean 中的方法)。
- 另请参见
- 标准复选框列表组件
- 使用组件
- 组件任务:快速参考
法律声明