标准的 JSF“复选框列表”组件
另请参见
可以将标准 JavaServer Faces 复选框列表组件
从组件面板的“标准”类别拖到可视设计器中,以创建最初在单行中包含三个复选框的表。
- 此组件是 JavaServer Faces 引用实现,不能使用主题。组件面板的“基本”类别中的复选框组组支持主题,而且提供可提高易用性的其他功能。
复选框列表是包含以下元素的组合组件:
- 包含的组件 checkboxList 控制列表本身的样式和行为。此外,当用户提交页面时,此组件的值属性为包含用户所选内容的对象数组。您可以将此组件的值属性绑定到
Object 数组,并使用该对象来测试用户所选内容的结果。
- 内部组件 checkboxListSelectItems 用于绑定到指定列表中实际项的数据提供器。
- 第三个相关组件 checkboxListDefaultItems 包含列表初始复选框的数组。只有当尚未将列表绑定到数据提供器时,才能使用此数组来填充列表。此第三个组件中的每个复选框都具有一个包含缺省文本(
item1、item2、item3)的标签。
将组件拖到可视设计器中之后,可以使用它来执行以下多项操作:
- 选择复选框列表组件,并将其拖到页面上的其他位置。
- 右键单击中的 checkboxList 组件,并选择“属性绑定”以将其值属性绑定到已作为属性添加到会话中的
Object 数组。您可以使用此会话 Bean 属性来计算用户提交页面后选择的值。有关详细信息,请参见下面的值属性说明。
- 右键单击“导航”窗口中的 checkboxListSelectItems 组件,并将其绑定到用于填充列表的数据提供器。
- 在可视设计器中选择页面上的复选框列表组件,并在复选框列表“属性”窗口中编辑其属性。这些属性影响列表的总体样式和行为。可以对下列常用属性进行设置:
- 在可视设计器中,右键单击复选框列表组件,并选择以下某项操作:
- 编辑事件处理程序。为以下任一事件处理程序编写代码。
- validate。打开 Java 编辑器并将光标放在复选框列表的
validate 方法上,以便插入代码来验证复选框列表的值。
- processValueChange。打开 Java 编辑器并将光标放在复选框列表的
processValueChange 方法上,以便插入在此复选框列表的值更改时(例如,用户选中两个框并提交表单)执行的代码。
- 绑定到数据。将组件的
value 属性绑定到对象或数据提供器,如“绑定到数据”对话框中所述。
- 属性绑定。打开一个对话框,通过该对话框可以将组件属性绑定到自动更新此组件属性的其他对象或属性。
- 添加绑定属性。该选项用于在组件中添加绑定属性。
- 注意:如果您打算使用 Java 代码编写组件脚本,则必须手动添加绑定属性,可使用值绑定表达式将该属性绑定到支持页面 Bean 的属性上。
- 删除绑定属性。该选项用于从组件中删除绑定属性。
- 另请参见
- 使用组件
- 组件任务:快速参考
- 关于 Visual Web 组件面板
法律声明