CKTIS / JavaScript
Element.innerHTML a Element.className
Pomocou `innerHTML` prečítaš alebo nahradíš obsah prvku a pomocou `className` prečítaš alebo nastavíš jeho triedy CSS.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;innerHTML a className sú dve samostatné vlastnosti inštancií DOM, nie metódy. Patria k webovej platforme, nie k ECMAScriptu 2024: prostredie JavaScriptu bez DOM ich neposkytuje.
Pri čítaní element.innerHTML sa aktuálny obsah serializuje do reťazca, bez značiek samotného prvku a bez koreňov tieňového DOM. Pri priradení sa podľa typu dokumentu spracuje fragment HTML alebo XML a nahradia sa uzly potomkov, nie samotný prvok. Aj rovnaký značkovací kód vytvorí nové uzly: staré referencie stále odkazujú na odstránené uzly a ich poslucháče udalostí sa neprenesú. V prvku template sa priradením nahradia uzly potomkov objektu DocumentFragment, na ktorý odkazuje content, nie samotný fragment. Priradenie null funguje ako priradenie "". V dokumente XML spôsobí nesprávne utvorený fragment SyntaxError a zlyhanie serializácie môže spôsobiť InvalidStateError; oba sú názvy výnimky DOMException.
V prvku HTML element.className odráža atribút class ako jeden reťazec s názvami oddelenými bielymi znakmi. Priradením sa nahradí celá hodnota atribútu bez zmeny uzlov potomkov. Ak chceš zmeniť jednu triedu a ostatné zachovať, použi classList.add(), classList.remove() alebo classList.toggle(). V SVG môže byť className objektom SVGAnimatedString; na čítanie alebo zápis celého atribútu použi radšej getAttribute("class") alebo setAttribute("class", value). getAttribute() vráti null, ak atribút chýba, a "", ak je prítomný, ale prázdny.
innerHTML vstup predvolene nečistí. Nedôveryhodné údaje doň nikdy nepriraďuj priamo, pretože môžu viesť k útoku XSS. Na vloženie obyčajného textu do bežného prvku použi textContent, aby sa text nespracoval ako HTML. Ak potrebuješ značky z nedôveryhodného zdroja, najprv ich bezpečne očisti. Ak je podporované Trusted Types, príslušná politika môže vrátiť očistený obsah ako TrustedHTML; samotný typ nič nečistí. Ak CSP vynucuje Trusted Types a neexistuje predvolená politika, priradenie reťazca vyvolá TypeError.
Prí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ýsledok
card active highlight true false <strong>Ready</strong>
Ulož celý príklad ako súbor HTML a otvor ho v prehliadači bez CSP vynucujúcej Trusted Types. Výstup sa zobrazí v konzole prehliadača. Prvok zostáva mimo dokumentu. Zmena tried zachová uzol potomka, priradenie rovnakého HTML ho nahradí.
Súvisiace lekcie
- JavaScript · Lekcia 42 · Stredne pokročilá · Verzia: 3