HTML DOM querySelector()Метод
Определение и использование
Метод querySelector() возвращает первый элемент в документе, соответствующий указанному CSS-селектору.
Примечание:Метод querySelector() возвращает только первый элемент, соответствующий указанному селектору. Если нужно вернуть все элементы, используйте вместо него метод querySelectorAll().
Дополнительные сведения о CSS-селекторах см. в нашемруководстве по CSS-селекторами в нашемсправочнике по CSS-селекторам。
Поддержка браузеров
Числа в таблице указывают первую версию браузера, которая полностью поддерживает этот метод.
| Метод | |||||
|---|---|---|---|---|---|
| querySelector() | 4.0 | 8.0 | 3.5 | 3.1 | 10.0 |
Синтаксис
Значения параметров
| Параметр | Type | Описание |
|---|---|---|
| CSS-селектор | String | Обязательный. Указывает CSS-селектор для одного или нескольких элементов, которые должны совпасть. Вы можете выбирать элементы по их id, class, type, атрибуту, значению атрибута и т. д. Для нескольких селекторов разделите их запятыми, и возвращает соответствующий элемент. Совет:Чтобы узнать больше о CSS-селекторах, см. нашСправочное руководство по CSS-селекторам。 |
Технические детали
| Версия DOM: | Объект Document (Selectors Level 1) |
|---|---|
| Возвращаемое значение: | Первый элемент, соответствующий указанному CSS-селектору. Если совпадений не найдено, возвращается null. Если указан недопустимый селектор, выбрасывается исключение SYNTAX_ERR. |
Другие примеры
Пример
Получить первый элемент с class="example" в документе:
Попробуйте сами »
Пример
Получить первый элемент <p> с class="example" в документе:
Попробуйте сами »
Пример
Получить первый элемент <a> в документе, имеющий атрибут "target":
Попробуйте сами »
Пример
Следующий пример демонстрирует использование нескольких селекторов.
Предположим, вы выбираете два селектора: элементы <h2> и <h3>.
Следующий код добавит цвет фона первому элементу <h2> в документе:
<h3>Элемент h3</h3>
document.querySelector("h2, h3").style.backgroundColor = "red";
Попробуйте сами »
Однако если элемент <h3> расположен перед элементом <h2> в документе, то элементу <h3> будет задан указанный цвет фона.
<h2>Элемент h2</h2>
document.querySelector("h2, h3").style.backgroundColor = "red";
Попробуйте сами »
Связанные страницы
Справочное руководство по JavaScript:element.querySelector()
Другие расширения
Объект Document