<media>

Media Object

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

Remarks

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.

Position: 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 float loose in text should be anchored there, 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.

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>.

Attributes

content-type Type of Content
id Identifier
mime-subtype Mime Subtype
mimetype Mime Type
orientation Orientation
position Position
specific-use Specific Use
xlink:actuate Actuating the Link
xlink:href Href (Linking Mechanism)
xlink:role Role of the Link
xlink:show Showing the Link
xlink:title Title of the Link
xlink:type Type of Link
xmlns:xlink XLink Namespace Declaration
xml:lang Language

Related Elements

This Suite contains several elements to describe non-XML material: <graphic>, <inline-graphic>, <media>, and <supplementary-material>. The elements <graphic> and <inline-graphic> are used for still images, i.e., photographs, diagrams, etc. The distinction between the two other elements is more subtle. The element <media> should be used for movies, audio clips, or media in other formats which is intrinsic to the document’s content, that is, the media object is discussed within the document. The element <supplementary-material> should be used for films, audio clips, or other material which enhances a document, but which is not discussed as part of the document.

Best Practice: Unlabeled media objects should be tagged as <media>s, not as <fig>s. A common test to determine whether an object is a <fig> versus a <media> is to ask, “If there were a “List of Figures” for this article, should this object appear in that list?”

Content Model

<!ELEMENT  media        %media-model;                                >

Expanded Content Model

(alt-text | long-desc | email | ext-link | uri | object-id | label | caption | attrib | permissions)*

Description

Any combination of:

This element may be contained in:

<alternatives>, <app>, <app-group>, <array>, <bio>, <body>, <boxed-text>, <chem-struct>, <chem-struct-wrap>, <disp-formula>, <disp-quote>, <fig>, <fig-group>, <floats-group>, <glossary>, <license-p>, <named-content>, <notes>, <p>, <ref-list>, <sec>, <sig>, <sig-block>, <styled-content>, <supplementary-material>, <table-wrap>, <td>, <term>, <th>

Example

No sample is available at this time.
 

Module

JATS-display1.ent