Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element: selezionare discendenti, controllare attributi e misurare rettangoli

Usa `querySelectorAll()` per trovare i discendenti corrispondenti, `hasAttribute()` per controllare se un attributo è presente e `getClientRects()` per leggere la geometria del layout. Nessuno di questi risultati basta a stabilire se l’elemento è visibile.

Versione: Current web platform; runtime support varies

Sintassi

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

Questi tre metodi di Element rispondono a domande diverse: cosa corrisponde nel DOM, quale attributo è presente e quali rettangoli produce il layout? Sono API della piattaforma web, non funzionalità di ECMAScript 2024. L’esempio richiede un browser con DOM e motore di layout.

element.querySelectorAll(selectors) accetta una stringa contenente un selettore CSS o una lista di selettori. Restituisce una NodeList statica dei discendenti corrispondenti, nell’ordine del documento, senza includere l’elemento su cui è chiamato. Se non ci sono corrispondenze, la lista è vuota; una sintassi non valida genera una DOMException chiamata SyntaxError. Le modifiche al DOM non cambiano quali nodi compaiono nella lista salvata, ma le voci continuano a riferirsi ai nodi originali. Gli antenati esterni all’elemento possono contribuire alla corrispondenza; :scope > .card seleziona solo i suoi figli diretti con classe .card. Applica CSS.escape() all’identificatore dinamico, non all’intero selettore.

element.hasAttribute(name) controlla se l’attributo con quel nome è presente sull’elemento: restituisce true anche se il valore è vuoto e false se l’attributo è assente. Non legge il valore e non controlla i discendenti. Per leggere il valore usa getAttribute(name). Per verificare un attributo per spazio dei nomi e nome locale senza prefisso usa hasAttributeNS(namespace, localName).

element.getClientRects() non accetta argomenti. Per un elemento HTML di solito restituisce una raccolta di oggetti DOMRect, uno per ogni frammento del border box CSS, che comprende il bordo ma non il margine. Un elemento in linea distribuito su più righe può avere diversi rettangoli. Le coordinate sono in pixel CSS rispetto alla viewport e tengono conto dello scorrimento. Ripeti la misura dopo le modifiche al layout. Se vuoi un unico rettangolo che racchiuda l’elemento, usa getBoundingClientRect().

display: none produce una raccolta vuota di rettangoli, ma non rimuove l’elemento dal DOM né impedisce che corrisponda a un selettore. Una raccolta non vuota non prova la visibilità: l’elemento può essere fuori dalla viewport o avere visibility: hidden. hasAttribute("hidden") controlla solo la presenza dell’attributo HTML, non lo stato di rendering.

Esempi

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

Risultato

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

Salva l’esempio come file HTML, aprilo in un browser e controlla il risultato nella console. Entrambi i figli corrispondono: il primo ha un attributo `data-flag` vuoto e un rettangolo; il secondo non ha l’attributo e non ha rettangoli per via di `display: none`. Dopo la rimozione del secondo, la lista salvata ha ancora due voci, mentre una nuova ricerca ne restituisce una.

Lezioni correlate

  • JavaScript · Lezione 40 · Intermedio · Versione: 3

Fonti