<topicgroup>
The <topicgroup> element groups <topicref>
elements for common treatment without affecting the structural hierarchy of the map, as opposed
to nesting <topicref> elements, which does imply a structural hierarchy.
The <topicgroup> element can provide linking relationships and shared,
inherited attributes to the set of elements that it contains without affecting the resulting
table of contents or navigation.
<navtitle>
element within the <topicmeta> element inside of a
<topicgroup>. The <topicgroup> element is
meant as a non-titled grouping element, so adding a <navtitle> element
to the <topicgroup> element has no defined purpose, and processors
MUST ignore the title. Processors
MAY issue a message when ignoring the
title.Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
+ map/topicref mapgroup-d/topicgroup
Example
Each <topicref> element in the following example inherits the
@audience and @linking attributes. In this way the common
attributes are set for the entire 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>Attributes
The following attributes are available on this element: Universal attribute group, Attributes common to many map elements, and outputclass. Although
@locktitle is available as part of
Attributes common to many map elements, it has no defined purpose for this element.
The @scope, @format, and @type attributes
from Link relationship attribute group are also available.