Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element: classi, contenuto e presenza degli attributi

Usa `className` per leggere o sostituire la stringa delle classi, `innerHTML` per leggere o sostituire il contenuto come markup e `toggleAttribute()` per modificare la presenza di un attributo.

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

Sintassi

element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)

Queste sono API del DOM, non funzionalità di ECMAScript 2024. La versione di ECMAScript indicata in questa scheda non ne determina la disponibilità. Richiedono un ambiente che esponga le API DOM pertinenti; il supporto dipende dall’ambiente di esecuzione.

Su un elemento HTML, className riflette l’attributo class come stringa di nomi di classi separati da caratteri di spaziatura. Un’assegnazione sostituisce l’intera stringa. Per modificare una sola classe senza toccare le altre, usa classList. Su un elemento SVG, className può essere un SVGAnimatedString; usa getAttribute('class') o setAttribute('class', value) per accedere direttamente all’attributo.

In lettura, innerHTML restituisce il markup HTML o XML del contenuto, senza includere l’elemento stesso o la sua radice shadow. In scrittura, il markup viene analizzato nel contesto dell’elemento e sostituisce i nodi del contenuto, anziché aggiungerne in coda. Su template viene sostituito il contenuto del modello. I listener degli eventi restano sui vecchi nodi e non vengono trasferiti ai nuovi. In un documento XML, il markup non ben formato può causare SyntaxError in scrittura, mentre un errore di serializzazione può causare InvalidStateError in lettura.

Non passare markup non attendibile direttamente a innerHTML: per impostazione predefinita non viene sanificato, con conseguente rischio di XSS. Usa textContent per mostrare testo semplice in elementi come span. Non assegnare testo non attendibile a textContent di un elemento script: il testo può essere eseguito come codice quando l’elemento viene inserito nel documento. Se serve il markup, sanifica l’input non attendibile prima di inserirlo. Se la CSP impone Trusted Types e non esiste una policy predefinita, assegnare una stringa normale genera TypeError; usa TrustedHTML prodotto da una policy adeguata.

toggleAttribute(name) rimuove un attributo presente oppure aggiunge un attributo assente con un valore vuoto. Con force, true ne garantisce la presenza senza modificare un valore esistente, mentre false ne garantisce l’assenza. Il risultato booleano indica se l’attributo è presente dopo la chiamata, non se qualcosa è cambiato. Per un attributo booleano HTML come disabled, nemmeno il valore "false" lo disattiva: conta la presenza. Su un elemento HTML in un documento HTML, le lettere ASCII del nome sono convertite in minuscolo; un nome non valido genera InvalidCharacterError.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element DOM example</title>
</head>
<body>
  <script>
    (() => {
      const button = document.createElement('button');
      button.className = 'action muted';
      button.className = 'action ready';

      button.innerHTML = '<span>Draft</span>';
      const oldLabel = button.firstElementChild;
      button.innerHTML = '<strong>Save</strong>';

      console.log(button.className);
      console.log(button.innerHTML);
      console.log(oldLabel.parentNode === null);
      console.log(button.toggleAttribute('disabled'));
      console.log(button.toggleAttribute('disabled', true));
      console.log(button.toggleAttribute('disabled', false));
    })();
  </script>
</body>
</html>

Risultato

action ready
<strong>Save</strong>
true
true
true
false

Salva l’esempio come file HTML, aprilo in un browser che non imponga Trusted Types e controlla la console di sviluppo. Il pulsante non viene aggiunto al documento. Il primo `true` conferma che il vecchio nodo dell’etichetta è stato scollegato; gli ultimi tre risultati mostrano lo stato di `disabled` dopo l’aggiunta, la conferma della presenza e la rimozione.

Lezioni correlate

  • JavaScript · Lezione 39 · Intermedio · Versione: 3

Fonti