Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Element: výběr potomků, kontrola atributů a měření obdélníků

Pomocí `querySelectorAll()` najdeš odpovídající potomky, pomocí `hasAttribute()` ověříš přítomnost atributu a pomocí `getClientRects()` zjistíš geometrii rozložení. Žádný z těchto výsledků sám o sobě neříká, zda uživatel prvek vidí.

Verze: Current web platform; runtime support varies

Syntaxe

element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectList

Tyto tři metody rozhraní Element odpovídají na různé otázky: co vyhovuje v DOM, který atribut je přítomen a jaké obdélníky vzniknou při rozložení stránky. Patří k webové platformě, nikoli k ECMAScript 2024. Příklad vyžaduje prohlížeč s DOM a mechanismem pro výpočet rozložení.

element.querySelectorAll(selectors) přijímá řetězec s CSS selektorem nebo seznamem selektorů. Vrací statický NodeList odpovídajících potomků v pořadí dokumentu, bez samotného prvku, na němž metodu voláš. Bez shody dostaneš prázdný seznam; neplatná syntaxe selektoru vyvolá výjimku DOMException s názvem SyntaxError. Změny DOM nemění, které uzly jsou v uloženém seznamu, ale položky stále odkazují na původní uzly. Při vyhodnocování selektoru mohou hrát roli i předci vně prvku; :scope > .card vybere pouze jeho přímé potomky s třídou .card. CSS.escape() použij na dynamický identifikátor, nikoli na celý selektor.

element.hasAttribute(name) kontroluje, zda má daný prvek uvedený atribut: i pro prázdnou hodnotu vrátí true, při absenci atributu vrátí false. Hodnotu nečte a potomky nekontroluje. Hodnotu přečteš pomocí getAttribute(name). Pro hledání podle jmenného prostoru a místního názvu bez předpony použij hasAttributeNS(namespace, localName).

element.getClientRects() nepřijímá žádné argumenty. U prvku HTML obvykle vrací kolekci objektů DOMRect, jeden pro každý fragment CSS boxu až po vnější hranu rámečku. Řádkový prvek rozdělený do více řádků může mít více obdélníků. Souřadnice jsou v pixelech CSS vzhledem k zobrazovací oblasti a zohledňují posun při rolování. Po změně rozložení měř znovu. Jeden obalový obdélník získáš pomocí getBoundingClientRect().

display: none vede k prázdné kolekci obdélníků, prvek ale z DOM neodstraní a nevyloučí shodu se selektorem. Neprázdná kolekce nedokazuje viditelnost: prvek může být mimo zobrazovací oblast nebo mít visibility: hidden. hasAttribute("hidden") ověřuje jen přítomnost atributu HTML, nikoli stav vykreslení.

Příklady

<!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>

Výsledek

flag=true boxes=1
flag=false boxes=0
saved=2 fresh=1

Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup v konzoli. Vyhovují oba potomci: první má prázdný atribut `data-flag` a jeden obdélník, druhý atribut nemá a kvůli `display: none` nemá žádný obdélník. Po odebrání druhého potomka má uložený seznam stále dvě položky, ale nový dotaz vrátí jednu.

Související lekce

  • JavaScript · Lekce 40 · Středně pokročilá · Verze: 3

Zdroje