$Revision: 1666 $
$Date: 2002-06-12 07:19:37 -0400 (Wed, 12 Jun 2002) $
textobject — A wrapper for a text description of an object and its associated meta-information
textobject ::= (objectinfo
?, (phrase
|textdata
| (calloutlist
|glosslist
|bibliolist
|itemizedlist
|orderedlist
|segmentedlist
|simplelist
|variablelist
|caution
|important
|note
|tip
|warning
|literallayout
|programlisting
|programlistingco
|screen
|screenco
|screenshot
|formalpara
|para
|simpara
|blockquote
)+))
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
, inlinemediaobject
, literallayout
, mediaobject
, mediaobjectco
, programlisting
, screen
, synopsis
, table
.
The following elements occur in textobject:
bibliolist
, blockquote
, calloutlist
, caution
, formalpara
, glosslist
, important
, itemizedlist
, literallayout
, note
, objectinfo
, orderedlist
, para
, phrase
, programlisting
, programlistingco
, screen
, screenco
, screenshot
, segmentedlist
, simpara
, simplelist
, textdata
, tip
, variablelist
, warning
.
alt
, audioobject
, caption
, graphic
, imageobject
, inlinegraphic
, inlinemediaobject
, mediaobject
, videoobject
.