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.
See appendix for information about this element in OASIS document type shells.
+ map/topicref mapgroup-d/topicgroup
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>
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.