load 事件在整个页面及所有依赖资源如样式表和图片都已完成加载时触发。它与 Document/DOMContentLoaded_event 不同,后者只要页面 DOM 加载完成就触发,无需等待依赖资源的加载。
该事件不可取消,也不会冒泡。
[!NOTE] 所有以
load命名的事件都不会传递到Window上,即使bubbles初始化为true。要在window上捕获load事件,相关的load事件必须直接绑定到window上。
[!NOTE] 当主文档加载完成时,
load事件将在window上触发,但其有两个被修改的属性:target为document,以及path为undefined。这是由遗留的一致性问题导致的。
语法
在如 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。
addEventListener("load", (event) => {});
onload = (event) => {};
事件类型
一个通用的 Event。
示例
当页面完全加载后在控制台打印一段信息:
window.addEventListener("load", (event) => {
console.log("page is fully loaded");
});
也可以使用 onload 事件处理器属性实现:
window.onload = (event) => {
console.log("page is fully loaded");
};
交互示例
HTML
<div class="controls">
<button id="reload" type="button">Reload</button>
</div>
<div class="event-log">
<label for="eventLog">Event log:</label>
<textarea
readonly
class="event-log-contents"
rows="8"
cols="30"
id="eventLog"></textarea>
</div>
body {
display: grid;
grid-template-areas: "control log";
}
.controls {
grid-area: control;
display: flex;
align-items: center;
justify-content: center;
}
.event-log {
grid-area: log;
}
.event-log-contents {
resize: none;
}
label,
button {
display: block;
}
#reload {
height: 2rem;
}
JavaScript
const log = document.querySelector(".event-log-contents");
const reload = document.querySelector("#reload");
reload.addEventListener("click", () => {
log.textContent = "";
setTimeout(() => {
window.location.reload(true);
}, 200);
});
window.addEventListener("load", (event) => {
log.textContent += "load\n";
});
document.addEventListener("readystatechange", (event) => {
log.textContent += `readystate: ${document.readyState}\n`;
});
document.addEventListener("DOMContentLoaded", (event) => {
log.textContent += `DOMContentLoaded\n`;
});
结果
交互示例
规范
浏览器兼容性
参见
- Document readyState API
- 相关事件
- Document/DOMContentLoaded_event
- Document/readystatechange_event
- Window/beforeunload_event
- Window/unload_event
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
