在使用可视设计器编辑的某个页面上或中选择单选按钮组组件
时,将显示该组件的“属性”窗口。
此 JavaServer Faces 1.2 组件具有以下属性。
类型:字符串id 属性的值。在页面 Bean 中,该属性的值是 RadioButtonGroup 对象的名称。类型:整型<table> 元素的行和列中。行数是由 items 数组长度定义的。列数是由 columns 属性定义的。缺省布局是单个垂直列。 类型:字符串for 属性将设置为组中的第一个单选按钮。
label 属性不像标签组件那样灵活。如果要对标签的外观进行更多控制(如相对于组件定位标签),则可以使用标签组件。类型:整型label 属性时,此属性才会生效。 类型:字符串 position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
类型:字符串style 属性描述。 类型:转换器enum 类作为参数(如枚举转换器中所述)。类型:对象com.sun.webui.jsf.model.Option 的所有子类)相关联。每个 Option 实例均表示一个单选按钮。Option 实例的 value 属性表示选中的单选按钮的值。如果 items 属性为空,或者数组、映射或集合为空,则不会呈现任何内容。
要了解有关 com.sun.webui.jsf.model.Option 的详细信息,请将此类包含在页面的 Java 视图中,将光标放在类名上,然后按 Alt-F1 组合键以查看其 Javadoc 说明。
缺省情况下,此属性与 com.sun.webui.jsf.model.SingleSelectOptionsList 对象关联,该对象的名称与 radioButtonGroup1DefaultOptions(可以在中看到其节点)类似。此对象仅用于通过缺省单选按钮来填充组。它位于页面 Bean 中。
类型:布尔型for 属性链接到此组件,则当用户尝试在不选择单选按钮的情况下提交页面时,屏幕将显示一条错误消息。
类型:对象 应用程序应该至少选择一个单选按钮。selected 属性必须设置为值绑定表达式,其结果将被计算以读取和写入 Object。从值绑定表达式中读取 Object 值时,该值将标识选中的单选按钮。Object 值必须至少等于一个 Option 实例的 value 属性,这些实例是在从赋给 items 属性的值绑定表达式中获取的数组中指定的。
在 JavaServer Faces 生命周期的 UPDATE_MODEL_PHASE 期间,将调用 selected 属性的值绑定表达式的 write 方法。如果选中某个单选按钮,则会将 Object 值作为参数传递给 write() 方法。Object 值是选中的单选按钮的值。
有关详细信息,请参见本页结尾处的使用列表框组件教程的链接。
类型:方法表达式可以从下拉列表中选择一个验证器。如果选择 (null),则不会调用任何验证器。如果选择了验证器,则还需要选择 required 属性以确保用户输入值。
要设置事件属性,请在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "<事件名称>"。
如果要编写 validate 方法代码,而不是为 validatorExpression 属性选择 JavaServer Faces 验证器,请右键单击该组件,然后选择“编辑事件处理程序”> "validate"。该方法的缺省名称为 component-id_validate,其中 component-id 是组件的 id 属性的值。按照这种方式定义该方法时,将自动设置 validator 和 validate 属性。如果定义了验证器,则还需要选择 required 属性以确保用户输入值。
validatorExpression 属性的值。如果定义您自己的 validate 方法,请不要单独更改 validatorExpression 属性的值,否则会断开 validate 方法连接。null。要在页面 Bean 中定义此方法,通常可以在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "processValueChange"。该方法的缺省名称为 component-id_processValueChange,其中 component-id 是组件的 id 属性的值。类型:布尔型readOnly 属性下面有关使用 disabled 属性与使用 readOnly 属性的效果对比说明。类型:布尔型disabled 属性,JavaServer Faces 根本检测不到提交的任何值。类型:字符串title 属性。如果用户将鼠标光标悬停在单选按钮组的标签上,则显示此属性的文本值。
类型:布尔型rendered 属性。类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:布尔型immediate 操作的最常见示例是“取消”按钮。可以将其设置为 immediate 以跳过常规验证和更新步骤,但操作处理程序仍可以执行所需的操作。通常,操作处理程序将导航至先前的某个页面。在某些设计中,操作处理程序可能还会将信息消息放在队列中,例如“事务已取消”。还可能会执行其他操作,例如,应用程序可能会记录用户取消当前操作的情况。
类型:布尔型visible 属性,而不是此属性。
可以将此属性绑定到确定何时呈现该组件的 JavaBeans 属性中。例如,机票预订表单可能只为经常乘坐飞机的人显示组件,而不为一般大众显示它。要绑定此属性,请单击属性右侧的省略号按钮 (...),然后在对话框中选择“使用绑定”。