HTML DOM querySelectorAll()Метод

Document 对象参考手册Объект Document

Примеры

Получить все элементы с class="example" в документе:

var x = document.querySelectorAll(".example");

Попробуйте сами »

Определение и использование

Метод querySelectorAll() возвращает все элементы в документе, соответствующие указанным CSS-селекторам, и возвращаетNodeListNodeList объект.

Объект NodeList представляет собой коллекцию узлов. Доступ к нему можно получить по индексу, при этом значения индекса начинаются с 0.

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

Для получения дополнительной информации о CSS-селекторах обратитесь кУчебнику по CSS-селекторам , Справочному руководству по CSS-селекторам。


Поддержка браузеров

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

Метод
querySelectorAll() 4.0 8.0 3.5 3.2 10.0

Примечание:Internet Explorer 8 поддерживает селекторы CSS2. IE9 и более поздние браузеры поддерживают селекторы CSS3.


Синтаксис

elementList = document.querySelectorAll(selectors);
  • elementList — это статический объект NodeList.
  • selectors — это строка, содержащая один или несколько CSS-селекторов, разделённых запятыми.

Значения параметров

Параметр Type Описание
CSS-селектор String Обязательный. Указывает один или несколько элементов, соответствующих указанному CSS-селектору(ам). Элементы можно получить с помощью id, class, type, attribute, attribute value и т. д. в качестве селекторов.

Несколько селекторов разделяются запятыми (,).

Совет:Чтобы узнать больше о CSS-селекторах, обратитесь кСправочному руководству по CSS-селекторам。

Метод

Версия DOM: Объект Document уровня 1
Возвращаемое значение: Объект NodeList, представляющий все элементы в документе, соответствующие указанному CSS-селектору(ам). NodeList — это статический объект NodeList. Если указанный селектор недопустим, выбрасывается исключение SYNTAX_ERR.

Другие примеры

Пример

Получить все элементы <p> в документе и установить цвет фона для первого подходящего элемента <p> (индекс 0):

//Получить все элементы <p> в документе var x = document.querySelectorAll("p"); //Установить цвет фона первого элемента <p> x[0].style.backgroundColor = "red";

Попробуйте сами »

Пример

Получить все элементы <p> с class="example" в документе и установить цвет фона для первого подходящего элемента <p> (индекс 0):

//Получить все элементы <p> с class="example" в документе var x = document.querySelectorAll("p.example"); //Установить цвет фона первого элемента <p> с class="example" x[0].style.backgroundColor = "red";

Попробуйте сами »

Пример

Подсчитайте количество элементов <p> с class="example" в документе (используя свойство length объекта NodeList):

var x = document.querySelectorAll(".example").length;

Попробуйте сами »

Пример

Задайте цвет фона для всех элементов с class="example" в документе:

var x = document.querySelectorAll(".example"); var i; for (i = 0; i < x.length; i++) { x[i].style.backgroundColor = "red"; }

Попробуйте сами »

Пример

Задайте цвет фона для всех элементов <p> в документе:

var x = document.querySelectorAll("p"); var i; for (i = 0; i < x.length; i++) { x[i].style.backgroundColor = "red"; }

Попробуйте сами »

Пример

Найдите все теги <a> в документе, содержащие атрибут "target", и задайте для них границу:

var x = document.querySelectorAll("a[target]"); var i; for (i = 0; i < x.length; i++) { x[i].style.border = "10px solid red"; }

Попробуйте сами »

Пример

Найдите каждый элемент <p>, родительским элементом которого является <div>, и задайте для них цвет фона:

var x = document.querySelectorAll("div > p"); var i; for (i = 0; i < x.length; i++) { x[i].style.backgroundColor = "red"; }

Попробуйте сами »

Пример

Задайте цвет фона для всех элементов <h2>, <div> и <span> в документе:

var x = document.querySelectorAll("h2, div, span"); var i; for (i = 0; i < x.length; i++) { x[i].style.backgroundColor = "red"; }

Попробуйте сами »

Связанные статьи

Учебник CSS:CSS-селекторы

Справочник по CSS:Справочник по селекторам CSS

Учебник по JavaScript:Списки узлов JavaScript HTML DOM

Справочник по HTML DOM:document.querySelector()

Справочник по HTML DOM:element.querySelectorAll()


Document 对象参考手册Объект Document

Другие расширения