Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

`className` i `innerHTML`: klasy i zawartość elementu

`className` odzwierciedla atrybut `class`, a `innerHTML` odczytuje lub zastępuje zawartość elementu jako znaczniki. Tylko `innerHTML` przekazuje zapisany tekst do parsera znaczników.

Wersja: Current web platform; runtime support varies

Składnia

element.className;
htmlElement.className = classString;
element.innerHTML;
element.innerHTML = markup;

className i innerHTML to dwie właściwości instancji DOM, a nie metody ani funkcje języka ECMAScript. Udostępnia je środowisko z DOM; sam silnik JavaScript ich nie zapewnia.

W elemencie HTML className odczytuje atrybut class jako ciąg znaków (pusty, gdy atrybutu brak), a przypisanie zastępuje całą wartość atrybutu. Aby dodać, usunąć lub przełączyć pojedynczą klasę bez utraty pozostałych, użyj classList.add(), remove() lub toggle(). W SVG className może zwracać obiekt SVGAnimatedString, a nie ciąg znaków. W kodzie obsługującym oba rodzaje elementów użyj getAttribute("class") i setAttribute("class", value) do odczytu i zapisu tekstu atrybutu. Brak atrybutu oznacza, że getAttribute() zwróci null.

Odczyt innerHTML serializuje zawartość jako HTML lub XML, bez znaczników samego elementu i bez korzeni Shadow DOM. Nie musi odtworzyć pierwotnego tekstu źródłowego. Przypisanie analizuje fragment w kontekście elementu i zastępuje jego dzieci, zachowując sam element. W przypadku template zastępuje zawartość szablonu. Stare węzły zostają odłączone; zachowane odwołania nadal wskazują na nie, a ich nasłuchiwacze zdarzeń nie przechodzą na nowe węzły. W dokumencie XML niepoprawnie uformowany fragment powoduje wyjątek DOMException o nazwie SyntaxError.

innerHTML nie oczyszcza znaczników. Nawet jeśli wstawione elementy script się nie wykonują, atrybuty obsługi zdarzeń wciąż mogą umożliwić XSS. Do wstawiania zwykłego tekstu w typowym elemencie użyj textContent; jeśli niezaufane znaczniki są konieczne, najpierw je oczyść. Gdy obsługiwana polityka CSP wymusza Trusted Types, ciąg znaków bez polityki domyślnej powoduje TypeError; zamiast niego można przekazać TrustedHTML utworzone przez politykę, która oczyszcza dane.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>className and innerHTML</title>
<script>
  const card = document.createElement("div");
  const oldChild = document.createElement("span");
  card.append(oldChild);

  card.className = "card draft";
  card.className = "card ready";
  console.log(card.className);
  console.log(oldChild.parentNode === card);

  card.innerHTML = "<strong>Ready</strong>";
  console.log(card.innerHTML);
  console.log(oldChild.parentNode === null);
</script>

Wynik

card ready
true
<strong>Ready</strong>
true

Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź komunikaty w konsoli. Pierwsze `true` potwierdza, że zmiana klas zachowuje poprzednie dziecko; drugie, że przypisanie do `innerHTML` je odłącza.

Powiązane lekcje

  • JavaScript · Lekcja 11 · Zaawansowany · Wersja: 4

Źródła