Video poster 属性

Video 对象参考手册 Video 对象

修改当前视频数据在无效时显示的图片:

<video id="myVideo" width="320" height="240" poster="/images/logo.png" controls>
  <source src="/examples/movie.mp4" type="video/mp4">
    <source src="/examples/movie.ogg" type="video/ogg">
    您的浏览器不支持 video 标签。
</video>
<p>点击按钮修改预览图片。</p>
<button onclick="myFunction()">点我</button>
<script>
  function myFunction() {
    document.getElementById("myVideo").poster = "/images/logo2.png";
  }
</script>

尝试一下 »


定义和用法

poster 属性用于设置或返回视频的 poster 属性值。

poster 属性描述了在视频加载时或在用户点击播放按钮前显示的图片。如果不包含该属性,视频的第一帧将被用来代替显示。


浏览器支持

Internet ExplorerFirefoxOperaGoogle ChromeSafari

所有主流浏览器都支持 poster 属性。

注意: Internet Explorer 8 及更早 IE 版本不支持 <video> 元素。


语法

返回 poster 属性:

videoObject.poster

设置 poster 属性:

videoObject.poster=URL

属性值

描述
URL 描述了图片文件的 URL 地址。

可能值:

  • 绝对 URL - 指向其他站点 (如: href="http://www.example.com/poster.jpg")
  • 相对 URL - 指向站内文件 (如: href="poster.jpg")

技术细节

返回值: 字符串,表示预览图片的 URL地址。返回实体 URL,包含协议 ( http://)

更多实例

获取预览图的URL地址:

<video id="myVideo" width="320" height="240" poster="/images/logo.png" controls>
  <source src="/examples/movie.mp4" type="video/mp4">
    <source src="/examples/movie.ogg" type="video/ogg">
    您的浏览器不支持 video 标签。
</video>
<p>点击按钮返回视频的 poster 属性值。</p>
<p id="demo"></p>
<button onclick="myFunction()">点我</button>
<script>
  function myFunction() {
    var x = document.getElementById("myVideo").poster;
    document.getElementById("demo").innerHTML = x;
  }
</script>

尝试一下 »


相关页面

HTML 参考手册: HTML <video> poster 属性


Video 对象参考手册 Video 对象