2.4.1.14 Option Button Control

  • Article

An option button is a bi-state control that has a value when selected and no value when not selected. Option button controls are meant to be used in groups, with selection among the option buttons in the group (1) being mutually exclusive. The following table describes the symbols for an option button control.

Symbol

Description

SIMPLE_OPTION_BUTTON

An option button is a binary state control. It is found in a group (1) of option buttons, where only a single member of the group (1) can be selected at any one time.

OPTION_BUTTON_WITH_CONDITIONAL_FORMATTING

Similar to SIMPLE_OPTION_BUTTON, but allows the button to be conditionally disabled.

SIMPLE_OPTION_BUTTON:

 <input class="xdBehavior_Boolean" title="ANY_STRING1" type="radio" name="{generate-id(LEAF_XPATH1)}" (accessKey="SINGLE_CHARACTER")? xd:binding="LEAF_XPATH1" xd:boundProp="xd:value" (xd:onValue="(ISO_646_DIGIT+)|(&quot;ANY_STRING2&quot;)")? (tabIndex="LEAF_CONTROL_TAB_INDEX")? xd:xctname="OptionButton" xd:CtrlId="CONTROL_ID" (xd:postbackModel="POSTBACKMODEL")? (style="OPTION_BUTTON_STYLE")?>
     CHECK_FOR_GETDOM_BEGIN1
     <xsl:attribute name="xd:value">
         <xsl:value-of select="LEAF_XPATH1" />
     </xsl:attribute>
     <xsl:if test="BOOLEAN_XPATH_EXPRESSION">
         <xsl:attribute name="CHECKED">CHECKED</xsl:attribute> 
     </xsl:if>
     CHECK_FOR_GETDOM_END1
 </input>
 ANY_STRING3

OPTION_BUTTON_WITH_CONDITIONAL_FORMATTING:

 <input class="xdBehavior_Boolean" title="ANY_STRING1" type="radio" name="{generate-id(LEAF_XPATH1)}" (accessKey="SINGLE_CHARACTER")? xd:binding="LEAF_XPATH1" xd:boundProp="xd:value" (xd:onValue="(ISO_646_DIGIT+)|(&quot;ANY_STRING2&quot;)")? (tabIndex="LEAF_CONTROL_TAB_INDEX")? xd:xctname="OptionButton" xd:CtrlId="CONTROL_ID" (xd:postbackModel="POSTBACKMODEL")? (style="OPTION_BUTTON_STYLE")?>
     CHECK_FOR_GETDOM_BEGIN1
     <xsl:attribute name="style">
         <xsl:choose>
             (<xsl:when test="BOOLEAN_XPATH_EXPRESSIONY">STYLE_CAPTION</xsl:when>)+
         </xsl:choose>
     </xsl:attribute>
     (<xsl:choose>
         (<xsl:when test="BOOLEAN_XPATH_EXPRESSIONY">
             <xsl:attribute name="disabled">true</xsl:attribute> 
         </xsl:when>)+
     </xsl:choose>)?
     <xsl:attribute name="xd:value">
         <xsl:value-of select="LEAF_XPATH1" />
     </xsl:attribute>
     <xsl:if test="BOOLEAN_XPATH_EXPRESSION">
         <xsl:attribute name="CHECKED">CHECKED</xsl:attribute> 
     </xsl:if>
     CHECK_FOR_GETDOM_END1
 </input>
 ANY_STRING3

OPTION_BUTTON_STYLE: Semicolon-delimited list of (STYLE_MARGIN?, STYLE_FONT?, STYLE_VERTICAL_ALIGN?, STYLE_BORDER?, STYLE_BACKGROUND_COLOR?, STYLE_COLOR?, STYLE_TEXT_DECORATION?, STYLE_WIDTH?, STYLE_HEIGHT?).

The following table lists control-specific attributes used by the option button control.

Attribute

Section

xd:binding

2.4.2.6

xd:boundProp

2.4.2.9

xd:CtrlId

2.4.2.10

xd:onValue

2.4.2.28

xd:postbackModel

2.4.2.29

xd:value

2.4.2.34

xd:xctname

2.4.2.35