anchor

The <anchor> element is used for runtime integration of navigation. It provides an integration point that another map can point to in order to insert its navigation into the current navigation tree. For those familiar with Eclipse help systems, this serves the same purpose as the <anchor> element in that system. It may not be supported for all output formats.

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.

Example

In this example, an anchor is defined with an ID of "a1". This ID can be referenced by the anchorref attribute on another map's map element.

<map title="MyComponent tasks">
 <topicref navtitle="Start here" href="start.dita" toc="yes">
  <navref mapref="othermap2.ditamap"/>
  <navref mapref="othermap3.ditamap"/>
  <anchor id="a1"/>
 </topicref>
</map>

Contains

Doctype	Content model
map, bookmap	no content

Contained by

Doctype	Parents
bookmap, map	map, topicref, topichead, topicgroup

Inheritance:

- map/anchor

Attributes

Name	Description	Data Type	Default Value	Required?
id	An anchor point. This ID is the target for references by href and conref attributes, and for external applications that refer to DITA content.	NMTOKEN	#IMPLIED	No
conref	This attribute is used to reference an ID on content that can be reused. See The conref attribute for examples and details about the syntax.	CDATA	#IMPLIED	No
%select-atts; (props, base, platform, product, audience, otherprops, importance, rev, status)	A set of related attributes, described at %select-atts;	parameter entity	PE not applicable	Not applicable
%localization-atts; (translate, xml:lang, dir)	A set of related attributes, described at %localization-atts;.	parameter entity	PE not applicable	Not applicable
%global-atts; (xtrf, xtrc)	A set of related attributes, described at %global-atts;	parameter entity	PE not applicable	Not applicable
class, outputclass	Common attributes described in Other common DITA attributes.