Русская документация по API jQuery

jQuery это быстрая, небольшая и богатая возможностями JavaScript библиотека. Она позволяет очень просто делать такие вещи как: обход элементов или манипуляция элементами HTML документа или AJAX запросы. Не задумывайтесь о кросс-браузерности - это и многое другое берет на себя jQuery.

На нашем сайте Вы найдете перевод официальной документации API jQuery на русский язык.

.addBack()

Функция объединяет предыдущую выборку элементов с текущей. Это часто необходимо в тех случаях, когда Вам нужно осуществить над этими элементами общее действие.

.addClass()

Добавляет класс(ы) выбранным элементам страницы. Если из этих элементов некоторые уже принадлежат каким-то классам, то новый (новые) класс добавится к существующим, а не заменит их.

.clone()

Метод создает копии выбранных элементов страницы и возвращает их в виде объекта jQuery. Элементы копируются вместе со всеми содержащимися внутри них элементами.

.closest()

Для каждого элемента в наборе, получает первый элемент, который совпадает с селектором при движении вверху по DOM дереву элементов.

.fadeIn()

С помощью этой функции можно показывать и скрывать выбранные элементы на странице, за счет плавного изменения прозрачности.

.fadeTo()

Изменяет уровень прозрачности у выбранных элементов на странице. Позволяет менять прозрачность плавно.

.fadeToggle()

Вызов этого метода приводит к плавному исчезновению (если элемент не скрыт) или появлению (если элемент скрыт) выбранных элементов на странице, за счет изменения прозрачности. Отметим, что после скрытия элемента, его css-свойство display становится равным none, а перед появлением, оно получает свое прежнее значение обратно.

.find()

Поиск потомков внутри каждого элемента в текущем наборе соотвествующих элементов с фильтрацией по селектору, объекту jQuery или элементу.

.finish()

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

.hide()

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

.index()

Возвращает индекс заданного элемента в наборе (2 и 3 вариант использования) или относительно соседних элементов (1 вариант использования).

.is()

Проверяет, соответствует ли хотя бы один из выбранных элементов определенному условию (оно зависит от заданного параметра: если задан селектор, то условием будет соответствие селектору; если задан объект jQuery, то условие — наличие в нем выбранных элементов; при передаче в .is() элемента DOM, будет проверяться его наличие среди выбранных элементов; и наконец если указать в качестве параметра функцию, то проверка условия будет возложена на нее).

.live()

Устанавливает обработчик событий на выбранные элементы страницы. Метод имеет одну важную особенность, отличающую его от bind(): если на страницу будут вставлены новые элементы, которые соответствуют текущему селектору, то они также будут реагировать на заданные события.

.map()

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

.mouseup()

Устанавливает обработчик возвращения кнопки мыши в ненажатое состояние, либо, запускает это событие.

.offsetParent()

Возвращает ближайшего предка (т.е. из числа: родитель, прародитель, и так далее, до начало дерева DOM), у которого задан тип позиционирования (position равен relative или absolute или fixed). Элементы с заданным позиционированием играют особую роль, поскольку именно относительно них происходит позиционирование всех элементов внутри.

.one()

Устанавливает обработчик события выбранным элементам страницы. Особенностью метода является то, что обработчик будет вызван не более одного раза, на каждом из элементов.

.parents()

Осуществляет поиск всех предков выбранных элементов, то есть, не только прямых родителей, но и прародителей, прапрародителей и так далее, до начало дерева DOM.

.parentsUntil()

Осуществляет поиск всех предков у выбранных элементов (то есть, не только прямых родителей, но и прародителей, прапрародителей и так далее, до начало дерева DOM), вплоть до определенного элемента.

.prev()

Для каждого из выбранных элементов находит предшествующий ему элемент (но только если он лежит на том же уровне иерархии DOM).

.promise()

Создает заместителя deferred-объекта (объект с аналогичным набором методов, за исключением отсутствия методов изменения состояния объекта. Предоставление заместителя вместо исходного объекта, гарантирует, что его состояние нельзя будет изменить из вне).

.show()

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

.siblings()

Осуществляет поиск элементов, являющихся соседними для выбранных элементов (под соседними понимаются элементы, которые имеют общего родителя). При этом, сами выбранные элементы в результат не включаются.

.slice()

Фильтрует набор выбранных элементов, оставляя только те элементы, чьи индексы лежат в определенной области (например от 0 до 5).

.slideDown()

С помощью этой функции можно показывать и скрывать выбранные элементы на странице, за счет плавного разворачивания и сворачивания.

.slideToggle()

Вызов этого метода приводит к плавному сворачиванию (если элемент развернут) или разворачиванию (если элемент свернут) выбранных элементов на странице.

.slideUp()

С помощью этой функции можно показывать и скрывать выбранные элементы на странице, за счет плавного разворачивания и сворачивания.

.val()

Метод позволяет получать и изменять значения элементов форм. Для элементов input это значение атрибута value; для списков выбора (select) – значение value выбранного элемента (в случае множественного выбора – массив значений); в случае с textarea, метод .val() будет работать непосредственно с содержимым тега textarea.

