CKTIS / JavaScript
HTMLElement.onload — обработване на зареждането на ресурс
HTMLElement.onload е свойството за обработчик на събитието load. Задайте му функция, която да реагира на зареждането на ресурс на елемент, например изображение. Последващо присвояване заменя предишната функция, а null деактивира обработчика.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.onload = function (event) { /* handle load */ };
element.onload = null;HTMLElement.onload е свойството за обработчик на събитието load, предоставено чрез механизма GlobalEventHandlers. Това е интерфейс на браузъра, дефиниран от HTML, а не функционалност на самия ECMAScript; наличието на Node.js 24 не доказва, че свойството е достъпно.
При изображение load означава, че ресурсът е зареден успешно. Задайте функцията преди да присвоите src, за да не пропуснете събитието. Наличието на това свойство върху даден елемент не означава, че всеки елемент автоматично излъчва load. Елементите body и frameset са особен случай: техният onload обработва събитието на Window, а не зареждането на отделен ресурс на елемента.
Присвояването на нова функция заменя предишната; null премахва този обработчик. За независими абонаменти използвайте addEventListener('load', handler). В примера изображението е с размер 1x1, а функцията получава event. Обикновената функция използва this, за да се позове на изображението.
Примери
(() => {
const image = document.createElement('img');
image.onload = function (event) {
console.log(event.type + ': ' + this.naturalWidth + 'x' + this.naturalHeight);
this.onload = null;
};
image.onerror = () => console.log('error');
image.src = 'data:image/svg+xml,' + encodeURIComponent(
'<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"></svg>'
);
})();Резултат
load: 1x1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.