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

Если указан аргумент duration, переключает состояние видимости выбранных элементов, манипулируя размером и прозрачностью в течение duration миллисекунд. По завершении вызывает функцию f, если указана, как метод для каждого выбранного элемента.

<b>queue([qname=&quot;fx&quot;]):array </b>

<b>queue([qname=&quot;fx&quot;], f(next)) </b>

<b>queue([qna/7?e=&quot;fx&quot;], newq)</b>

При вызове без аргументов или только с именем очереди возвращает указанную очередь для первого выбранного элемента. При вызове с аргументом-функцией добавляет f в указанную очередь для всех выбранных элементов. При вызове с аргументом-массивом замещает указанную очередь для всех выбранных элементов массивом функций newq.

Функции 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

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

<b>jQuery.ajax(options):XMLHttpRequest</b>

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

<b>jQuery.ajaxSetup (options)</b>

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

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

<b>jQuery.getJS0N(url, [data], [f (object, status)]) :XMLHttpRequest</b>

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

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

<b>jQuery.getScript(url, [f(text,status)]):XMLHttpRequest</b>

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

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

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

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

<b>XMLHttpRequest</b>
, использовавшимся для выполнения запроса. Этот объект
<b>XMLHttpRequest</b>
, если имеется, также является возвращаемым значением функции
<b>jQuery.get()</b>
.

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

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

<b>jQuery.get()</b>
, но выполняет не GET-запрос, a HTTP POST-запрос.

<b>jQuery.param(o, [old=false]):string</b>

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

<b>jQuery. parseJSON(text):object</b>

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

<b>load(url, [data], [f(text, status, xhr)])</b>

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

<b>XMLHttpRequest</b>
, использовавшийся для выполнения запроса.

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

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

<b>load()</b>
является методом, а не функцией. Подобно большинству методов объекта
<b>jQuery</b>
, возвращает объект
<b>jQuery</b>
, относительно которого этот метод был вызван.

<b>serialize():string</b>

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

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

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

<b>jQuery.boxModel</b>

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

<b>jQuery.support.boxModel</b>
.

<b>jQuery.browser</b>

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

<b>msie</b>
в броузере Internet Explorer,
<b>mozilla</b>
- в Firefox,
<b>webkit</b>
- в Safari и Chrome, и
<b>opera</b>
- в Opera. Свойство
<b>version</b>
содержит номер версии броузера.