17.9.3 ilvl

This element specifies the numbering level of the numbering definition instance which shall be applied to the parent paragraph.

This numbering level is specified on either the abstract numbering definition’s lvl element (17.9.6), and can be overridden by a numbering definition instance level override’s lvl element (17.9.5).

[Example: Consider the following numbered paragraphs in a WordprocessingML document:

• 1. Level one

a. Level two

These numbered paragraphs might be represented using the following WordprocessingML:

<w:p>
  <w:pPr>
    <w:numPr>
      <w:ilvl w:val="0" />
      <w:numId w:val="5" />
    </w:numPr>
  </w:pPr>
  <w:r>
    <w:t>Level one</w:t>
  </w:r>
</w:p>
<w:p>
  <w:pPr>
    <w:numPr>
      <w:ilvl w:val="1" />
      <w:numId w:val="5" />
    </w:numPr>
  </w:pPr>
  <w:r>
    <w:t>Level two</w:t>
  </w:r>
</w:p>

The WordprocessingML above specifies that the first numbered paragraph references the numbering level of 0, within the numbering definition of the num element (17.9.15) with a numId attribute equal to 5.

The second numbered paragraph references the numbering of 1, within the same numbering definition instance. The WordprocessingML referenced by the ilvl elements above is given below:

<w:num w:numId="5">
  <w:abstractNumId w:val="0" />
</w:num>
…
<w:abstractNum w:abstractNumId="0">
  <w:nsid w:val="FFFFFF7F" />
  <w:multiLevelType w:val="singleLevel" />
  <w:lvl w:ilvl="0">
    …
  </w:lvl>
  <w:lvl w:ilvl="1">
    …
  </w:lvl>
</w:abstractNum>

In this case, the resulting paragraphs would inherit the properties of the abstract numbering definition levels with ilvl attributes of 0 and 1, respectively. 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]