Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.innerHTML i Element.className

Użyj `innerHTML`, by odczytać lub zastąpić zawartość elementu, a `className`, by odczytać lub ustawić jego klasy CSS.

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

Składnia

element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;

innerHTML i className to dwie osobne właściwości instancji DOM, a nie metody. Należą do platformy webowej, nie do ECMAScript 2024: środowisko JavaScript bez DOM ich nie udostępnia.

element.innerHTML zwraca łańcuch znaków utworzony przez serializację bieżącej zawartości, bez znaczników samego elementu i bez korzeni shadow DOM. Przypisanie parsuje fragment HTML lub XML zależnie od dokumentu i zastępuje węzły potomne, nie sam element. Nawet identyczny kod znacznikowy tworzy nowe węzły: stare referencje nadal wskazują usunięte węzły, a ich nasłuchiwacze zdarzeń nie przechodzą na nowe. W przypadku template przypisanie zastępuje węzły potomne fragmentu, na który wskazuje content, a nie sam DocumentFragment. Przypisanie null działa jak "". W dokumencie XML niepoprawnie sformułowany fragment powoduje SyntaxError, a niemożność serializacji może spowodować InvalidStateError; oba wyjątki to DOMException.

Dla elementu HTML element.className odzwierciedla atrybut class jako jeden łańcuch znaków z nazwami oddzielonymi białymi znakami. Przypisanie zastępuje całą wartość atrybutu bez zmiany węzłów potomnych. Aby zmienić jedną klasę i zachować pozostałe, użyj classList.add(), classList.remove() lub classList.toggle(). W SVG className może być obiektem SVGAnimatedString; do odczytu lub zapisu całego atrybutu użyj wtedy getAttribute("class") lub setAttribute("class", value). Brak atrybutu daje null, a obecny, lecz pusty atrybut daje "" przy odczycie przez getAttribute().

innerHTML domyślnie nie oczyszcza danych wejściowych: nie przypisuj do niego niezaufanych danych, bo grozi to atakiem XSS. Aby wstawić zwykły tekst do typowego elementu, użyj textContent; tekst nie jest wtedy interpretowany jako HTML. Jeśli potrzebujesz znaczników z niezaufanego źródła, najpierw je oczyść. Tam, gdzie przeglądarka obsługuje Trusted Types, polityka może zwracać oczyszczoną treść jako TrustedHTML; sam typ nie zapewnia oczyszczania. Gdy CSP wymusza Trusted Types i nie ma polityki domyślnej, przypisanie łańcucha znaków zgłasza TypeError.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>innerHTML and className</title>
</head>
<body>
  <script>
    {
      const card = document.createElement("div");
      card.className = "card muted";
      card.innerHTML = "<strong>Ready</strong>";
      const original = card.firstElementChild;

      card.className = "card active";
      card.classList.add("highlight");
      console.log(card.className);
      console.log(card.firstElementChild === original);

      card.innerHTML = "<strong>Ready</strong>";
      console.log(card.firstElementChild === original);
      console.log(card.innerHTML);
    }
  </script>
</body>
</html>

Wynik

card active highlight
true
false
<strong>Ready</strong>

Zapisz cały przykład jako plik HTML i otwórz go w przeglądarce bez wymuszania Trusted Types przez CSP. Wynik pojawi się w konsoli przeglądarki. Element pozostaje poza dokumentem. Zmiana klas zachowuje węzeł potomny, a przypisanie identycznego HTML go zastępuje.

Powiązane lekcje

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

Źródła