This element is intended to delimit properly-nested regions in the flow of text. At present, the only attribute it has is the media attribute, but it might be extended with a more general `class' attribute at some point.
Note the place of this element in the element hierarchy. It can include all the elements which are permitted inside a paragraph, such as verbatim or dl and the like, but it cannot be included within any of these in-paragraph elements.
( #pcdata
|
em |
strong |
quote |
code |
kbd |
cite |
m |
angle |
foreign |
ref |
docxref |
webref |
url |
citation |
coderef |
mequation |
meqnarray |
blockquote |
dl |
ul |
ol |
verbatim |
linespecific |
span |
update |
tabular |
index |
note |
draftnote) *
span |_(#PCDATA | |__em | |__strong | |__quote | |__code | |__kbd | |__cite | |__m | |__angle | |__foreign | |__ref | |__docxref | |__webref | |__url | |__citation | |__coderef | |__mequation | |__meqnarray | |__blockquote | |__dl | |__ul | |__ol | |__verbatim | |__linespecific | |__span | ... |__update | |__tabular | |__index | |__note | |__draftnote)*
This attribute specifies the media type or types for which the element's content should be included in the output. If the attribute is missing, then the element content is included.
If the attribute is specified, than it shall be a list of media types separated by commas, each of which is optionally followed by a parameter string, separated from the media type by whitespace. The grammar is therefore:
(where `media-spec-list = media-spec ( ',' media-spec )* media-spec = S* media-type S* | S* media-type S+ parameter-list media-type = [A-Za-z0-9-]+ parameter-list = [^,]+
S
' is whitespace). At present, the
parameter-list is ignored, and the only media-types recognised
(case-sensitively) are (quoting from the HTML4 spec):
screen
tty
print
all
screen
is for
producing HTML, print
for producing printed
documentation, and tty
for HLP files.
Unrecognised media-types are permitted, but ignored.The element content is included in the output document if:
all
.screen
.For example, if a document had a span element of the form Example:
then this would resolve to the three media types<span media="screen, 3d-glasses, print and resolution > 90dpi" >Blah blah blah<span>
screen
,
3d-glasses
and print
, and the content `Blah
blah blah' would be included by the HTML and print down-converters.