The <div> element is designed to be a grouping element; it does not imply any explicit semantics or contain an explicit title. This avoids enabling the creation of deeply-nested content that would otherwise be written as separate topics. If the content requires a title, use a <section> element, a nested <topic>, or possibly a <fig> element.
See appendix for information about this element in OASIS document type shells.
Using <div> for grouping
In the following example, a <div> element is used to organize several elements together so that they can be referenced by @conref or @conkeyref:
... <div id="div-01"> <p>The first paragraph</p> <p>The second paragraph</p> <note>This is a note</note> </div> ...
Without using a <div> element, the content could not be grouped for content referencing since the start and end elements are of different types.
Using <div> for specialization
In the following example, <div> is used as the basis for specializing a new domain element, <pullquote>:
<!ENTITY % pullquote.content "(%div.cnt;)*" > <!ENTITY % pullquote.attributes "%univ-atts; outputclass CDATA #IMPLIED" > <!ELEMENT pullquote %pullquote.content;> <!ATTLIST pullquote %pullquote.attributes;> <!ATTLIST pullquote %global-atts; class CDATA "+ topic/div pubcontent-d/pullquote ">
Instances of <pullquote> could then be used in both <body> and <section> contexts:
<topic id="article-01"> <title>My Article</title> <body> <p>Something pithy someone said</p> <pullquote><p>Something Pithy</p></pullquote> <!-- ... --> <section spectitle="Deep Dive"> <p>This is really really pithy</p> <pullquote><p>Really Pithy</p></pullquote> <!-- ... --> </section> </body> </topic>