2.4.1.12 Hyperlink Control

  • Article

The hyperlink control allows the user to create a hyperlink that navigates the default browser to a specified URL. A HYPERLINK MUST have one of the symbols in the following table.

Symbol

Description

SIMPLE_HYPERLINK

Hyperlinks are read-only controls that open a new browser window to another web location. They are composed of link target and display text.

HYPERLINK_WITH_DYNAMIC_LINK

Similar to SIMPLE_HYPERLINK, with the exception that the hyperlink’s target link is dynamically populated from a node in the form.

HYPERLINK_WITH_DYNAMIC_TEXT

Similar to SIMPLE_HYPERLINK, with the exception that the hyperlink’s display text is dynamically populated from a node in the form (1).

HYPERLINK_WITH_DYNAMIC_LINK_AND_DYNAMIC_TEXT

Similar to HYPERLINK_WITH_DYNAMIC_LINK and HYPERLINK_WITH_DYNAMIC_TEXT.

SIMPLE_HYPERLINK:

 <a href="ANY_STRING" (title="ANY_STRING")? (accessKey="SINGLE_CHARACTER")? (tabIndex="TAB_INDEX")? xd:disableEditing="yes">ANCHOR_TEXT</a>
  
 HYPERLINK_WITH_DYNAMIC_LINK ::=
 <a class="xdDataBindingUI" (title="ANY_STRING")? (accessKey="SINGLE_CHARACTER")? (tabIndex="TAB_INDEX")? xd:disableEditing="yes">
     CHECK_FOR_GETDOM_BEGIN1
     <xsl:attribute name="href">
         <xsl:value-of select="LEAF_XPATH"/>
     </xsl:attribute>
 ANCHOR_TEXT
     CHECK_FOR_GETDOM_END1
 </a>

HYPERLINK_WITH_DYNAMIC_TEXT:

 <span class="xdHyperlink" hideFocus="1" (title="ANY_STRING")? style="DYNAMIC_HYPERLINK_TEXT_STYLE" xd:xctname="hyperlink">
     <a class="xdDataBindingUI" (title="ANY_STRING")? (accessKey="SINGLE_CHARACTER")? (tabIndex="TAB_INDEX")? href="ANY_STRING" xd:disableEditing="yes" xd:CtrlId="CONTROL_ID">
     CHECK_FOR_GETDOM_BEGIN1
         <xsl:value-of select="LEAF_XPATH"/>
     CHECK_FOR_GETDOM_END1
     </a>
 </span>

HYPERLINK_WITH_DYNAMIC_LINK_AND_DYNAMIC_TEXT:

 <span class="xdHyperlink" hideFocus="1" (title="ANY_STRING")? style="DYNAMIC_HYPERLINK_TEXT_STYLE" xd:xctname="hyperlink">
     <a class="xdDataBindingUI" (title="ANY_STRING")? (accessKey="SINGLE_CHARACTER")? (tabIndex="TAB_INDEX")? xd:disableEditing="yes" xd:CtrlId="CONTROL_ID">
     CHECK_FOR_GETDOM_BEGIN1
         <xsl:attribute name="href">
             <xsl:value-of select="LEAF_XPATH1"/>
         </xsl:attribute>
         <xsl:value-of select="LEAF_XPATH2"/>
     CHECK_FOR_GETDOM_END1
     </a>
 </span>

DYNAMIC_HYPERLINK_TEXT_STYLE: Semicolon-delimited list of (OVERFLOW: visible, STYLE_WIDTH?, STYLE_TEXT_ALIGN?, STYLE_BORDER?, STYLE_FONT?, STYLE_VERTICAL_ALIGN?, STYLE_TEXT_DECORATION?, STYLE_BACKGROUND_COLOR?, STYLE_COLOR?)

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

 xd:CrtlId (section 2.4.2.10)
 xd:disableEditing (section 2.4.2.12)
 xd:xctname (section 2.4.2.35)