topicgroup

The <topicgroup> element is for creating groups of <topicref> elements without affecting the hierarchy, as opposed to nested <topicref> elements within a <topicref>, which does imply a structural hierarchy. It is typically used outside a hierarchy to identify groups for linking without affecting the resulting toc/navigation output.

In the following example, each of the topicref elements inherit the audience and linking attribute values. This way the attributes can be set in one place for a group of topicref elements, without affecting the navigation hierarchy.

<topicgroup audience="novice" linking="none">
  <topicref href="this.dita"/>
  <topicref href="that.dita"/>
  <topicref href="theother.dita"/>
</topicgroup>

Contains

Doctype Content model
map ( ( topicmeta) (optional) then ( topicref or topichead or topicgroup or navref or anchor or data or data-about) (any number) )
bookmap ( ( topicmeta) (optional) then ( topicref or topichead or topicgroup or navref or anchor or data or data-about) (any number) )

Contained by

Doctype Parents
bookmap map, topicref, relcell, frontmatter, backmatter, draftintro, preface, chapter, part, appendix, notices, glossarylist, topichead, topicgroup
map map, topicref, relcell, topichead, topicgroup

Inheritance:

+ map/topicref mapgroup-d/topicgroup

Attributes

Name Description Data Type Default Value Required?
%topicref-atts; (collection-type, type, scope, locktitle, format, linking, toc, print, search, chunk) A set of related attributes. See %topicref-atts; and %topicref-atts-no-toc;. parameter entity PE not applicable Not applicable
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;) A set of related attributes, described at %univ-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