Spec-Zone.ru › Web APIs

DocumentFragment: метод querySelector()

Базовая реализация Широко доступна

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Узнать больше
  • Посмотреть полную совместимость
  • Отправить отзыв

Метод DocumentFragment.querySelector() возвращает первый элемент, или null, если совпадений не найдено, внутри DocumentFragment (используя обход узлов документа по принципу предварительного обхода в глубину) соответствующий заданной группе селекторов.

Если селектор соответствует идентификатору, и этот идентификатор ошибочно используется несколько раз в документе, метод возвращает первый соответствующий элемент.

Если указанные в параметре селекторы некорректны, возникает исключение DOMException со значением SYNTAX_ERR.

Синтаксис

querySelector(selectors)

Параметры

selectors

Строка, содержащая один или несколько CSS-селекторов, разделенных запятыми.

Возвращаемое значение

Объект Element, представляющий первый элемент в документе, соответствующий заданному набору CSS-селекторов, или null, если совпадений нет.

Примеры

Базовый пример

В этом базовом примере возвращается первый элемент в DocumentFragment с классом myclass.

const el = documentfragment.querySelector(".myclass");

Синтаксис CSS и аргумент метода

Строковый аргумент, передаваемый методу querySelector, должен соответствовать синтаксису CSS. Для соответствия ID или селекторам, не соответствующим синтаксису CSS (например, при неправильном использовании точки с запятой или пробела), необходимо экранировать неправильный символ двойным обратным слешем:

<div id="foo\bar"></div>
<div id="foo:bar"></div>

<script>
  document.querySelector("#foo\bar"); // Does not match anything
  document.querySelector("#foo\\\\bar"); // Match the first div
  document.querySelector("#foo:bar"); // Does not match anything
  document.querySelector("#foo\\:bar"); // Match the second div
</script>

Спецификации

Спецификация
DOM
# ref-for-dom-parentnode-queryselector①

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
querySelector 2 12 3.5 10 4 18 4 10.1 3 1.0 ≤37

См. также

  • Интерфейс DocumentFragment, к которому он относится.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/querySelector

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API