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