jump

HTML 5: The Markup Language (ARIA Edition)

videovideo NEW # T

The video element represents a video or movie.

Permitted contents #

Transparent, with the following specific structure:

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

or

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

Permitted attributes #

global attributes
Any attributes permitted globally.
autoplay = d:string "autoplay" or d:string "" #
Instructs the UA to automatically begin playback of the video as soon as it can do so without stopping.
preload = d:string "none" or d:string "metadata" or d:string "auto" or d:string "" #
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 = d:string "controls" or d:string "" #
Instructs the UA to expose a user interface for controlling playback of the video.
loop = d:string "loop" or d:string "" #
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.
mediagroup = string #
Instructs the UA to link multiple videos and/or audio streams together.
muted = d:string "muted" or d:string "" #
Represents the default state of the audio channel of the video, potentially overriding user preferences.
src = non-empty URL potentially surrounded by spaces #
The URL for the video.

Additional constraints and admonitions #

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;
};