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 being mutually exclusive. An OPTION_BUTTON MUST have one of the symbols in the following table.

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

The same as a SIMPLE_OPTION_BUTTON, but also 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_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_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: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?)

Control-specific attributes used by the option button control are as follows: