База знанияИзпитен център
BGБългарски
Избери език13

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

Източници