.wrapInner()

"Обертывает" содержимое выбранных элементов заданными html-элементами. Таким образом получается, что все выбранные объекты "обертываются изнутри".

deferred.then()

С помощью этого метода можно установить обработчики перехода объекта deferred в состояние удачного выполнения, ошибки выполнения (resolved или rejected). then() регистрирует 2 обработчика сразу.

event.currentTarget

Содержит DOM-элемент, событие которого обрабатывается. Внутри обработчика, currentTarget всегда совпадает с переменной this. Однако, этот элемент может не являться источником события, поскольку оно могло быть передано от дочернего элемента, в результате "всплытия" события, вверх по иерархии DOM. Первоначальный источник события содержится в event.target.

event.delegateTarget

Содержит DOM-элемент, на который действительно установлен сработавший обработчик. Это свойство имеет смысл, если обработчик установлен делегированно. Если обработчик установлен непосредственно, то значение event.delegateTarget будет совпадать с event.currentTarget.

event.preventDefault()

Отменяет выполнение события. Например, при "клике" по ссылке, переход по ней не произойдет, если внутри обработчика будет вызван этот метод.

event.relatedTarget

Не текущий DOM-элемент, участвующий в событии. Для события mouseout будет содержать элемент, куда переместился курсор, а для mousein элемент, откуда курсор пришел.

event.result

Содержит значение, которое возвратил предыдущий обработчик этого события. Если предыдущего обработчика нет, возвратит undefined.

event.stopImmediatePropagation()

Предотвращает выполнение следующих обработчиков текущего события, а также, дальнейшую передачу события вверх по иерархии дерева DOM. Если требуется лишь остановить передачу события вверх по иерархии, а другие обработчики на текущем элементе останавливать не требуется, воспользуйтесь методом event.stopPropagation().

event.stopPropagation()

Предотвращает дальнейшую передачу текущего события, вверх по иерархии дерева DOM (некоторые события, такие как click, после выполнения на самом элементе, передают его родительским, что повторяется до самого основания дерева DOM).

event.which

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

jQuery()

Функция jQuery() является, пожалуй основной функцией в библиотеке. Она обычно, вызывается намного чаще других и поэтому для нее существует короткая форма записи — $(). Функция jQuery() позволяет производить поиск элементов на странице, создавать новые элементы по заданному HTML тексту, а так же кое что еще. Возвращает объект jQuery.

jQuery.Deferred()

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

jQuery.ajaxPrefilter()

Обрабатывает пользовательские Ajax параметры или изменяет существующие параметры прежде чем каждый запрос будет отправлен и прежде чем они будут обработаны методом $.ajax()

jQuery.browser

Содержит флаги для UserAgent, считанные из navigator.userAgent. Это свойство было удалено в jQuery 1.9 и доступно только через плагин jQuery.migrate. Попробуйте вместо этого использовать функцию обнаружения.

jQuery.cssHooks

Подключается непосредственно в jQuery, чтобы переопределить способы извлечения или установки определенных CSS свойств, нормализации присвоения CSS имен или создания настраиваемых свойств.

jQuery.data()

С помощью этого метода, появляется возможность привязывать собственные переменные к любым элементам страницы.

jQuery.each()

A generic iterator function, which can be used to seamlessly iterate over both objects and arrays. Arrays and array-like objects with a length property (such as a function’s arguments object) are iterated by numeric index, from 0 to length-1. Other objects are iterated via their named properties.

jQuery.extend()

Объединяет содержимое двух или более заданных javascript-объектов. Результат объединения записывается в первый из этих объектов (он же будет возвращен функцией, после ее выполнения).

jQuery.grep()

Ищет в заданном массиве элементы, удовлетворяющие условиям фильтрующей функции. Возвращает массив с найденными элементами (в исходный массив изменения не вносятся).

jQuery.hasData()

Проверяет, закреплены ли данные за указанным элементом страницы.

jQuery.inArray()

Ищет заданный элемент в массиве. Возвращает индекс этого элемента или -1 в случае его отсутствия.

jQuery.isNumeric()

Проверяет, является ли заданный аргумент числом или может ли быть к нему сведен (например строка с числовым значением).

jQuery.isPlainObject()

Проверяет, является ли заданный элемент пользовательским объектом, то есть он был задан пользователем именно в роли объекта (посредством "{}" или "new Object")(дело в том, что многие величины (например строки) в javascript являются объектами, однако они не задаются объектами явным образом).

jQuery.isWindow()

Проверяет, является ли заданный элемент объектом типа window (объекты фреймов тоже принадлежат к этому типу).

jQuery.isXMLDoc()

Проверяет, находится ли DOM-объект внутри XML-документа (или сам является XML-документом).

jQuery.map()

Выполняет заданную функцию для каждого элемента массива (если задан массив) или каждого поля объекта (если задан объект) в отдельности. Значения, полученные в результате выполнения этой функции помещаются в новый массив и возвращаются как результат работы функции.

