此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Window:load 事件

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

load 事件在整个页面及所有依赖资源如样式表和图片都已完成加载时触发。它与 DOMContentLoaded 不同,后者只要页面 DOM 加载完成就触发,无需等待依赖资源的加载。

该事件不可取消,也不会冒泡。

备注: 所有以 load 命名的事件都不会传递到 Window,即使 bubbles 初始化为 true。要在 window 上捕获 load 事件,相关的 load 事件必须直接绑定到 window 上。

备注: 当主文档加载完成时,load 事件将在 window 上触发,但其有两个被修改的属性:targetdocument,以及 pathundefined。这是由遗留的一致性问题导致的。

语法

在如 addEventListener() 等方法中使用事件名称,或设置事件处理器属性。

js
addEventListener("load", (event) => {}); onload = (event) => {}; 

事件类型

一个通用的 Event

示例

当页面完全加载后在控制台打印一段信息:

js
window.addEventListener("load", (event) => { console.log("page is fully loaded"); }); 

也可以使用 onload 事件处理器属性实现:

js
window.onload = (event) => { console.log("page is fully loaded"); }; 

交互示例

HTML

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> 

JavaScript

js
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`; }); 

结果

规范

Specification
UI Events
# event-type-load
HTML
# delay-the-load-event

浏览器兼容性

参见