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