Обработчик события load

.load()

Устанавливает обработчик полной загрузки выбранных элементов. Метод имеет два варианта использования:

.load(handler(eventObject)):jQuery1.0

Устанавливает функцию handler в качестве обработчика события load, на выбранные элементы.
Метод является аналогом bind("load", handler(eventObject)).

handler(eventObject) — функция, которая будет установлена в качестве обработчика. При вызове она будет получать объект события eventObject.

.load(eventData, handler(eventObject)):jQuery1.4.3

Метод отличается от предыдущего возможностью передавать в обработчик дополнительные данные.
Является аналогом bind("load", eventData, handler(eventObject)).

handler(eventObject) — см. выше.
eventData — дополнительные данные, передаваемые в обработчик. Они должны быть представлены объектом в формате: {fName1:value1, fName2:value2, ...}.

Событие load происходит, когда сам элемент и все его дочерние элементы полностью загружены. Это событие может происходить на элементах, которые обладают полями URL (объект window, картинки, скрипты, фреймы).

Замечание: в некоторых случаях, если картинка содержится в кеше браузера, событие load может не произойти. Для такого случая можно воспользоваться специальным событием event.special.load, которое определено в небольшом плагине.

Замечание 2: если вам не требуется готовность мультимедийных файлов, лучше воспользоваться методом .ready(), который устанавливает обработчик готовности структуры документа, что происходит раньше начала загрузки файлов мультимедиа.

Примеры использования

Для страницы, содержащей картинку

<img src="book.png" alt="Book" id="book" />

следующий код позволит обработать ее загрузку:

$('#book').load(function() {
  // действия, в ответ на загрузку изображения
});


А вот так можно обработать готовность всей страницы:

$(window).load(function () {
  // манипуляции с готовой страницей
});

Ссылки

Поисковые ключи:
  • готовность элементов страницы
  • обработчик события load
  • .load()
  • load()