The <sectiondiv> element allows logical grouping of content within a section. There is no additional meaning associated with the sectiondiv element, aside from its function as a container for other content. The sectiondiv element does not contain a title; the lowest level of titled content within a topic is the section itself. If additional hierarchy is required, nested topics should be used in place of the section.
The sectiondiv element nests itself, which
means that it will often be used by specializers to create structured
information within sections. Another common use case for the sectiondiv
element is to group a sequence of related elements for reuse, so that
another topic may reference the entire set with a single conref attribute.
Contains
Note: These models represent only the default document types distributed by OASIS.
Actual content models will differ with each new document type.
Contained by
Doctype | Content model |
---|---|
topic (base), topic (technical content), concept, glossary, glossentry, glossgroup | section, sectiondiv |
ditabase | section, sectiondiv, prereq, context, steps-informal, result, postreq, refsyn |
reference | section, sectiondiv, refsyn |
task (strict), task (general), machineryTask | section, sectiondiv, prereq, context, steps-informal, result, postreq |
learningAssessment, learningOverview, learningPlan, learningSummary | section, sectiondiv, lcIntro, lcAudience, lcPrereqs, lcSummary, lcNextSteps, lcReview, lcResources, lcChallenge, lcInstruction |
learningContent | section, sectiondiv, lcIntro, lcAudience, lcPrereqs, lcSummary, lcNextSteps, lcReview, lcResources, lcChallenge, lcInstruction, prereq, context, steps-informal, result, postreq, refsyn |
Inheritance
- topic/sectiondiv
Example
In the example below, the sectiondiv element is used to group content that may be reused in other situations.
<section> <title>Nice pets</title> <sectiondiv id="smallpets"> <p>Cats are nice.</p> <p>Dogs are nice.</p> <p>Friends of mine really love their hedgehogs.</p> </sectiondiv> <sectiondiv id="biggerpets"> <p>Lots of people want ponies when they grow up.</p> <p>Llamas are also popular.</p> </sectiondiv> </section>
Attributes
Name | Description | Data Type | Default Value | Required? |
---|---|---|---|---|
univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups) | A set of related attributes, described in univ-atts attribute group | |||
global-atts attribute group (xtrf, xtrc) | A set of related attributes, described in global-atts attribute group | |||
class, outputclass | Common attributes described in Other common DITA attributes |