17.5.1.6 customXml

This element specifies the presence of a custom XML element around one or more block level structures (paragraphs, tables, etc.). The attributes on this element shall be used to specify the name and namespace URI of the current custom XML element.

[Example: Consider a custom XML element with the name address that must be located around a single paragraph in a WordprocessingML document. This requirement would be specified as follows in the WordprocessingML:

<w:body>
  <w:customXml w:element="address" … >
    <w:p>
      …
    </w:p>
  </w:customXml>
  …
</w:body>

The customXml element specifies that the name of the custom XML element is address, and the custom XML element contains a single paragraph (it is a block-level element). end example]

Attributes

element (Custom XML Element Name)

Specifies the name of the current custom XML element or smart tag within the document.

[Example: Consider a custom XML element which must have a name of companyName. This requirement would be specified using the following WordprocessingML:

  <w:customXml w:element="companyName" … >
    …
  </w:customXml>

The element attribute specifies that the name for this element must be companyName. end example]

The possible values for this attribute are defined by the ST_XmlName simple type (22.9.2.21).

uri (Custom XML Element Namespace)

Specifies the namespace URI of the current custom XML element or smart tag.

If this attribute is omitted, the URI shall be assumed to be null (no associated URI).

[Example: Consider a custom XML element which must have a namespace URI of WordprocessingML:

  <w:customXml … w:uri="urn:customXmlExample" >
    …
  </w:customXml>

The uri attribute specifies that the namespace for this element must be

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_CustomXmlBlock) is located in A.1. end note]