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