The conref attribute

This attribute is used to reference content that can be reused. It allows reuse of DITA elements, including topic or map level elements.

The value of the conref attribute must be a URI reference to a DITA element. See URI-based (direct) addressing for details on specifying URI references to DITA elements. As with other DITA references, a conref attribute that references a resource without an ID is treated as a reference to the first topic or map in the document.

Note: When using the conref attribute on an element, the content of that element is ignored. For example, if a phrase is marked up like this:

<ph conref="#topic/ph">Something</ph>

the word "Something" will be replaced by the content of the referenced <ph> element.

3.4.2.4.1 Using the -dita-use-conref-target value
The value -dita-use-conref-target is available on enumerated attributes and may also be specified on other attributes. When an element uses conref to pull in content, for any of its attributes assigned a value of "-dita-use-conref-target", the resulting value for those attributes should also be pulled in from the referenced element.

Parent topic: 3.4.2 Complex attribute definitions

Previous topic: 3.4.2.3 The keyref attribute

Next topic: 3.4.2.4.1 Using the -dita-use-conref-target value

Related concepts

2.1.3.5 Content inclusion (conref)

Return to main page.

3.4.2.4 The conref attribute