17.5.2.41 tabIndex

This element specifies the position of the current structured document tag in the navigation (tab) order used in the document. The index shall be stored on this element’s val attribute and is analogous to the tabIndex attribute in HTML.

Objects that support tab index shall be navigated by consumers in the following order:

• Objects for which the XML specifies a non-zero tabIndex value are navigated first. Navigation proceeds
• with the element with the lowest resolved value of tabIndex to the element with the highest resolved
• value of tabIndex.

Objects that specify identical resolved values of tabIndex is navigated in the lexical order in which the elements appear in the underlying WordprocessingML.

• Objects for which the XML does not specify an index or objects for which the XML specifies a resolved
• tabIndex value of 0 are navigated last. These objects are navigated in the lexical order in which they
• appear in the underlying WordprocessingML.

[Example: Consider the following two structured document tags where each structured document tag specifies a tab index:

<w:sdt>
  <w:sdtPr>
    <w:id w:val="5" />
    <w:tabIndex w:val="1" />
  </w:sdtPr>
  <w:sdtContent>
    <w:p>
      <w:r>
        <w:t>First Name</w:t>
      </w:r>
    </w:p>
  </w:sdtContent>
</w:sdt>
…
<w:sdt>
  <w:sdtPr>
    <w:id w:val="6" />
    <w:tabIndex w:val="2" />
  </w:sdtPr>
  <w:sdtContent>
    <w:p>
      <w:r>
        <w:t>Last Name</w:t>
      </w:r>
    </w:p>
  </w:sdtContent>
</w:sdt>

The tabIndex element specifies that the structured document tag with an identifier value of 5 must be the first content to be reached via tabbing, whereas the structured document tag with an identifier value of 6 must be the second content to be reached via tabbing. end example]

Attributes

val (Positive Decimal Number Value)

Specifies that the contents of this attribute contains a positive decimal number.

The contents of this positive decimal number are interpreted based on the context of the parent XML element.

[Example: Consider the following numeric WordprocessingML property of type ST_UnsignedDecimalNumber:

  <… w:val="15" />

The value of the val attribute is a decimal number whose value must be interpreted in the context of the parent element. end example]

The possible values for this attribute are defined by the ST_UnsignedDecimalNumber simple type (22.9.2.16).

[Note: The W3C XML Schema definition of this element’s content model (CT_UnsignedDecimalNumber) is located in A.1. end note]