audio

 

HTML <audio> 元素用于在文档中表示音频内容。 <audio> 元素可以包含多个音频资源， 这些音频资源可以使用 src 属性或者<source> 元素来进行描述； 浏览器将会选择最合适的一个来使用。对于不支持<audio>元素的浏览器，<audio>元素也可以作为浏览器不识别的内容加入到文档中。

用途

<audio> 元素用于音频内容，可以包含多个音频资源。浏览器会自动选择最合适的一个来用。

例子

代码 

<audio src="someaudio.wav">
  audio 标签。
</audio>

属性

标准属性

属性描述HTML5新
全局核心属性
全局文本属性
全局操作属性
autoplay 如果是 true，则音频在就绪后马上自动播放。✔
controls 如果是 true，则向用户显示控件，包含音量，跨帧，暂停/恢复播放。✔
end 播放器在视频流中的何处停止播放。默认地，声音会播放到结尾。✔
loopend 在视频流中循环播放停止的位置，默认是 end 属性的值。✔
loopstart 在视频流中循环播放的开始位置。默认是 start 属性的值。✔
playcount 视频片段播放次数。默认是 1。✔
src 要播放的视频的 URL。✔
start 定义播放器在音频流中开始播放的位置。默认地，声音在开头进行播放。✔

事件属性

属性描述HTML5新
全局键盘事件属性
全局鼠标事件属性
onabort当播放中止时发送；例如，如果媒体正在播放并从一开始重新启动，则发送此事件。✔
oncanplay在媒体数据已经有足够的数据（至少播放数帧）可供播放时触发。这个事件对应CAN_PLAY的readyState。✔
oncanplaythrough在媒体的readyState变为CAN_PLAY_THROUGH时触发，表明媒体可以在保持当前的下载速度的情况下不被中断地播放完毕。注意：手动设置currentTime会使得firefox触发一次canplaythrough事件，其他浏览器或许不会如此。✔
ondurationchange元信息已载入或已改变，表明媒体的长度发生了改变。例如，在媒体已被加载足够的长度从而得知总长度时会触发这个事件。✔
onemptied媒体无效;例如, 如果已经加载了媒体 (或部分加载), 并且调用 load () 方法来重新加载它, 则会发送此事件。✔
onended播放结束时触发。✔
onerror在发生错误时触发。元素的error属性会包含更多信息。✔
onloadeddata媒体的第一帧已经加载完毕。✔
onloadedmetadata媒体的元数据已经加载完毕，现在所有的属性包含了它们应有的有效信息。✔
onloadstart在媒体开始加载时触发。✔
onpause播放暂停时触发。✔
onplay在媒体回放被暂停后再次开始时触发。即，在一次暂停事件后恢复媒体回放。✔
onplaying在媒体开始播放时触发（不论是初次播放、在暂停后恢复、或是在结束后重新开始）。✔
onprogress告知媒体相关部分的下载进度时周期性地触发。有关媒体当前已下载总计的信息可以在元素的buffered属性中获取到。✔
onratechange在回放速率变化时触发。✔
onseeked在跳跃操作完成时触发。✔
onseeking在跳跃操作开始时触发。✔
onstalled当用户代理尝试获取媒体数据时发送, 但数据意外获取失败。✔
onsuspend在媒体资源加载终止时触发，这可能是因为下载已完成或因为其他原因暂停。✔
ontimeupdate元素的currentTime属性表示的时间已经改变。✔
onvolumechange在音频音量改变时触发（既可以是volume属性改变，也可以是muted属性改变）.。✔
onwaiting在一个待执行的操作（如回放）因等待另一个操作（如跳跃或下载）被延迟时触发。✔

变更点

<audio>标签是HTML5的新标签。

参考

外部链接


跳至内容顶部