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 Provides an integration point that another map may reference in order to insert its navigation into the current navigation tree. The anchorref attribute on a map may be used to reference this attribute. NMTOKEN #REQUIRED Yes
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