HTMLVideoElement

EventTarget <- Node <- Element <- HTMLElement <- HTMLMediaElement <- HTMLVideoElement

继承其父对象 HTMLMediaElementHTMLElement 的方法。

height poster videoHeight videoWidth width

<video />
  • <video> 元素提供了播放、暂停和音量控件来控制视频。
  • <video> 元素也提供了 width 和 height 属性控制视频的尺寸.如果设置的高度和宽度,所需的视频空间会在页面加载时保留。如果没有设置这些属性,浏览器不知道大小的视频,浏览器就不能再加载时保留特定的空间,页面就会根据原始视频的大小而改变。
  • <video></video> 标签之间插入的内容是提供给不支持 video 元素的浏览器显示的。
  • <video> 元素支持多个 <source> 元素。<source> 元素可以链接不同的视频文件。

可选属性

属性描述
autoplayautoplay视频在就绪后马上播放
controlscontrols向用户显示控件,比如播放按钮
heightpixels视频播放器的高度
looploop媒介文件完成播放后再次开始播放
mutedmuted视频的音视频输出为静音
posterURL规定视频正在下载时显示的图像,直到用户点击播放按钮
preloadauto metadata none视频在页面加载时进行加载,并预备播放
srcURL播放视频的 URL
widthpixels视频播放器的宽度

Video 对象

通过 getElementById() 访问 <video> 元素。

const video = docuemnt.getElementById('myVideo');

属性

属性说明
audioTracks返回表示可用音频轨道的 AudioTrackList 对象。
autoplay设置或返回是否在就绪(加载完成)后随即播放视频。
buffered返回表示视频已缓冲部分的 TimeRanges 对象。
controller返回表示视频当前媒体控制器的 MediaController 对象。
controls设置或返回视频是否应该显示控件(比如播放/暂停等)。
crossOrigin设置或返回视频的 CORS 设置。
currentSrc返回当前视频的 URL。
currentTime设置或返回视频中的当前播放位置(以秒计)。
defaultMuted设置或返回视频默认是否静音。
defaultPlaybackRate设置或返回视频的默认播放速度。
duration返回视频的长度(以秒计)。
ended返回视频的播放是否已结束。
error返回表示视频错误状态的 MediaError 对象。
height设置或返回视频的 height 属性的值。
loop设置或返回视频是否应在结束时再次播放。
mediaGroup设置或返回视频所属媒介组合的名称。
muted设置或返回是否关闭声音。
networkState返回视频的当前网络状态。
paused设置或返回视频是否暂停。
playbackRate设置或返回视频播放的速度。
played返回表示视频已播放部分的 TimeRanges 对象。
poster设置或返回视频的 poster 属性的值。
preload设置或返回视频的 preload 属性的值。
readyState返回视频当前的就绪状态。
seekable返回表示视频可寻址部分的 TimeRanges 对象。
seeking返回用户当前是否正在视频中进行查找。
src设置或返回视频的 src 属性的值。
startDate返回表示当前时间偏移的 Date 对象。
textTracks返回表示可用文本轨道的 TextTrackList 对象。
videoTracks返回表示可用视频轨道的 VideoTrackList 对象。
volume设置或返回视频的音量。
width设置或返回视频的 width 属性的值。

方法

方法说明
addTextTrack()向视频添加新的文本轨道。
canPlayType()检查浏览器是否能够播放指定的视频类型。
load()重新加载视频元素。
play()开始播放视频。
pause()暂停当前播放的视频。

加载过程

视频/音频(Audio / Video)在加载过程中,触发的顺序如下:

  1. onloadstart
  2. ondurationchange
  3. onloadedmetadata
  4. onloadeddata
  5. onprogress
  6. oncanplay
  7. oncanplaythrough