Load() - Завантаження даних із сервера та розміщення отриманого HTML у вказаний елемент
Опис: Завантаження даних із сервера та розміщення отриманого HTML у вказаний елемент.
Доданий у версії: 1.0 .load( url [, data ] [, complete ] )
Примітка: обробник події закінчення завантаження також називається .load(). jQuery визначає який саме метод викликаний, на підставі того, які аргументи передаються в метод.
Цей метод є найпростішим способом отримати дані з сервера. Він приблизно еквівалентний код $.get(url, data, success) , за винятком того що цей метод а не глобальна функція і неявний обробник зворотного виклику. Коли повертається успішна відповідь (тобто, коли значення textStatus дорівнює "success" або "notmodified"), .load() встановлює HTML вміст у зазначений елемент із повернутих даних. Це означає, що в більшості випадків використання цього методу буде виглядати наступним чином:
Якщо не буде знайдений елемент, який відповідає заданому селектору, то в цьому випадку Ajax запит не буде відправлений.
Функція зворотного дзвінка
Якщо функція "complete" задана, вона виконується після обробки та вставки HTML. Ця функція буде викликана для кожного елемента в колекції jQuery і це всередині неї буде вказувати на DOM елемент.
У цих прикладах вище, якщо поточний документ не містить елемента з ID рівним "result", то метод .load() не виконається.
Метод запиту
Метод POST буде використаний якщо в метод .load() передано об'єкт, інакше буде використаний GET.
Завантаження фрагмента сторінки
Метод .load() , на відміну $.get() , дозволяє вказати частина віддаленого документа для вставки. Це доступно за допомогою спеціального синтаксису в параметрі url. Якщо один або кілька символів пропуску включені в рядок, то перше слово після першого пропуску будеприпускати jQuery селектор, який визначить, яка частина буде вставлена.
Ми можемо змінити код із прикладу вище, так щоб використовувалася тільки частина отриманого документа:
Коли цей метод виконується, витягується вміст ajax/test.html , але потім jQuery розбирає отриманий документ і шукає елемент з ID рівним container . Цей елемент з усім своїм вмістом буде вставлений в елемент з ID рівним result і решта завантаженого документа буде проігнорована.
jQuery використовується як властивість браузера .innerHTML , щоб проаналізувати отриманий документ і вставити його в поточний документ. Під час цього процес, браузер часто відфільтровує такі елементи з документа як: , або . В результаті елемент отриманий за допомогою методу .load() може бути не таким же, як якщо отримати цей документ у браузері безпосередньо.