JavaScript. Подробное руководство, 6-е издание

Флэнаган Дэвид

Функции jQuery поддержки архитектуры Ajax

Большая часть функциональности библиотеки jQuery, имеющей отношение к поддержке архитектуры Ajax, реализована в виде вспомогательных функций, а не методов. Они являются одними из наиболее сложных функций в библиотеке jQuery. Дополнительные сведения приводятся в разделе 19.6.

Коды состояния Ajax

success error notmodified timeout parsererror

Типы данных Ajax

text html xml script json jsonp

События Ajax

ajaxStart ajaxSend ajaxSuccess ajaxError ajaxComplete ajaxStop

Параметры Ajax

jQuery.ajax(options):XMLHttpRequest

Сложная,

но самая универсальная функция поддержки архитектуры Ajax, на которой основаны все Ajax-утилиты в библиотеке jQuery. Она принимает единственный объект в виде аргумента, свойства которого определяют все тонкости, касающиеся отправки запроса и обработки ответа сервера. Наиболее типичные параметры описываются в разделе 19.6.3.1, а параметры функций обратного вызова - в 19.6.3.2.

jQuery.ajaxSetup (options)

Устанавливает указанные параметры как значения по умолчанию. Принимает тот же объект options, какой передается функции

jQuery.ajax.

Указанные вами значения будут использоваться всеми последующими запросами, при оформлении которых не будут явно указаны другие значения параметров. Эта функция не имеет возвращаемого значения.

jQuery.getJS0N(url, [data], [f (object, status)]) :XMLHttpRequest

Отправляет асинхронный запрос по адресу url, добавляя любые данные data. Выполняет синтаксический анализ полученного ответа как строки в формате JSON и передает получившийся объект функции обратного вызова f. Возвращает объект

XMLHttpRequest

, если таковой имеется, использовавшийся для выполнения запроса.

jQuery.getScript(url, [f(text,status)]):XMLHttpRequest

Отправляет асинхронный запрос по адресу url. При получении ответа выполняет его как сценарий, а затем передает текст ответа функции f. Возвращает объект

XMLHttpRequest

, если таковой имеется, использовавшийся для выполнения запроса. Позволяет выполнять междоменные запросы, но в этом случае не передает текст сценария функции f и не возвращает объект

XMLHttpRequest

.

jQuery.get(url, [data], [f(data,status,xhr)], [type]):XMLHttpRequest

Отправляет асинхронный HTTP GET-запрос по адресу url, добавляя данные data, если указаны, в строку параметров запроса данного URL-адреса. При получении ответа интерпретирует его как данные типа type или в соответствии со значением заголовка Content-Type ответа и выполняет его или выполняет синтаксический анализ, если это необходимо. В заключение передает (возможно, в разобранном виде) данные ответа функции обратного вызова f вместе с кодом состояния и объектом

XMLHttpRequest

, использовавшимся для выполнения запроса. Этот объект

XMLHttpRequest

, если имеется, также является возвращаемым

значением функции

jQuery.get

.

jQuery.post (url, [data], [f(data,status,xhr)], [type]) :XMLHttpRequest

Действует подобно функции

jQuery.get

, но выполняет не GET-запрос, a HTTP POST-запрос.

jQuery.param(o, [old=false]):string

Сериализует имена и значения свойств объекта о в формат «www-form-urlencoded», пригодный для добавления в URL-адрес или для передачи в теле HTTP POST-запроса. Большинство функций поддержки Ajax в библиотеке jQuery делают это автоматически, если получают объект в параметре data. Если требуется выполнить поверхностную сериализацию объекта в стиле версии jQuery 1.3, во втором аргументе следует передать значение true.

jQuery. parseJSON(text):object

Выполняет синтаксический разбор текста в формате JSON и возвращает полученный объект. Функции поддержки архитектуры Ajax в библиотеке jQuery используют эту функцию при запросе данных в формате JSON.

load(url, [data], [f(text, status, xhr)])

Отправляет асинхронный запрос по адресу url, добавляя любые данные data. При получении ответа интерпретирует его как строку с разметкой HTML и вставляет ее в каждый выбранный элемент, замещая любое имеющееся содержимое. В заключение вызывает f как метод для каждого выбранного элемента, передавая функции f текст ответа, код состояния и объект

XMLHttpRequest

, использовавшийся для выполнения запроса.

Если значение url включает пробел, любой текст после пробела используется как селектор и в выбранные элементы вставляется только часть документа в ответе, которая соответствует селектору.

В отличие от большинства функций поддержки архитектуры Ajax в библиотеке jQuery,

load

является методом, а не функцией. Подобно большинству методов объекта

jQuery

, возвращает объект

jQuery

, относительно которого этот метод был вызван.

serialize:string

Сериализует имена и значения выбранных форм или элементов форм и возвращает строку в формате «www-form-urlencoded».

Вспомогательные функции в библиотеке jQuery

Ниже перечислены различные функции и свойства (не методы), имеющиеся в библиотеке jQuery. Дополнительные сведения приводятся в разделе 19.7.

jQuery.boxModel

Устаревший синоним для

jQuery.support.boxModel

.

jQuery.browser

Это свойство ссылается на объект, идентифицирующий производителя и версию броузера. Объект имеет свойство

msie

в броузере Internet Explorer,

mozilla

– в Firefox,

webkit

– в Safari и Chrome, и

opera

– в Opera. Свойство

version

содержит номер версии броузера.

jQuery. contains(a,b): boolean