HTMLMediaElement: ended 事件
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
ended
事件会在媒体回放或者媒体流因达到了媒体的未尾或者没有更多可用的数据而停止时被触发。
该事件会在回放或媒体文件播放结束时,在媒体元素
(<audio>
和 <video>
)上触发。
是否冒泡 | 否 |
---|---|
是否可取消 | 否 |
接口 | Event |
目标 | 元素 |
默认行为 | 无 |
事件处理器属性 | GlobalEventHandlers.onended |
示例
以下示例展示了如何为媒体元素的 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
事件 - 媒体元素
seeking
事件 - 媒体元素
seeked
事件 - 媒体元素
ended
事件 - 媒体元素
loadedmetadata
事件 - 媒体元素
loadeddata
事件 - 媒体元素
canplay
事件 - 媒体元素
canplaythrough
事件 - 媒体元素
durationchange
事件 - 媒体元素
timeupdate
事件 - 媒体元素
play
事件 - 媒体元素
pause
事件 - 媒体元素
ratechange
事件 - 媒体元素
volumechange
事件 - 媒体元素
suspend
事件 - 媒体元素
emptied
事件 - 媒体元素
stalled
事件