jQuery методы DOM
Методы DOM в jQuery позволяют читать и изменять содержимое, атрибуты и оформление элементов страницы, а также добавлять, удалять и оборачивать элементы. DOM (англ. Document Object Model — объектная модель документа) представляет страницу как дерево узлов, с которым работает программа.
Метод чтения обычно берёт значение первого элемента, а метод записи меняет все элементы набора; точное поведение
зависит от метода. Например,
.attr()
работает с HTML-атрибутом,
.prop()
— со свойством DOM, а
.data()
— с отдельным хранилищем jQuery.
Для пользовательского текста выбирайте
.text().
.html()
и методы вставки разбирают разметку, поэтому непроверенные HTML-строки могут привести к выполнению чужого кода.
Фильтрация HTML и Trusted Types не заменяют друг друга.
Примеры используют jQuery 4.0.0. При записи через
.css()
явно задавайте единицы, если значение требует длины: автоматическое добавление px сохранено только для
ограниченного набора свойств. Удалённые возможности отмечены отдельно.
| Метод | Описание |
|---|---|
| .addClass() | Добавляет один или несколько имен классов для выбранных элементов. |
| .after() | Вставляет указанное содержимое, переданное в параметре метода после каждого выбранного элемента. |
| .append() | Вставляет содержимое, указанное в параметре метода в конец каждого выбранного элемента в наборе совпавших элементов. |
| .appendTo() | Вставляет содержимое в конец каждого целевого элемента в наборе совпавших элементов. |
| .attr() | Получает значение атрибута для первого элемента в наборе совпавших элементов, или устанавливает один или несколько атрибутов для набора выбранных элементов. |
| .before() | Вставляет указанное содержимое, переданное в параметре метода перед каждыми выбранным элементом. |
| .clone() | Создает копию выбранных элементов, включая дочерние узлы, текст и атрибуты. |
| .css() | Задает или возвращает одно или несколько свойств стиля для выбранных элементов. |
| .detach() | Удаляет выбранные элементы из дерева DOM (сохраняет данные и события). |
| .empty() | Удаляет все дочерние узлы и содержимое у выбранных элементов. |
| .hasClass() | Определяет существуют ли искомые элементы с указанным именем класса, или классов. |
| .height() | Получает текущее вычисленное значение высоты для первого элемента в наборе совпавших элементов, или устанавливает высоту каждого соответствующего элемента. |
| .html() | Задает содержимое выбранных элементов, или возвращает значение первого элемента в наборе. |
| .innerHeight() |
Получает текущее вычисленное значение внутренней высоты (включая внутренние отступы -
padding, но не границы -
border) для первого элемента в наборе совпавших элементов, или устанавливает внутреннюю высоту каждого
соответствующего элемента.
|
| .innerWidth() |
Получает текущее вычисленное значение внутренней ширины (включая внутренние отступы -
padding, но не границы -
border) для первого элемента в наборе совпавших элементов, или устанавливает внутреннюю ширину каждого
соответствующего элемента.
|
| .insertAfter() | Вставляет указанное содержимое после каждого целевого элемента, переданного в параметре метода. |
| .insertBefore() | Вставляет указанное содержимое перед каждым целевым элементом, переданным в параметре метода. |
| $.cssHooks |
Объект обработчиков чтения и записи CSS-свойств через jQuery. Позволяет расширить поведение
.css(); сам по себе не добавляет браузеру поддержку нового CSS-свойства.
|
| $.cssNumber Устарело |
Исторический список свойств, к числовым значениям которых jQuery не добавляла px. Удалён в 4.0.
Теперь автоматическое добавление единиц ограничено; в остальных случаях передавайте строку с нужными
единицами.
|
| $.escapeSelector() |
Экранирует любой символ, который имеет особое значение в CSS селекторе. Этот метод используется в случаях,
когда имя класса, или
id
содержит символы, которые имеют особое значение в CSS (например, такие как точка, или точка с запятой).
|
| $.htmlPrefilter() | Точка расширения для обработки HTML перед методами вставки. С jQuery 3.5 по умолчанию возвращает разметку без изменений. Не является средством очистки опасного HTML. |
| .offset() | Задает или возвращает значение координат для выбранных элементов (относительно документа). |
| .outerHeight() |
Получает текущее вычисленное значение внешней высоты (включая внутренние отступы -
padding, границы -
border
и при необходимости внешние отступы -
margin) для первого элемента в наборе совпавших элементов, или устанавливает внешнюю высоту каждого
соответствующего элемента.
|
| .outerWidth() |
Получает текущее вычисленное значение внешней ширины (включая внутренние отступы -
padding, границы -
border
и при необходимости внешние отступы -
margin) для первого элемента в наборе совпавших элементов, или устанавливает внешнюю ширину каждого
соответствующего элемента.
|
| .position() | Возвращает позицию первого совпадающего элемента (относительно родительского позиционированного элемента). |
| .prepend() | Вставляет содержимое, указанное в параметре метода в начало каждого выбранного элемента в наборе совпавших элементов. |
| .prependTo() | Вставляет содержимое в начало каждого целевого элемента в наборе совпавших элементов. |
| .prop() | Задает, или возвращает значения свойств выбранных элементов. |
| .remove() | Удаляет выбранные элементы из дерева DOM (не сохраняет данные и события). |
| .removeAttr() | Удаляет один или несколько атрибутов у выбранных элементов. |
| .removeClass() | Удаляет один класс или несколько классов у каждого выбранного элемента. |
| .removeProp() | Позволяет удалить у выбранного элемента, или элементов интересующее свойство. |
| .replaceAll() | Позволяет заменить каждый целевой элемент набором соответствующих элементов |
| .replaceWith() | Заменяет выбранные элементы новым содержимым. |
| .scrollLeft() | Возвращает горизонтальную позицию прокрутки первого совпавшего элемента в наборе, или устанавливает горизонтальную позицию прокрутки всем выбранным элементам в наборе. |
| .scrollTop() | Возвращает вертикальную позицию прокрутки первого совпавшего элемента в наборе, или устанавливает вертикальную позицию прокрутки всем выбранным элементам в наборе. |
| .text() | Задает или возвращает текстовое содержимое выбранных элементов. |
| .toggleClass() | Добавляет или удаляет один, или несколько классов каждому выбранному элементу. |
| .unwrap() | Удаляет у выбранных элементов родительский элемент из дерева DOM, при этом вложенные элементы остаются на своем месте. |
| .val() |
Читает текущее значение первого элемента формы или задаёт значение выбранным элементам. Не изменяет
автоматически HTML-атрибут и не вызывает change.
|
| .width() | Получает текущее вычисленное значение ширины для первого элемента в наборе совпавших элементов, или устанавливает ширину каждого соответствующего элемента. |
| .wrap() | Обертывает каждый совпавший элемент, или элементы в наборе, выбранными HTML элементами. |
| .wrapAll() | Обертывает все элементы (элемент) в наборе, выбранным HTML элементом. |
| .wrapInner() | Обертывает содержимое каждого HTML элемента, или элементов выбранными элементами. |
$()
|
Создаёт коллекцию из выбранных или переданных элементов, создаёт узлы из HTML либо регистрирует обработчик готовности DOM. |
Данные и устройство коллекции
| API | Описание |
|---|---|
.data()
|
Сохраняет данные для выбранных элементов или читает данные первого элемента. Значения
data-* читаются при первом обращении и затем хранятся во внутреннем кеше jQuery.
Документация.
|
.removeData()
|
Удаляет значения из кеша данных jQuery, но не HTML-атрибуты data-*. Для удаления атрибута
используйте .removeAttr().
Документация.
|
.get()
|
Без аргумента возвращает массив DOM-элементов коллекции; с индексом — один DOM-элемент. Отрицательный индекс отсчитывается с конца. Документация. |
.index()
|
Без аргумента возвращает позицию первого элемента среди соседей. С аргументом ищет элемент в коллекции или
позицию первого элемента среди совпадений селектора; при отсутствии возвращает -1.
Документация.
|
.toArray()
|
Возвращает обычный массив DOM-элементов коллекции для работы с методами массива. Документация. |
.length
|
Число элементов в коллекции jQuery; у пустой коллекции равно 0.
Документация.
|
.jquery
|
Строка с номером версии библиотеки, например "4.0.0"; доступна также через
$.fn.jquery. Документация.
|
.pushStack()
|
Создаёт новую коллекцию из переданных элементов и сохраняет предыдущую в стеке для .end().
Применяется при разработке методов обхода в плагинах.
Документация.
|