Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element: wybieranie potomków, sprawdzanie atrybutów i pomiar prostokątów

Użyj `querySelectorAll()`, aby znaleźć pasujących potomków, `hasAttribute()`, aby sprawdzić obecność atrybutu, i `getClientRects()`, aby odczytać geometrię elementu. Żaden z tych wyników sam w sobie nie potwierdza, że użytkownik widzi element.

Wersja: Current web platform; runtime support varies

Składnia

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

Te trzy metody interfejsu Element odpowiadają na różne pytania: co pasuje w drzewie DOM, jaki atrybut jest obecny i jakie prostokąty wynikają z układu strony. Należą do platformy webowej, a nie do ECMAScript 2024. Przykład wymaga przeglądarki z DOM i mechanizmem układu strony.

element.querySelectorAll(selectors) przyjmuje tekst selektora CSS lub listy selektorów. Zwraca statyczną NodeList pasujących potomków w kolejności dokumentu, bez samego elementu wywołującego. Brak dopasowań daje pustą listę; niepoprawna składnia selektora powoduje wyjątek DOMException o nazwie SyntaxError. Zmiany DOM nie zmieniają składu zapisanej listy, ale jej pozycje nadal wskazują na oryginalne węzły. Przodek spoza elementu wywołującego może uczestniczyć w dopasowaniu selektora; :scope > .card wybiera bezpośrednie dzieci tego elementu z klasą .card. Użyj CSS.escape() dla dynamicznego identyfikatora w selektorze, nie dla całego selektora.

element.hasAttribute(name) sprawdza obecność atrybutu o podanej nazwie na tym elemencie: zwraca true nawet przy pustej wartości, a false przy braku atrybutu. Nie odczytuje wartości ani nie sprawdza potomków. Do odczytu wartości służy getAttribute(name). Aby sprawdzić atrybut według przestrzeni nazw i nazwy lokalnej bez prefiksu, użyj hasAttributeNS(namespace, localName).

element.getClientRects() nie przyjmuje argumentów. Dla elementu HTML zwykle zwraca kolekcję obiektów DOMRect z osobnym prostokątem dla każdego fragmentu pola CSS do krawędzi obramowania. Element śródliniowy rozbity na kilka wierszy może mieć kilka prostokątów. Współrzędne są podane w pikselach CSS względem obszaru widoku i uwzględniają przewijanie. Zmierz ponownie po zmianie układu. Jeśli potrzebujesz jednego prostokąta obejmującego całość, użyj getBoundingClientRect().

display: none daje pustą kolekcję prostokątów, ale nie usuwa elementu z DOM ani nie wyklucza go z dopasowania. Niepusta kolekcja nie dowodzi widoczności: element może być poza obszarem widoku albo mieć visibility: hidden. hasAttribute("hidden") sprawdza jedynie obecność atrybutu HTML, nie stan renderowania.

Przykłady

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

Wynik

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

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. Wybrani zostają obaj potomkowie: pierwszy ma pusty atrybut `data-flag` i jeden prostokąt, drugi nie ma tego atrybutu i ma zero prostokątów z powodu `display: none`. Po usunięciu drugiego elementu zapisana lista nadal ma dwie pozycje, a nowe zapytanie zwraca jedną.

Powiązane lekcje

  • JavaScript · Lekcja 40 · Średniozaawansowany · Wersja: 3

Źródła