17.4.18 header

This element specifies a reference, using a unique identifier, to a table header cell that is associated with the current table cell. The identifier representing the reference shall be stored on this element’s val attribute and is used to reference the unique identifier value of the id attribute of a header cell tc element of the current table. The contents of the table header cell tc element designated by the specific unique identifier in its id attribute shall be used as the table header information associated with the table cell that references that specific unique identifier.

If this element is omitted or the value of the header cell identifier cannot be resolved, no header cell shall be associated with the current table cell.

[Example: Consider the following 3 x 3 table with four header cells with values A, B, C, and D and four data cells with values x1, x2, y1, and y2:

A

B

C

x1

x2

D y1 y2 Each of the data cells is associated with two header cells and can be represented in WordprocessingML as follows:

<w:tbl>
  …
  <w:tr>
    …
    <w:tc >
      …
    </w:tc>
    <w:tc w:id="HeaderA">
      …
      <w:p>
        <w:r>
          <w:t>A</w:t>
        </w:r>
      </w:p>
    </w:tc>
    …
  </w:tr>
  <w:tr>
    …
    <w:tc w:id="HeaderC">
      …
      <w:p>
        <w:r>
          <w:t>C</w:t>
        </w:r>
      </w:p>
    </w:tc>
    <w:tc>
      <w:tcPr>
        …
        <w:headers>
          <w:header w:val="HeaderA" />
          <w:header w:val="HeaderC" />
        </w:headers>
        …
      </w:tcPr>
      <w:p>
        <w:r>
          <w:t>x1</w:t>
        </w:r>
      </w:p>
    </w:tc>
    …
  </w:tr>
</w:tbl>

The headers element specifies the list of header cells associated with the table cell that has a value of x1. In this example the table cell with the content value of x1 is associated with headers that have an id of HeaderA and HeaderC. end example]

Attributes

val (String Value)

Specifies that its contents contain a string.

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

[Example: Consider the following WordprocessingML fragment:

  <w:pPr>
    <w:pStyle w:val="Heading1" />
  </w:pPr>

The value of the val attribute is the ID of the associated paragraph style’s styleId.

However, consider the following fragment:

  <w:sdtPr>
    <w:alias w:val="SDT Title Example" />
    …
  </w:sdtPr>

In this case, the decimal number in the val attribute is the caption of the nearest ancestor structured document tag. In each case, the value is interpreted in the context of the parent element. end example]

The possible values for this attribute are defined by the ST_String simple type (22.9.2.13).

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