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
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(). Применяется при разработке методов обхода в плагинах. Документация.