textobject — A wrapper for a text description of an object and its associated meta-information
textobject ::=
info
? (db.titleforbidden.info)address
anchor
annotation
bibliolist
blockquote
bridgehead
calloutlist
caution
classsynopsis
cmdsynopsis
constraintdef
constructorsynopsis
destructorsynopsis
epigraph
equation
example
fieldsynopsis
figure
formalpara
funcsynopsis
glosslist
html:form
important
indexterm
(db.indexterm.endofrange)indexterm
(db.indexterm.singular)indexterm
(db.indexterm.startofrange)informalequation
informalexample
informalfigure
informaltable
(db.cals.informaltable)informaltable
(db.html.informaltable)itemizedlist
literallayout
mediaobject
methodsynopsis
msgset
note
orderedlist
para
procedure
productionset
programlisting
programlistingco
qandaset
remark
revhistory
screen
screenco
screenshot
segmentedlist
sidebar
simpara
simplelist
synopsis
table
(db.cals.table)table
(db.html.table)task
tip
variablelist
warning
phrase
(db.phrase)textdata
A TextObject
is a wrapper containing a textual description
of a media object, and its associated meta-information.
TextObject
s are only allowed in MediaObject
s as
a fall-back option, they cannot be the primary content.
There are two different forms of TextObject
, and it is
not unreasonable for a media object to contain both of them.
In the first form, the content of a TextObject
is
simply a Phrase
. This form is a mechanism for providing a
simple “alt text” for a media object. The phrase might be
used, for example, as the value of the
alt
attribute on an HTML
img,
with the primary content of the image coming from one
of the other objects in the media object.
In the second form, the content of TextObject
is a longer,
prose description. This form could be used when rendering to devices
that are incapable of displaying any of the other alternatives.
May be formatted inline or as a displayed block, depending on context.
It might not be rendered at all, depending on its placement
within a MediaObject
or InlineMediaObject
and
the constraints on the publishing system. For a more detailed description
of the semantics involved, see MediaObject
.
These elements contain textobject
: classsynopsisinfo
, funcsynopsisinfo
, informaltable
(db.cals.informaltable), inlinemediaobject
, literallayout
, mediaobject
, programlisting
, screen
, synopsis
, table
(db.cals.table).
The following elements occur in textobject: address
, anchor
, annotation
, bibliolist
, blockquote
, bridgehead
, calloutlist
, caution
, classsynopsis
, cmdsynopsis
, constraintdef
, constructorsynopsis
, destructorsynopsis
, epigraph
, equation
, example
, fieldsynopsis
, figure
, formalpara
, funcsynopsis
, glosslist
, html:form
, important
, indexterm
(db.indexterm.endofrange), indexterm
(db.indexterm.singular), indexterm
(db.indexterm.startofrange), info
(db.titleforbidden.info), informalequation
, informalexample
, informalfigure
, informaltable
(db.cals.informaltable), informaltable
(db.html.informaltable), itemizedlist
, literallayout
, mediaobject
, methodsynopsis
, msgset
, note
, orderedlist
, para
, phrase
(db.phrase), procedure
, productionset
, programlisting
, programlistingco
, qandaset
, remark
, revhistory
, screen
, screenco
, screenshot
, segmentedlist
, sidebar
, simpara
, simplelist
, synopsis
, table
(db.cals.table), table
(db.html.table), task
, textdata
, tip
, variablelist
, warning
.