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.
Note: These models represent only the default document types distributed by OASIS. Actual content models will differ with each new document type.
|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|
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>
|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|