HTMLMediaElement: ended 事件
ended
事件会在媒体回放或者媒体流因达到了媒体的未尾或者没有更多可用的数据而停止时被触发。
该事件会在回放或媒体文件播放结束时,在媒体元素
(<audio>
和 <video>
)上触发。
是否冒泡 | 否 |
---|---|
是否可取消 | 否 |
接口 | Event |
目标 | 元素 |
默认行为 | 无 |
事件处理器属性 | GlobalEventHandlers.onended |
备注: 该事件也在 Media Capture and Streams 和 Web Audio 这两个 API 中定义。
示例
以下示例展示了如何为媒体元素的 ended
事件添加一个事件监听器,以在该事件触发时发送一条消息。
使用 addEventListener()
:
js
const video = document.querySelector("video");
video.addEventListener("ended", (event) => {
console.log(
"Video stopped either because 1) it was over, " +
"or 2) no further data is available.",
);
});
使用 onended
事件处理器属性:
js
const video = document.querySelector("video");
video.onended = (event) => {
console.log(
"Video stopped either because 1) it was over, " +
"or 2) no further data is available.",
);
};
规范
Specification |
---|
HTML Standard # event-media-ended |
HTML Standard # handler-onended |
浏览器兼容性
BCD tables only load in the browser
相关事件
- 媒体元素
playing
事件 - 媒体元素
waiting
(en-US) 事件 - 媒体元素
seeking
(en-US) 事件 - 媒体元素
seeked
(en-US) 事件 - 媒体元素
ended
事件 - 媒体元素
loadedmetadata
事件 - 媒体元素
loadeddata
事件 - 媒体元素
canplay
事件 - 媒体元素
canplaythrough
事件 - 媒体元素
durationchange
事件 - 媒体元素
timeupdate
事件 - 媒体元素
play
事件 - 媒体元素
pause
事件 - 媒体元素
ratechange
(en-US) 事件 - 媒体元素
volumechange
(en-US) 事件 - 媒体元素
suspend
(en-US) 事件 - 媒体元素
emptied
(en-US) 事件 - 媒体元素
stalled
(en-US) 事件