在使用可视设计器编辑的某个页面上选择单选按钮组件
时,将显示该组件的“属性”窗口。组件的大多数属性既是 JSP 属性,又是页面 Bean 中 RadioButton Java 组件的属性。
此组件具有以下属性。
类型:字符串类型:字符串导航至某个文件后,请选择该文件并单击“确定”。此时,会看到在单选按钮旁边显示的图像。图像文件将被复制到项目中,您可以在“项目”窗口中的 "<项目名称>" >“Web 页”> "resources" 下面看到该文件。
类型:字符串label 属性不像标签组件那样灵活。如果要对标签的外观进行更多控制(如相对于组件定位标签),则可以使用标签组件。类型:整型类型:字符串 position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
类型:字符串style 属性描述。 此组件的缺省主题 CSS 样式类为:
css_master.css
.CbDis, .RbDis {background-color:#E1E4E5;color:#848687}
.Cb {}
.Rb {}
.RbSpn input {vertical-align: 1px}
.CbSpn input {vertical-align: -1px}
.CbGrp td, .RbGrp td {text-align: left}
.CbGrp label, .RbGrp label {vertical-align: 6px}
css_ie55up.css
/* ADDITIONAL CSS FOR IE5.5+ SUPPORT */
.RbSpn input, .CbSpn input {vertical-align: 3px;}
类型:转换器类型:对象selectedValue 属性,则在选中单选按钮时值为 true,未选中单选按钮时值为 false。如果设置了 selectedValue 属性,则在用户选中单选按钮时,selected 属性的值与 selectedValue 属性的值相同。
RadioButton 组件包含 isChecked() 方法,如果选择了该组件,则此方法返回 true。
类型:方法绑定(null),则不会调用任何验证器。
要设置事件属性,请在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "<事件名称>"。
validator 属性选择 JavaServer Faces 验证器,请右键单击该组件,然后选择“编辑事件处理程序”> "validate"。该方法的缺省名称为 component-id_validate,其中 component-id 是组件的 id 属性的值。按照这种方式定义该方法时,将自动设置 validator 和 validate 属性。如果定义验证器,应同时选择 required 属性,以确保使用该验证器。
validator 属性的值。如果定义您自己的 validate 方法,请不要单独更改 validator 属性的值,否则可能会断开 validate 方法连接。component-id_processValueChange,其中 component-id 是组件的 id 属性的值。类型:布尔型readOnly 属性下面有关使用 disabled 属性与使用 readOnly 属性的效果对比说明。类型:布尔型disabled 属性,JavaServer Faces 根本检测不到提交的任何值。类型:字符串title 属性,可以由屏幕阅读器读取并显示为工具提示。
类型:布尔型rendered 属性。类型:字符串<input> 标记的 tabindex 属性。类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:布尔型immediate 操作的最常见示例是“取消”按钮。可以将其设置为 immediate 以跳过常规验证和更新步骤,但操作处理程序仍可以执行所需的操作。通常,操作处理程序将导航至先前的某个页面。在某些设计中,操作处理程序可能还会将信息消息放在队列中,例如“事务已取消”。还可能会执行其他操作,例如,应用程序可能会记录用户取消当前操作的情况。
类型:字符串name 属性中使用此名称,但是该名称对于此页面必须是唯一的。如果多个单选按钮的 name 属性设置为相同的值,则表明这些按钮是同一个单选按钮组的一部分。 类型:布尔型类型:对象selectedValue 属性或其值为 null,则单选按钮的行为类似于布尔型控件。在这种情况下,如果选中了单选按钮,则 selected 属性值是一个结果为 true 的 Boolean 实例。如果未选中单选按钮,则 selected 属性值是一个结果为 false 的 Boolean 实例。
可以将 selectedValue 属性赋给应用程序定义的对象值,以表示所选中的单选按钮的值。如果选中单选按钮,则会将 selected 属性值赋给 selectedValue 属性值。可以将用来求基元值的值绑定表达式赋给此属性。
如果 selectedValue 属性值是应用程序定义的对象,则必须使用 converter 属性注册一个转换器以转换为 String 值或从中进行转换。
类型:方法绑定valueChange 属性,它可提供更简便的方法来设置此属性的值。valueChangeListener 属性是作为 valueChange 事件属性基础的 MethodBinding 属性。为 valueChange 事件属性设置该方法时,将会更新 valueChangeListener 属性。
在单击 valueChange 属性旁边的省略号按钮时,可以使用该属性的属性编辑器来选择要绑定的现有方法,也可以创建新方法或取消绑定现有方法。如果您是这方面的专家,则可以在此 valueChangeListener 属性中直接键入 MethodBinding 表达式,而不是使用 valueChange 属性(例如,如果要调用不在页面 Bean 中的方法)。