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