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.
Doctype |
Content model |
topic (base) |
( text data or dl or fig or imagemap or image or lines or lq or note or hazardstatement or object or ol or p or pre or simpletable or sl or table or ul or boolean or cite or keyword or ph or b or i or sup or sub or tt or u or q or term or tm or xref or state or data or data-about or foreign or unknown or draft-comment or fn or indextermref or indexterm or required-cleanup or sectiondiv) (any number) |
topic (technical content), concept, ditabase, glossary, glossentry, glossgroup, reference, task |
( text data or dl or parml or fig or syntaxdiagram or imagemap or image or lines or lq or note or hazardstatement or object or ol or p or pre or codeblock or msgblock or screen or simpletable or sl or table or ul or boolean or cite or keyword or apiname or option or parmname or cmdname or msgnum or varname or wintitle or ph or b or i or sup or sub or tt or u or codeph or synph or filepath or msgph or systemoutput or userinput or menucascade or uicontrol or q or term or abbreviated-form or tm or xref or state or data or data-about or foreign or unknown or draft-comment or fn or indextermref or indexterm or required-cleanup or sectiondiv) (any number) |
machineryTask |
( text data or dl or fig or imagemap or image or lines or lq or note or hazardstatement or object or ol or p or pre or screen or simpletable or sl or table or ul or boolean or cite or keyword or wintitle or ph or b or i or sup or sub or tt or u or menucascade or uicontrol or q or term or tm or xref or state or data or data-about or foreign or unknown or draft-comment or fn or indextermref or indexterm or required-cleanup or sectiondiv) (any number) |
learningAssessment, learningContent, learningOverview, learningPlan, learningSummary |
( text data or dl or fig or imagemap or lcInteractionBase or lcTrueFalse or lcSingleSelect or lcMultipleSelect or lcSequencing or lcMatching or lcHotspot or lcOpenQuestion or image or lines or lq or note or lcInstructornote or object or ol or p or pre or simpletable or sl or table or ul or boolean or cite or keyword or ph or b or i or sup or sub or tt or u or q or term or tm or xref or state or data or data-about or foreign or unknown or draft-comment or fn or indextermref or indexterm or required-cleanup or sectiondiv) (any number) |
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>