JSF 1.2 单选按钮组件

另请参见

单选按钮组件 “单选按钮”组件图标 是带有可选标签的单个单选按钮。

单选按钮组件通常成组使用。如果需要一组使用标签预设格式的单选按钮,请改用单选按钮组组件

单选按钮组件在以下情况下可能很有用:单选按钮组组件的布局不理想,如在表行中。也可以将单选按钮放在容器组件上,如表单元格或组框。

单个单选按钮可用于表示几种类型的数据:

一组单选按钮可用于表示以下内容:

单选按钮可以表示任何对象,无论该对象属于预定义的类(如 BooleanByteCharacterDoubleFloatIntegerLongShortString),还是属于用户定义的类。单选按钮还可以表示基元值。

布尔值用于指示是否选择某项,如表行。String 值用于传递在界面中选中的单选按钮的值。应用程序定义的 Object 值或类实例可用于保存与选中单选按钮相关的详细信息。

检测选中的单选按钮

单选按钮组件使用 selectedselectedValue 属性来传递有关单选按钮选择状态的信息。selected 属性用于表示已选中单选按钮并在页面中显示已选中按钮的标志。selectedValue 属性用于传递单选按钮的数据值。如果 selected 属性值与 selectedValue 属性值相等,则认为已选中单选按钮。通过为 selectedValueselected 属性赋相同的值,可以在最初查看页面时将单选按钮显示为处于选中状态。

如果未指定 selectedValue 属性或其值为 null,则单选按钮的行为类似于布尔型控件(如下节所述)。

可以将计算结果为基元值的值绑定表达式赋给 selectedselectedValue 属性。

将单选按钮组件用作布尔型控件

如果未指定 selectedValue 属性或其值为 null,则单选按钮的行为类似于布尔型控件。

要将单选按钮用作布尔型控件,请不要指定 selectedValue 属性的值。如果 selected 属性不为 null,并且具有结果为 True 的 Boolean 实例值或布尔型基元值,则该单选按钮处于选中状态。如果未选中该单选按钮,则 selected 属性值是一个结果为 False 的 Boolean 实例或布尔型基元。

使用单选按钮表示应用程序定义的值

可以将 selectedValue 属性赋给应用程序定义的对象值,以表示所选中的单选按钮的值。如果选中单选按钮,则会将 selected 属性值赋给 selectedValue 属性值。

如果 selectedValue 属性值是应用程序定义的对象,则必须注册转换器以转换为 String 值或从中进行转换。转换器用于将单选按钮值编码为 HTML <input> 元素的值,以及对请求中的提交值进行解码。此外,该对象还必须支持 equals 方法,该方法在将 selectedValue 属性值与 selected 属性值进行比较以检测选中的单选按钮时返回 true

将单选按钮用作组中的一个控件

name 属性用于确定某个单选按钮是否为组的一部分。组中的所有单选按钮都具有相同的 name 属性值。组的行为类似于单个选择列表,只能选择其中的一个单选按钮。在包含单选按钮的页面范围内,name 属性值必须是唯一的。

另请参见
单选按钮属性窗口
绑定组件属性
使用组件
组件任务:快速参考
关于 Visual Web 组件面板

法律声明