HTML DOM querySelector()Метод

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

Пример

Получить элемент с id="demo" в документе:

document.querySelector("#demo");

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

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

Метод querySelector() возвращает первый элемент в документе, соответствующий указанному CSS-селектору.

Примечание:Метод querySelector() возвращает только первый элемент, соответствующий указанному селектору. Если нужно вернуть все элементы, используйте вместо него метод querySelectorAll().

Дополнительные сведения о CSS-селекторах см. в нашемруководстве по CSS-селекторами в нашемсправочнике по CSS-селекторам。


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

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

Метод
querySelector() 4.0 8.0 3.5 3.1 10.0


Синтаксис

document.querySelector(CSS-селекторы)

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

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

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

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

Технические детали

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


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

Пример

Получить первый элемент <p> в документе:

document.querySelector("p");

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

Пример

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

document.querySelector(".example");

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

Пример

Получить первый элемент <p> с class="example" в документе:

document.querySelector("p.example");

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

Пример

Получить первый элемент <a> в документе, имеющий атрибут "target":

document.querySelector("a[target]");

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

Пример

Следующий пример демонстрирует использование нескольких селекторов.

Предположим, вы выбираете два селектора: элементы <h2> и <h3>.

Следующий код добавит цвет фона первому элементу <h2> в документе:

<h2>Элемент h2</h2>
<h3>Элемент h3</h3>

document.querySelector("h2, h3").style.backgroundColor = "red";

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

Однако если элемент <h3> расположен перед элементом <h2> в документе, то элементу <h3> будет задан указанный цвет фона.

<h3>Элемент h3</h3>
<h2>Элемент h2</h2>

document.querySelector("h2, h3").style.backgroundColor = "red";

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


Связанные страницы

Справочное руководство по JavaScript:element.querySelector()


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

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