CKTIS / JavaScript
Element: избиране на потомци, проверка на атрибути и измерване на правоъгълници
Използвай `querySelectorAll()`, за да намериш съвпадащите потомци, `hasAttribute()`, за да провериш дали има даден атрибут, и `getClientRects()`, за да отчетеш геометрията на оформлението. Никой от резултатите сам по себе си не показва дали потребителят вижда елемента.
Версия: Current web platform; runtime support varies
Синтаксис
element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectListТези три метода на Element отговарят на различни въпроси: какво съвпада в DOM, кой атрибут присъства и какви правоъгълници се получават при оформлението на страницата. Те са част от уеб платформата, а не от ECMAScript 2024. За примера е нужен браузър с DOM и механизъм за изчисляване на оформлението.
element.querySelectorAll(selectors) приема низ с CSS селектор или списък от селектори. Връща статичен NodeList със съвпадащите потомци по реда им в документа, без самия елемент, върху който е извикан методът. Ако няма съвпадения, списъкът е празен; невалидният синтаксис на селектора предизвиква изключение DOMException с име SyntaxError. Промените в DOM не променят кои възли са в запазения списък, но записите продължават да сочат към първоначалните възли. Предшественици извън елемента също могат да участват при съпоставянето; :scope > .card избира само преките му деца с клас .card. Прилагай CSS.escape() върху динамичния идентификатор, а не върху целия селектор.
element.hasAttribute(name) проверява дали посоченият атрибут присъства върху този елемент: връща true дори при празна стойност и false, ако атрибутът липсва. Методът не чете стойността и не проверява потомците. За прочитане на стойността използвай getAttribute(name). За проверка по пространство от имена и локално име без префикс използвай hasAttributeNS(namespace, localName).
element.getClientRects() не приема аргументи. За HTML елемент обикновено връща колекция от обекти DOMRect — по един за всеки фрагмент от CSS кутията до външния ръб на рамката. Вграден в реда елемент, разположен на няколко реда, може да има няколко правоъгълника. Координатите са в CSS пиксели спрямо видимата област и отчитат превъртането. След промяна в оформлението измери отново. За един общ обхващащ правоъгълник използвай getBoundingClientRect().
display: none дава празна колекция от правоъгълници, но не премахва елемента от DOM и не пречи той да съвпадне със селектор. Непразната колекция не доказва видимост: елементът може да е извън видимата област или да има visibility: hidden. hasAttribute("hidden") проверява само наличието на HTML атрибута, а не състоянието на визуализиране.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element layout example</title>
</head>
<body>
<script>
(() => {
const root = document.createElement("section");
const shown = document.createElement("div");
const hidden = document.createElement("div");
shown.className = hidden.className = "card";
shown.setAttribute("data-flag", "");
shown.style.cssText = "display: block; width: 10px; height: 10px";
hidden.style.display = "none";
root.append(shown, hidden);
document.body.append(root);
try {
const selector = ":scope > .card";
const cards = root.querySelectorAll(selector);
for (const card of cards) {
console.log(`flag=${card.hasAttribute("data-flag")} boxes=${card.getClientRects().length}`);
}
hidden.remove();
console.log(`saved=${cards.length} fresh=${root.querySelectorAll(selector).length}`);
} finally {
root.remove();
}
})();
</script>
</body>
</html>Резултат
flag=true boxes=1 flag=false boxes=0 saved=2 fresh=1
Запази примера като HTML файл, отвори го в браузър и провери резултата в конзолата. И двете деца съвпадат: първото има празен атрибут `data-flag` и един правоъгълник, а второто няма атрибута и заради `display: none` няма правоъгълници. След премахването на второто дете запазеният списък все още има два записа, а новата заявка връща един.
Свързани уроци
- JavaScript · Урок 40 · Средно · Версия: 3