CKTIS / JavaScript
Element.innerHTML a Element.className
Pomocí `innerHTML` přečteš nebo nahradíš obsah prvku a pomocí `className` přečteš nebo nastavíš jeho třídy CSS.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;innerHTML a className jsou dvě samostatné vlastnosti instancí DOM, nikoli metody. Patří k webové platformě, ne k ECMAScriptu 2024: prostředí JavaScriptu bez DOM je neposkytuje.
Při čtení element.innerHTML vznikne řetězec serializací aktuálního obsahu, bez značek samotného prvku a bez kořenů stínového DOM. Při přiřazení se podle typu dokumentu zpracuje fragment HTML nebo XML a nahradí se podřízené uzly, nikoli samotný prvek. I totožný zdrojový kód vytvoří nové uzly: staré reference dál odkazují na odebrané uzly a jejich posluchače událostí se nepřenášejí. U prvku template se přiřazením nahradí podřízené uzly objektu DocumentFragment, na který odkazuje content, nikoli samotný fragment. Přiřazení null funguje jako přiřazení "". V dokumentu XML způsobí nesprávně utvořený fragment SyntaxError a neúspěšná serializace může způsobit InvalidStateError; obojí jsou názvy výjimky DOMException.
U prvku HTML element.className odráží atribut class jako jeden řetězec s názvy oddělenými bílými znaky. Přiřazení nahradí celou hodnotu atributu, ale nezmění podřízené uzly. Ke změně jediné třídy se zachováním ostatních použij classList.add(), classList.remove() nebo classList.toggle(). U prvků SVG může být className objektem SVGAnimatedString; pro čtení a zápis celého atributu použij raději getAttribute("class") nebo setAttribute("class", value). getAttribute() vrací null, pokud atribut chybí, a "", pokud je přítomný, ale prázdný.
innerHTML ve výchozím nastavení vstup nečistí. Nedůvěryhodná data do něj nikdy nepřiřazuj přímo, protože mohou vést k útoku XSS. K vložení prostého textu do běžného prvku použij textContent, aby se text nezpracoval jako HTML. Pokud potřebuješ značky z nedůvěryhodného zdroje, nejprve je bezpečně očisti. Je-li podporováno Trusted Types, může příslušná politika vrátit očištěný obsah jako TrustedHTML; samotný typ nic nečistí. Pokud CSP vynucuje Trusted Types a neexistuje výchozí politika, přiřazení řetězce vyvolá TypeError.
Příklady
<!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>Výsledek
card active highlight true false <strong>Ready</strong>
Ulož celý příklad jako soubor HTML a otevři ho v prohlížeči bez CSP vynucující Trusted Types. Výstup se zobrazí v konzoli prohlížeče. Prvek zůstává mimo dokument. Změna tříd zachová podřízený uzel, přiřazení stejného HTML ho nahradí.
Související lekce
- JavaScript · Lekce 42 · Středně pokročilá · Verze: 3