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的新标签。
参考
外部链接