The
caption
element represents a short explanation or description accompanying a component of a publication. Captions most often occur
in conjunction with illustrations, photographs, tables and diagrams.
The
ref
attribute identifies the component(s) to which the caption applies.
Usage Example
<object xml:id="mntsr" src="mnt_srmn.png"> … </object>
<caption ref="mntsr">MOUNT SARMIENTO.</caption>
Allowed parents
address,
annotation,
block,
body,
caption,
description,
item,
d:longdesc,
object,
quote,
section,
d:simplifiedLanguageDescription,
d:summary,
td,
th and
d:tour
Allowed children
This element may contain text.
This element may contain the following children: abbr,
address (block variant),
address (phrase variant),
annoref,
annotation (block variant),
annotation (phrase variant),
block,
caption,
citation (block variant),
citation (phrase variant),
code (block variant),
code (phrase variant),
definition,
description,
d:description,
emph (text variant),
emph (phrase variant),
expansion,
hd,
list,
ln,
name,
num,
object (block variant),
object (text variant),
object (phrase variant),
p,
quote (block variant),
quote (phrase variant),
ref,
its:ruby,
s,
span (text variant),
span (phrase variant),
sub,
sup,
table,
term,
time and
w
Content model and additional requirements
optional attributes:
@about,
@by,
@class,
@content,
@continuation,
@datatype,
@desc,
@its:dir,
@its:translate,
@property,
@ref,
@rel,
@resource,
@rev,
@role,
@typeof,
@xml:base,
@xml:id,
@xml:lang and
@xml:space
a choice of
either
one or more of
any of the 14 elements:
address,
annotation,
block,
caption,
citation,
code,
d:description,
description,
hd,
list,
object,
p,
quote and
table
or
one or more of
a choice of either one of the 27 elements:
abbr,
address,
annoref,
annotation,
citation,
code,
definition,
emph,
emph,
expansion,
its:ruby,
ln,
name,
num,
object,
object,
quote,
ref,
s,
span,
span,
sub,
sup,
term,
time,
w or
w
or text
end of choice
end of choice
Note that in addition to restrictions presented in the content model above,
use of this element must also respect the following requirements:
- The
caption
element must not contain child
caption
elements.
- The
caption
element must neither be empty nor contain only whitespace.
Such requirements take precedence over any conflicting statements in the
content model or in the lists above of allowed children and parents.
Namespace
http://www.daisy.org/ns/z3998/authoring/