<media>

Media Object

Description of and pointer to an external file that holds a media object (for example, an animation, an audio file, or a movie).

Remarks

Media Content: The “content” of the <media> element is not the media object itself, but information concerning the object. The external file that contains the object is named by the @xlink:href attribute.
Media Placement: The @position attribute may be used to indicate whether this element must be anchored at its exact location within the text or whether it may float, but Best Practice is to anchor graphics and media objects. The few media objects that occur within the narrative text should be anchored in place, and all the media objects inside figures, tables, etc., should be anchored as well, although the outer structure (figure, boxed text) may be allowed to float.
Best Practice Usage: Display component elements, such as <caption>, should always be used at the highest possible level; in other words, if a <media> element is inside a <fig>, the <caption>, <long-desc>, etc., should be part of the <fig>, not part of the <media>. Use a <caption> element on a <media> only when the media object is not enclosed in any other structure or when a figure contains multiple media objects, each of which must have its own <caption>. For similar reasons, the @position attribute should be set to “anchor” for a <media> element that is inside a larger display container such as a <fig>.
When Content is a Form: The @is-form attribute can be used to indicate that the media object contains a form. What constitutes a “form” is not defined by NISO STS.

Related Elements

The NISO STS Tag Sets contain several elements that describe and point to non-XML material: <graphic>, <inline-graphic>, <media>, <supplementary-material>, and <inline-supplementary-material>. The elements <graphic> and <inline-graphic> contain a pointer to a still image (such as a photograph, diagram, line drawing, etc.) that is part of the document. The element <media> contains a pointer to a non-XML, frequently binary, object (such as a movie, audio clip, dataset, or other non-XML format) that is integral to the document’s content, where “integral” means that the media object is discussed within (and possibly displayed within) the document; the media object is part of the document.
In contrast, the elements <supplementary-material> and <inline-supplementary-material> are used to describe either XML material (such as figures, tables, and sections) or non-XML material (such as graphics, films, audio clips, datasets, or other material) that are considered to be “additional material” (non-integral) accompanying a document. Like <graphic>, <inline-graphic>, and <media>, the supplementary material elements never contain the object they describe, even if it is an XML object such as a figure, although they may point to it.

Attributes

content-type Type of Content
form-type Form Type
id Document Internal Identifier
is-form Is Object a Form
mime-subtype Mime Subtype
mimetype Mime Type
orientation Orientation
originator Originator
position Position
specific-use Specific Use
xlink:actuate Actuating the XLink Link
xlink:href Href (XLink Linking Mechanism)
xlink:role XLink Linking Role
xlink:show Showing the XLink Link
xlink:title Title of the XLink Link
xlink:type Type of XLink Link
xml:base Base
xml:lang Language of an Element
xmlns:xlink XLink Namespace Declaration

Model Description

Any combination of:

This element may be contained in:

<ack>, <alternatives>, <app>, <app-group>, <array>, <bio>, <body>, <boxed-text>, <chem-struct>, <chem-struct-wrap>, <disp-formula>, <disp-quote>, <fig>, <fig-group>, <glossary>, <index>, <index-div>, <index-group>, <license-p>, <named-content>, <non-normative-example>, <non-normative-note>, <normative-example>, <normative-note>, <notes>, <p>, <ref-list>, <sec>, <see>, <see-also>, <see-also-entry>, <see-entry>, <sig>, <sig-block>, <styled-content>, <supplementary-material>, <table-wrap>, <td>, <term>, <term-display>, <term-sec>, <th>

NISO STS 1.0 Tag Suite Components

Version of October 2017

Back to Top