HTML: The Markup Language

videovideo NEW # T

The video element represents a video or movie.

Permitted content #

Transparent, with the following specific structure:

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

or

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

Permitted attributes #

Descriptions for attributes specific to this element #

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 = URI
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.
src = URI
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 DOMString width;
           attribute DOMString height;
  readonly attribute unsigned long videoWidth;
  readonly attribute unsigned long videoHeight;
           attribute DOMString poster;
};