HTMLElement: событие загрузки

Событие load срабатывает для элементов, содержащих ресурс, когда ресурс успешно загружен. В настоящее время поддерживаются следующие HTML-элементы: <body>, <embed>, <iframe>, <img>, <link>, <object>, <script>, <style> и <track>.

Примечание: Событие load для HTMLBodyElement фактически является псевдонимом для события window.onload. Поэтому событие load будет срабатывать только на элементе <body> после загрузки или ошибки всех ресурсов документа. Однако для большей ясности рекомендуется присоединить обработчик события к объекту window напрямую, а не к HTMLBodyElement.

Это событие не отменяется и не распространяется.

Синтаксис

Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика события.

elt.addEventListener("load", (event) => { ... });
// or
elt.onload = (event) => { ... };

Тип события

Общее Event.

Примеры

В этом примере на экран выводится сообщение всякий раз, когда элемент <img> успешно загружает свой ресурс.

HTML

<img id="image" src="favicon144.png" alt="MDN logo" width="72" />
<div><button onclick="reload()">Reload</button></div>

JavaScript

const image = document.getElementById("image");
image.onload = () => {
  document.body.appendChild(document.createElement("div")).textContent =
    "loaded!";
};

function reload() {
  image.src = "favicon144.png";
}

Результат

Спецификации

Спецификация не найдена

Данные спецификации для api.HTMLElement.load_event не найдены.
Проверьте наличие проблем на этой странице или внесите недостающую spec_url в mdn/browser-compat-data. Также убедитесь, что спецификация включена в w3c/browser-specs.

Совместимость с браузерами

См. также

Связанные события
- Окно: load события
- Окно: error события

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/load_event