您可以将复选框组组件
从组件面板的“Woodstock 基本”类别拖到可视设计器中,以便创建带有标签的复选框表。
这些复选框将呈现在 HTML <table> 元素的行和列中。行数是由复选框数定义的。列数是由 columns 属性定义的。缺省布局是单个垂直列。如果要将多个复选框排列在一行中,则可以将 columns 属性设置为复选框数。
items 属性绑定到填充列表的 com.sun.webui.jsf.model.Option 对象的数组、列表或集合上。可以通过右键单击组件并选择“绑定到数据”来设置该属性。在中,可以看到用于填充列表的缺省对象,该对象的名称类似于 checkboxGroup1DefaultOptions。选项标签即为复选框标签。用户选择一个或多个复选框时,组件的 selected 属性包含所选值的数组。
可以设置 selected 属性,将组件与用于选取用户所选项的模型对象相关联。模型对象必须是对象数组,其值表示列表中 com.sun.webui.jsf.model.Option 对象的值。第一次呈现组件时,与 selected 属性值对应的选项(如果存在)将被标记为选中状态。
有关将组件绑定到对象以设置列表的信息,请参见下面的“绑定到数据”。
将组件拖到可视设计器中之后,可以使用它来执行以下多项操作:
validate 方法上,以便插入代码来验证组件的值。processValueChange 方法上,以便插入在该组件的值发生更改时(例如,用户更改了另一个组件的值,而这个组件正在控制该组件的值)执行的代码。common_timeoutSubmitForm(this.form, 'component-id');。在运行时,如果用户更改了组件值,该代码将导致自动提交表单。在提交表单后,将在服务器上进行转换和验证,执行任何值更改侦听程序方法,然后重新显示页面。
配置为“更改时自动提交”的组件可以使用虚拟表单来限制在提交表单时处理的输入字段。如果定义了自动提交组件来提交虚拟表单,则在进行自动提交时,将只处理该虚拟表单中的参与者。
items 属性绑定到对象或数据提供器,如“绑定到数据”对话框中所述。
items 属性绑定到对象,请选择“绑定到对象”标签,然后选择一个将用于填充列表的 Bean 属性。Bean 属性必须为 Object 数组、映射或集合,其成员是 com.sun.webui.jsf.model.Option 的所有子类。
items 属性绑定到用于填充列表的数据库表或 JavaBeans 对象的数据提供器,请选择“绑定到数据提供器”标签,然后选择一个数据提供器。selected 属性,可以将该属性绑定到 Object 数组或基元数组。您必须已将数组作为属性添加到受管 Bean(如会话 Bean)中。您可以使用此 Bean 属性来计算用户提交页面后选择的值。checkboxgroup#defaultOptions 对象以及更改显示的复选框。您很可能希望将 items 属性绑定到数据库或对象,以便设置复选框列表项,如上面的“绑定到数据”中所述。 id 属性的值。在页面 Bean 中,该属性的值是 CheckboxGroup 对象的名称。for 属性将设置为组中的第一个复选框。label 属性中指定的标签设置样式级别。值为 1(强)、2(中)和 3(弱)。缺省值为 2。