可以将标准的 JavaServer Faces 单选按钮列表组件
从组件面板拖到可视设计器中,以创建一个最初在单行中包含三个单选按钮的表。
单选按钮列表是一个组合组件:包含的组件 (radioButtonList) 控制列表本身的样式和行为;而内部组件 (radioButtonListSelectItems) 用于绑定到列表中的实际项。第三个相关组件(名为 radioButtonListDefaultItems)是为添加到页面的每个单选按钮列表组件创建的,它包含一组静态的缺省列表项(item1、item2、item3)。最后一个组件并非通常使用的组件。在将单选按钮列表添加到页面之后,您可以在“导航”窗口中看到所有这些组件。
单选按钮列表呈现为 HTML <table>,它在每个单元格中包含 <input style="radio">。每个 <input> 包含在 <label> 中,用于为每个按钮提供标签。
将单选按钮列表组件添加到 Visual Web JSF 页后,可以使用它来执行多项操作:
id 属性的值。在页面 Bean 中,该属性的值是 HtmlSelectOneList 对象的名称。radioButtonListSelectItems 部分控制的,而不是由值属性控制的。有关设置组件的 radioButtonListSelectItems 部分所使用的常用方法,请参见下面“将列表项绑定到数据库”选项的说明。
也可以在“导航”窗口中右键单击 radioButtonListSelectItems 节点并选择“属性绑定”,以将其值属性绑定到填充列表的会话 Bean 的属性。有关详细信息,请参见“导航”窗口中的会话 Bean 描述。
validate 方法上,以便插入代码来验证组件的值。processValueChange 方法上,以便插入在该组件的值发生更改时(例如,用户更改用于控制该组件中的选定单选按钮的另一个组件的值)执行的代码。value 属性绑定到对象或数据提供器,如“绑定到数据”对话框中所述。 common_timeoutSubmitForm(this.form, 'component-id');。在运行时,如果用户更改了组件值,该代码将导致自动提交表单。在提交表单后,将在服务器上进行转换和验证,执行任何值更改侦听程序方法,然后重新显示页面。
配置为“更改时自动提交”的组件可以使用虚拟表单来限制在提交表单时处理的输入字段。如果定义了自动提交组件来提交虚拟表单,则在进行自动提交时,将只处理该虚拟表单中的参与者。