navref

The <navref> element references a map file from within a map file. The reference is resolved at runtime for Eclipse navigation, typically to pull together the navigation for multiple components into a product navigation. This element is for runtime resolution of references, and is for navigation only. It is currently only supported by Eclipse output.

For build-time integration, you can use the conref attribute on an element inside the map (for example, a topicref) to pull in content from a matching element (for example, another topicref) in another map.

Contains

no content

Contained by

map, topicref, topichead, topicgroup

Inheritance

map/navref

Attributes

Name	Description	Data Type	Default Value	Required?
mapref	Specifies the URL (local filename, at least) of the map file to reference. This element is for runtime resolution of references, and is for navigation only. It is currently only supported by Eclipse output.	CDATA	#IMPLIED	No
%global-atts; (xtrf, xtrc)	A set of related attributes, described at %global-atts;	parameter entity	PE not applicable	Not applicable
class	A common attribute described in Other common DITA attributes

Example

In this example, the map titled "MyComponent tasks" references the maps "othermap2.ditamap" and "othermap3.ditamap".

<map title="MyComponent tasks">
<navref mapref="../com.ibm.xml.doc/othermap1.ditamap"/>
<navref mapref="../com.ibm.xml.doc/othermap2.ditamap"/>
</topicref>
</map>