[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
customXml (Block-Level Custom XML Element)
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 shall 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]
Parent Elements |
body (§2.2.2); comment (§2.13.4.2); customXml (§2.5.1.6); docPartBody (§2.12.6); endnote (§2.11.2); footnote (§2.11.10); ftr (§2.10.3); hdr (§2.10.4); sdtContent (§2.5.2.32); tc (§2.4.62); txbxContent (§2.17.1.1) |
Child Elements |
Subclause |
bookmarkEnd (Bookmark End) |
§2.13.6.1 |
bookmarkStart (Bookmark Start) |
§2.13.6.2 |
commentRangeEnd (Comment Anchor Range End) |
§2.13.4.3 |
commentRangeStart (Comment Anchor Range Start) |
§2.13.4.4 |
§2.5.1.6 | |
customXmlDelRangeEnd (Custom XML Markup Deletion End) |
§2.13.5.4 |
customXmlDelRangeStart (Custom XML Markup Deletion Start) |
§2.13.5.5 |
customXmlInsRangeEnd (Custom XML Markup Insertion End) |
§2.13.5.6 |
customXmlInsRangeStart (Custom XML Markup Insertion Start) |
§2.13.5.7 |
customXmlMoveFromRangeEnd (Custom XML Markup Move Source End) |
§2.13.5.8 |
customXmlMoveFromRangeStart (Custom XML Markup Move Source Start) |
§2.13.5.9 |
customXmlMoveToRangeEnd (Custom XML Markup Move Destination Location End) |
§2.13.5.10 |
customXmlMoveToRangeStart (Custom XML Markup Move Destination Location Start) |
§2.13.5.11 |
customXmlPr (Custom XML Element Properties) |
§2.5.1.7 |
§2.13.5.12 | |
§2.13.5.20 | |
§2.13.5.21 | |
moveFromRangeEnd (Move Source Location Container - End) |
§2.13.5.23 |
moveFromRangeStart (Move Source Location Container - Start) |
§2.13.5.24 |
§2.13.5.26 | |
moveToRangeEnd (Move Destination Location Container - End) |
§2.13.5.27 |
moveToRangeStart (Move Destination Location Container - Start) |
§2.13.5.28 |
oMath (Office Math) |
§7.1.2.77 |
oMathPara (Math Paragraph) |
§7.1.2.78 |
p (Paragraph) |
§2.3.1.22 |
permEnd (Range Permission End) |
§2.13.7.1 |
permStart (Range Permission Start) |
§2.13.7.2 |
proofErr (Proofing Error Anchor) |
§2.13.8.1 |
sdt (Block-Level Structured Document Tag) |
§2.5.2.30 |
tbl (Table) |
§2.4.36 |
Attributes |
Description |
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 shall have a name of companyName. This requirement would be specified using the following WordprocessingML:
<w:customXml w:element="companyName" … >
The element attribute specifies that the name for this element shall be companyName. end example]
The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
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 shall have a namespace URI of urn:customXmlExample. This requirement would be specified using the following WordprocessingML:
<w:customXml … w:uri="urn:customXmlExample" />
The uri attribute specifies that the namespace for this element shall be urn:customXmlExample. end example]
The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_CustomXmlBlock">
<sequence>
<element name="customXmlPr" type="CT_CustomXmlPr" minOccurs="0" maxOccurs="1"/>
<group ref="EG_ContentBlockContent" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="uri" type="ST_String"/>
<attribute name="element" type="ST_String" use="required"/>
</complexType>