3.11.3. Обход DOM и выборка html-элементов
1. Выборка элементов
.parent()
Возвращает родительские элементы всех элементов первоначального обернутого набора, расположенные на один уровень выше.
Параметры
селектор
.parents()
Возвращает новый набор, содержащий родительские элементы всех элементов первоначального обернутого набора. В их число входят прямые предки, а также все остальные родительские элементы, за исключением корневого элемента документа.
Параметры
селектор
.children()
Возвращает новый набор, содержащий уникальные дочерние элементы (находящиеся на первом уровне вложенности) обернутых элементов.
Параметры
селектор
.closest()
Возвращает обернутый набор, содержащий единственный элемент ближайшего предка, соответствующий указанному селектору. Переходит по цепочке родительских элементов вверх и останавливается при первом совпадении с селектором, указанным в круглых скобках.
Параметры
селектор
.prev()
Переходит к следующему элементу с тем же родителем, находящемся слева. Возвращает обернутый набор, состоящий из уникальных соседних элементов, предшествующих элементам первоначального обернутого набора.
Параметры
селектор
.prevAll()
Возвращает обернутый набор, содержащий все соседние элементы, предшествующие элементам первоначального обернутого набора.
Параметры
селектор
.prevUntil()
Возвращает обернутый набор, содержащий все соседние элементы, предшествующие элементам первоначального обернутого набора, за исключением элемента, соответствующего селектору.
Параметры
селектор
.next()
Переходит к следующему элементу с тем же родителем, находящемся справа. Возвращает обернутый набор, состоящий из уникальных соседних элементов, следующих за элементами первоначального обернутого набора.
Параметры
селектор
.nextAll()
Возвращает обернутый набор, содержащий все соседние элементы, следующие за элементами первоначального обернутого набора.
Параметры
селектор
.nextUntil()
Возвращает обернутый набор, содержащий все соседние элементы, следующие за элементами первоначального обернутого набора, за исключением элемента, соответствующего селектору.
Параметры
селектор
.siblings()
Обходит все элементы одного уровня с выбранным элементом. Возвращает обернутый набор, содержащий уникальные соседние элементы, находящиеся на одном уровне вложенности с элементами первоначального обернутого набора.
Параметры
селектор
.is()
Проверяет обернутый набор на наличие, по крайней мере, одного элемента, соответствующего заданному селектору. Возвращает true, если заданному селектору соответствует хотя бы один элемент, в противном случае false.
Параметры
селектор
.find()
Возвращает новый обернутый набор, содержащий все элементы, дочерние по отношению к элементам из первоначального набора, соответствующие заданному селектору.
Параметры
селектор
.size()
Возвращает количество элементов в обернутом наборе.
Параметры
нет
.get()
Возвращает один элемент в соответствии с заданным индексом или массив элементов, если параметр не указан. Отрицательный индекс ведет отсчет с конца обернутого набора элементов.
Параметры
число, задающее индекс возвращаемого элемента
.toArray()
Возвращает массив элементов, содержащихся в обернутом наборе.
Параметры
нет
.index()
Возвращает порядковый номер заданного элемента обернутого набора. Если указанный элемент отсутствует, возвращается значение -1. Если параметр не задан, возвращает индекс первого элемента среди элементов одного уровня вложенности.
Параметры
элемент или селектор, определяющие или идентифицирующие ссылку на элемент
.add()
Возвращает новый набор, содержащий копию элементов первоначального набора, в который добавлены элементы, определенные параметром.
Параметры
элемент, селектор, массив элементов, фрагмент html-разметки
.each()
Позволяет перебрать все элементы выборки страницы и произвести серию действий над каждым из них. Вызываемой функции передаются два параметра — индекс элемента набора и сам элемент, который устанавливается в качестве контекста функции this.
Параметры
функция
.map()
Вызывает функцию для каждого элемента в обернутом наборе и возвращает полученные значения в виде массива JavaScript. Функции передаются два параметра — индекс элемента внутри набора и сам элемент.
Параметры
функция
.end()
Используется внутри цепочки методов jQuery, возвращает предыдущий обернутый набор, чтобы применить к нему последующие операции.
Параметры
нет
.andSelf()
Объединяет два самых верхних обернутых набора в единый набор.
Параметры
нет
2. Фильтрующие методы
.first()
Возвращает из обернутого элемента только первый элемент.
Параметры
нет
.eq()
Возвращает из обернутого набора только один элемент. Отрицательное значение индекса ведет отсчет с конца набора.
Параметры
число, соответствующее индексу возвращаемого элемента
.last()
Возвращает из обернутого элемента только последний элемент.
Параметры
нет
.slice()
Возвращает набор элементов, содержащий элемент с начальным индексом и элементы до конечного индекса. Если конечный индекс отсутствует, то элементы от начального и до конца набора. Отрицательный индекс ведет отсчет элементов с конца набора, -1 вернет последний элемент.
Параметры
начальный индекс, конечный индекс (не обязательно)
.filter()
Удаляет из обернутого набора элементы, не соответствующие правилу отбора. Возвращает копию первоначального обернутого набора, из которого удалены указанные элементы. Если параметром является функция, она будет вызвана для каждого элемента в наборе, чтобы проверить, соответствует ли элемент заданному критерию отбора. Если для элемента будет возвращено значение false, то он будет удален из набора.
Параметры
элемент, селектор, массив или функция
.not()
Удаляет из выбранного множества все элементы, соответствующие заданному выражению селектора. Возвращает копию первоначального обернутого набора, из которого удалены указанные элементы. Если параметром является функция, она будет вызвана для каждого элемента в наборе, чтобы проверить, соответствует ли элемент заданному критерию отбора. Если для элемента будет возвращено значение false, то он будет удален из набора.
Параметры
элемент, селектор, массив или функция
.has()
Возвращает новый обернутый набор, содержащий элементы из первоначального набора, имеющие вложенные элементы, соответствующие заданному параметру.
Параметры
элемент или селектор