17.5.2.19 label

This element specifies the label identifier associated with the current structured document tag. The identifier representing the label shall be stored on this element’s val attribute and is used to reference the unique identifier value of a structured document tag. The contents of the structured document tag resolved by a specific unique identifier shall be used as the label content for the structured document tag that references that specific unique identifier of the structured document tag. If multiple instances of the label element are present, the labels referenced are ordered from most general to most specific. [Example: A form element for specifying country name might reference the label for these three items (in order): “Sender”, “Home Address”, and “Country”. end example]

If this element is omitted or the value of the label identifier cannot be resolved, then no label shall be associated with the given structured document tag.

[Example: Consider the following two structured document tags where one structured document tag references another structured document tag as a label:

<w:sdt>
  <w:sdtPr>
    <w:id w:val="5" />
  </w:sdtPr>
  <w:sdtContent>
    <w:p>
      <w:r>
        <w:t>Name</w:t>
      </w:r>
    </w:p>
  </w:sdtContent>
</w:sdt>
…
<w:sdt>
  <w:sdtPr>
    <w:id w:val="6" />
    <w:label w:val="5" />
  </w:sdtPr>
  …
</w:sdt>

The label element specifies that the structured document tag with an identifier value of 6 uses the contents of the structured document tag with an identifier value of 5 as a label source. In this example, the label contents are “Name”. end example]

Attributes

val (Decimal Number Value)

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

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

[Example: Consider the following numeric WordprocessingML property of simple type ST_DecimalNumber:

  <… w:val="1512645511" />

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_DecimalNumber simple type (17.18.10).

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