topichead

The <topichead> element provides a title-only entry in a navigation map, as an alternative to the fully-linked title provided by the <topicref> element.

Contains

( (topicmeta) (optional) then (topicref or (topichead or topicgroup) or navref or anchor) (any number) )

Contained by

map, topicref, relcell, topichead, topicgroup

Inheritance

map/topicref, mapgroup-d/topichead

Attributes

Name Description Data Type Default Value Required?
navtitle Specifies the title of the topic as it will appear in navigation or tables of contents generated from the map. CDATA #IMPLIED No
id This ID is the target for references by conref attributes, to allow build-time integration of maps. ID #IMPLIED No
conref References an equivalent element in the same map or another map, which will be copied into the current element's location when the conref is resolved. The syntax uses the target's file name and element ID; it does not require the map ID for scoping since there is only ever one map per target file:
Local target:
  conref="#elementID"
In different file:
  conref="othermap.ditamap#elementID"
CDATA #IMPLIED No
%topicref-atts; (collection-type, type, scope, locktitle, format, linking, toc, print, search, chunk) A set of related attributes. See %topicref-atts;. parameter entity PE not applicable Not applicable
%select-atts; (platform, product, audience, otherprops, importance, rev, status) A set of related attributes, described at %select-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 A common attribute described in Other common DITA attributes

Example

The following markup, for HTML Help output, will produce a book icon that expands into a nested set when toggled.
<map title="DITA Reference">
 <topicref href="anchor.dita" type="topic"></topicref>
 <topicref href="apiname.dita" type="topic"></topicref>
 <topicref href="audience.dita" type="topic"></topicref>
 <topicref href="author.dita" type="topic"></topicref>
 <topichead navtitle="Parameter Entity elements">
  <topicref href="global-atts.dita" type="topic"></topicref>
  <topicref href="select-atts.dita" type="topic"></topicref>
  <topicref href="univ-atts.dita" type="topic"></topicref>
  <topicref href="topicref-atts.dita" type="topic"></topicref>
 </topichead>
</map>

OASIS DITA Language Specification v1.0 -- 09 May 2005
Copyright (c) OASIS Open 2005. All Rights Reserved.