Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Selezionare un discendente con querySelector() e modificarne il contenuto con innerHTML

Trova il primo discendente che corrisponde a un selettore CSS, gestisci l’assenza di risultati e leggi o sostituisci il markup dell’elemento selezionato.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

const target = root.querySelector(selectors);
if (target !== null) {
  const previousMarkup = target.innerHTML;
  target.innerHTML = markup;
}

Element.querySelector/innerHTML abbina due operazioni: trovare un elemento e lavorare con il suo contenuto. root.querySelector(selectors) accetta una stringa con un selettore CSS o un elenco di selettori separati da virgole. Restituisce il primo elemento discendente corrispondente nell’ordine dell’albero DOM, indipendentemente dall’ordine dei selettori nell’elenco. Non restituisce mai root. Se non ci sono corrispondenze, restituisce null; una sintassi non valida del selettore genera una DOMException chiamata SyntaxError. Controlla il risultato prima di leggere o assegnare una proprietà.

Il risultato deve essere un discendente di root, ma la verifica del selettore può tenere conto di antenati esterni a quel sottoalbero. Usa :scope > .message per trovare soltanto figli diretti di root con la classe message. Non è una ricerca in tutto il documento come document.querySelector().

Leggere target.innerHTML restituisce il contenuto serializzato come stringa, senza i tag dell’elemento stesso né le radici dello Shadow DOM. L’assegnazione analizza un frammento nel contesto dell’elemento e ne sostituisce i figli, non l’elemento stesso. Nel caso di un elemento template, sostituisce invece il contenuto del modello. I riferimenti conservati e i listener restano associati ai vecchi nodi scollegati, non a quelli nuovi. In un documento XML, assegnare markup non ben formato genera SyntaxError; la lettura può generare InvalidStateError se la serializzazione XML non riesce. Entrambe sono DOMException.

Non assegnare direttamente input non attendibile a innerHTML: per impostazione predefinita la proprietà non sanifica il markup e può causare XSS. Per il testo semplice usa textContent. Se serve markup da una fonte non attendibile, sanificalo prima. Trusted Types non esegue la sanificazione da solo. Se l’ambiente supporta Trusted Types e una CSP li impone, assegnare una stringa normale senza una policy predefinita adatta genera TypeError. Passa invece un valore TrustedHTML prodotto da una policy che sanifica l’input.

Queste API appartengono alla piattaforma web, non a ECMAScript 2024. Verifica che l’ambiente di esecuzione fornisca un DOM e supporti le funzionalità di sicurezza necessarie.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>querySelector() and innerHTML</title>
</head>
<body>
  <script>
    {
      const panel = document.createElement("div");
      panel.innerHTML = '<p class="message"><em>Before</em></p><p class="message">Unchanged</p>';

      const target = panel.querySelector(".message");
      if (target !== null) {
        const oldChild = target.firstElementChild;
        console.log(target.innerHTML);
        target.innerHTML = "<strong>After</strong>";
        console.log(target.innerHTML);
        console.log(oldChild.parentNode === null);
        console.log(target.nextElementSibling.textContent);
      }
      console.log(panel.querySelector(".missing") === null);
    }
  </script>
</body>
</html>

Risultato

<em>Before</em>
<strong>After</strong>
true
Unchanged
true

Salva l’esempio come file `.html` e aprilo in un browser senza una CSP che imponga Trusted Types. Controlla l’output nella console del browser. Cambia solo il primo elemento corrispondente. Il suo vecchio figlio non ha più un genitore, il secondo elemento conserva il testo `Unchanged` e la ricerca senza corrispondenze restituisce `null`.

Lezioni correlate

  • JavaScript · Lezione 18 · Avanzato · Versione: 4

Fonti