单选按钮组件
是带有可选标签的单个单选按钮。
单选按钮组件通常成组使用。如果需要一组使用标签预设格式的单选按钮,请改用单选按钮组组件。
单选按钮组件在以下情况下可能很有用:单选按钮组组件的布局不理想,如在表行中。也可以将单选按钮放在容器组件上,如表单元格或组框。
单个单选按钮可用于表示几种类型的数据:
一组单选按钮可用于表示以下内容:
单选按钮可以表示任何对象,无论该对象属于预定义的类(如 Boolean、Byte、Character、Double、Float、Integer、Long、Short、String),还是属于用户定义的类。单选按钮还可以表示基元值。
布尔值用于指示是否选择某项,如表行。String 值用于传递在界面中选中的单选按钮的值。应用程序定义的 Object 值或类实例可用于保存与选中单选按钮相关的详细信息。
单选按钮组件使用 selected 和 selectedValue 属性来传递有关单选按钮选择状态的信息。selected 属性用于表示已选中单选按钮并在页面中显示已选中按钮的标志。selectedValue 属性用于传递单选按钮的数据值。如果 selected 属性值与 selectedValue 属性值相等,则认为已选中单选按钮。通过为 selectedValue 和 selected 属性赋相同的值,可以在最初查看页面时将单选按钮显示为处于选中状态。
如果未指定 selectedValue 属性或其值为 null,则单选按钮的行为类似于布尔型控件(如下节所述)。
可以将计算结果为基元值的值绑定表达式赋给 selected 和 selectedValue 属性。
如果未指定 selectedValue 属性或其值为 null,则单选按钮的行为类似于布尔型控件。
要将单选按钮用作布尔型控件,请不要指定 selectedValue 属性的值。如果 selected 属性不为 null,并且具有结果为 True 的 Boolean 实例值或布尔型基元值,则该单选按钮处于选中状态。如果未选中该单选按钮,则 selected 属性值是一个结果为 False 的 Boolean 实例或布尔型基元。
true 值的 ArrayList。 可以将 selectedValue 属性赋给应用程序定义的对象值,以表示所选中的单选按钮的值。如果选中单选按钮,则会将 selected 属性值赋给 selectedValue 属性值。
如果 selectedValue 属性值是应用程序定义的对象,则必须注册转换器以转换为 String 值或从中进行转换。转换器用于将单选按钮值编码为 HTML <input> 元素的值,以及对请求中的提交值进行解码。此外,该对象还必须支持 equals 方法,该方法在将 selectedValue 属性值与 selected 属性值进行比较以检测选中的单选按钮时返回 true。
name 属性用于确定某个单选按钮是否为组的一部分。组中的所有单选按钮都具有相同的 name 属性值。组的行为类似于单个选择列表,只能选择其中的一个单选按钮。在包含单选按钮的页面范围内,name 属性值必须是唯一的。