video – video (NEW)

Permitted contents #

Transparent, with the following specific structure:

a src attribute, or one or more source elements followed by zero or more track elements, followed by flow content

or

a src attribute, or one or more source elements followed by zero or more track elements, followed by phrasing content

Permitted attributes #

global attributes & autoplay & preload & controls & loop & poster & height & width & audio & src

global attributes

Any attributes permitted globally.

autoplay = "autoplay" or "" (empty string) or empty #

Instructs the UA to automatically begin playback of the video as soon as it can do so without stopping.

preload = "none" or "metadata" or "auto" or "" (empty string) or empty #

Represents a hint to the UA about whether optimistic downloading of the video itself or its metadata is considered worthwhile.

"none": Hints to the UA that the user is not expected to need the video, or that minimizing unnecessary traffic is desirable.
"metadata": Hints to the UA that the user is not expected to need the video, but that fetching its metadata (dimensions, first frame, track list, duration, and so on) is desirable.
"auto": Hints to the UA that optimistically downloading the entire video is considered desirable.

Specifying the empty string is equivalent to specifying the value "auto".

controls = "controls" or "" (empty string) or empty #

Instructs the UA to expose a user interface for controlling playback of the video.

loop = "loop" or "" (empty string) or empty #

Instructs the UA to seek back to the start of the video upon reaching the end.

poster = Non-empty URL potentially surrounded by spaces #

The address of an image file for the UA to show while no video data is available.

height = non-negative integer #

The height of the video, in CSS pixels.

width = non-negative integer #

The width of the video, in CSS pixels.

audio = list of audio states #

Represents default states of the audio channel of the video, potentially overriding user preferences.

If any values are given in the list of audio states, they instruct the UA to set default audio states, as follows:

muted: instructs the UA to override the user’s preferences, if any, and always default the initial audio mutedness state to muted

src = Non-empty URL potentially surrounded by spaces #

The URL for the video.

Additional constraints and admonitions #

The interactive element video with the attribute controls must not appear as a descendant of the a element.
The interactive element video with the attribute controls must not appear as a descendant of the button element.

Tag omission #

A video element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements, any element that can contain flow elements

DOM interface #

interface HTMLVideoElement : HTMLMediaElement {
           attribute unsigned long width;
           attribute unsigned long height;
  readonly attribute unsigned long videoWidth;
  readonly attribute unsigned long videoHeight;
           attribute DOMString poster;
  [PutForwards=value attribute DOMSettableTokenList audio; 
};

HTML: The Markup Language Reference

video – video NEW # T