<topicset>

The <topicset> element defines a complete unit of content that can be reused in other DITA maps or other <topicset> elements. Unlike the base <topicref> element, the <topicset> is explicitly intended to define a set of topics that are often or always used as a unit; it can be especially useful for task composition in which larger tasks are composed of smaller tasks. The @id attribute on a <topicset> is required, which ensures that the complete unit is available for reuse in other contexts.

A <topicset> is similar to a source file that contains nested topics, in that the combination of topics constitutes a complete self-contained unit. That unit of content can stand independently of the containing, prior, and following content within the original map context.

Content model

<topicmeta>?, (<anchor> | <data> | <data-about> | <navref> | <topicref>)*

Not contained by any element.

In order
  1. Optional <topicmeta>
  2. Zero or more of the following
    • <anchor>
    • <data>
    • <data-about>
    • <navref>
    • <topicref>

Not contained by any element.

Inheritance

+ map/topicref mapgroup-d/topicset

The <topicset> element is specialized from <topicref>. It is defined in the mapgroup-domain module.

Example

This section is non-normative.

This <topicset> represents a set of overview information about SQL. The information is reusable as a unit.

<topicset id="sqlbasics" href="sqlOverview.dita">
  <topicref href="sqlSelection.dita"/>
  <topicref href="sqlJoin.dita"/>
  <topicref href="sqlFilter.dita"/>
  <!-- ... -->
</topicset>

Attributes

The following attributes are available on this element: Universal attribute group (with a narrowed definition of @id, given below), Link relationship attribute group (with a narrowed definition of @href, given below), Attributes common to many map elements, Topicref element attributes group, outputclass, @keys, and @keyref.

@id (REQUIRED)
This ID is the target for references by to the current set of information. The ID is required in order to ensure that a <topicset> is defined as a reusable unit of information. See ID attribute for more details.
@href
A pointer to the resource represented by the <topicref>. See The href attribute for detailed information on supported values and processing implications. References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic. References to content other than DITA topics should use the @format attribute to identify the kind of resource being referenced.
@href
A pointer to the resource represented by the <topicref>. See The href attribute for detailed information on supported values and processing implications. References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic. References to content other than DITA topics should use the @format attribute to identify the kind of resource being referenced.
@id (REQUIRED)
This ID is the target for references by to the current set of information. The ID is required in order to ensure that a <topicset> is defined as a reusable unit of information. See ID attribute for more details.