DITA Resource Center

text

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

Inheritance

- topic/text

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

Was this page helpful?