The text element associates no semantics with its content.
It exists to serve as a container for text where a container is needed
(e.g., for conref, or for restricted content models in specializations).
Unlike ph, text cannot contain images. Unlike keyword, text does not
imply keyword-like semantics. The text element contains only text
data, or nested text elements. All universal attributes are available
on text.
For contexts where ph is available, authors should use that
element. Where keyword is available, authors should use that element.
Where neither ph nor keyword is available, text can be used to pull
content by conref.
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, map, concept, ditabase, glossary, glossentry, glossgroup, reference, task, bookmap, classifyMap, subjectScheme, machineryTask, learningAssessment, learningBookmap, learningContent, learningMap, learningOverview, learningPlan, learningSummary |
( text data or text) (any number) |
Contained by
Doctype |
Content model |
topic (base), map (base), classifyMap, subjectScheme, learningBookmap, learningMap |
text, keyword, term, ph, tm, shape |
topic (technical content), map (technical content), concept, ditabase, glossary, glossentry, glossgroup, reference, task (strict), task (general), bookmap |
text, keyword, term, ph, tm, shape, wintitle, shortcut, option, parmname, synph, apiname, kwd, msgnum, cmdname, varname |
machineryTask |
text, keyword, term, ph, tm, shape, wintitle, shortcut |
learningAssessment, learningContent, learningOverview, learningPlan, learningSummary |
text, keyword, term, ph, tm, shape, lcAreaShape |
Example
<p>This an example of <keyword><text id="reuse">Text
that is reusable</text></keyword>, with no extra
semantics attached to the text when it is reused.</p>
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 |
A common attribute described in
Other common DITA attributes |
|
|
|