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() → DOMRectListTe 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