jQuery.merge()

Объединяет содержимое двух массивов. Результат объединения записывается в первый из этих массивов (он же будет возвращен в качестве результата выполнения функции).

jQuery.support

A collection of properties that represent the presence of different browser features or bugs. Intended for jQuery’s internal use; specific properties may be removed when they are no longer needed internally to improve page startup performance. For your own project’s feature-detection needs, we strongly recommend the use of an external library such as Modernizr instead of dependency on properties in jQuery.support.

jQuery.trim()

Удаляет символы пробелов, табов и переносов строк из начала и конца строки.

jQuery.type()

Определяет класс заданного элемента (речь идет о внутренних классах javascript: string, boolean и т.д.).

jQuery.unique()

Сортирует массив с DOM-элементами, выстраивая их в порядке расположения в DOM, а также удаляя повторения.

jQuery.when()

На основе нескольких заданных объектов (обычно deferred), функция $.when() создает новый deferred-объект, следящий за состоянием всех заданных. Стоит уточнить, что $.when() возвращает promise-версию (заместителя) deferred-объекта.

Дочерний селектор (“parent > child”)

Соответствует элементам, удовлетворяющим селектору child, которые при этом являются дочерними (т.е. находятся на первом уровне вложенности) для элементов, удовлетворяющих селектору parent. (В отличие от него, селектор (E F) позволяет искать элементы на всех уровнях вложенности).

Нисходящий селектор (“ancestor descendant”)

Соответствует элементам удовлетворяющим селектору inner, которые являются потомками (лежат внутри) элементов, удовлетворяющих селектору outer. В отличии от дочернего селектора (outer > inner), с помощью которого производится поиск элементов только на первом уровне вложенности в outer, нисходящий селектор задает поиск на всех уровнях вложенности.

Селектор :checked

Соответствует всем выбранным элементам формы. Это могут быть выбранные флажки (checkbox), переключатели (radio) или элементы списка (select).

Селектор :enabled

Соответствует всем активным (незаблокированным от пользователя) элементам формы (элементы без атрибута disabled).

Селектор :even

Соответствует элементам с четными номерами позиций, в наборе выбранных элементов.(вариант с нечетными — :odd). Поскольку счет элементов начинается с 0, :even будет соответствовать первому, третьему и т. д. элементам.

Селектор :nth-last-child()

Соответствует элементам, которые расположены в своих непосредственных предках по определенным условиям. :nth-child-last() рассматривает позиции элементов в обратном порядке (т. е. с конца).

Селектор :odd

Соответствует элементам с нечетными номерами позиций, в наборе выбранных элементов. (вариант с четными — :even). Поскольку счет элементов начинается с 0, :odd будет соответствовать второму, четвертому и т. д. элементам.

Селектор по значению атрибута [name=”value”]

Соответствует всем элементам с атрибутом attribute равным value. Если value состоит из нескольких слов, между которыми есть пробелы, то нужно заключать value в кавычки. Если value не содержит пробелов — кавычки не обязательны.

Селектор по концу атрибута [name$=”value”]

Соответствует всем элементам, у которых значение атрибута attribute заканчивается на value. Если value состоит из нескольких слов, между которыми есть пробелы, то нужно заключать value в кавычки. Если value не содержит пробелов — кавычки не обязательны.

Селектор по началу атрибута [name^=”value”]

Соответствует всем элементам, у которых значение атрибута attribute начинается с value. Если value состоит из нескольких слов, между которыми есть пробелы, то нужно заключать value в кавычки. Если value не содержит пробелов — кавычки не обязательны.

Селектор по несовпадению с атрибутом [name!=”value”]

Соответствует всем элементам, у которых значение атрибута attribute не равно value. Если value состоит из нескольких слов, между которыми есть пробелы, то нужно заключать value в кавычки. Если value не содержит пробелов — кавычки не обязательны.

Селектор по подстроке в элементе [name*=”value”]

Соответствует всем элементам, у которых значение атрибута attribute содержит value. Если value состоит из нескольких слов, между которыми есть пробелы, то нужно заключать value в кавычки. Если value не содержит пробелов — кавычки не обязательны.

Селектор по префиксу элемента [name|=”value”]

Соответствует всем элементам, с атрибутом attribute содержащим префикс value, т.е. либо полностью совпадает с value, либо начинается со строки value- (наличие знака переноса существенно). Если value состоит из нескольких слов, между которыми есть пробелы, то нужно заключать value в кавычки. Если value не содержит пробелов — кавычки не обязательны.

Селектор по слову в атрибуте [name~=”value”]

Соответствует всем элементам с атрибутом attribute, содержащим слово value (именно слово, а не просто подстроку. То есть вхождение value должно содержать с обоих сторон разделители: пробелы или начало/конец строки). Если value состоит из нескольких слов, между которыми есть пробелы, то нужно заключать value в кавычки. Если value не содержит пробелов — кавычки не обязательны.