CKTIS / JavaScript
HTMLElement.innerHTML: čtení a nahrazování obsahu prvku
Při čtení vrací `innerHTML` obsah prvku jako značkový zápis. Při přiřazení jej nahradí novými uzly vytvořenými při parsování, a to i při použití `+=`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""HTMLElement.innerHTML je vlastnost instance zděděná z Element, nikoli statická metoda. Při čtení vrací aktuální obsah DOM jako řetězec bez značek samotného prvku a bez kořenů Shadow DOM. Jde o serializaci stromu, nikoli o kopii původního zdrojového textu.
Přiřazení zpracuje značkový zápis v kontextu prvku a nahradí jeho podřízené uzly, nikoli prvek samotný. U template nahradí obsah template.content. Setter přijímá řetězec nebo TrustedHTML. Web IDL převede null na prázdný řetězec ("") před kontrolou Trusted Types. Pokud se řetězec dostane k parseru beze změny, obsah se vyprázdní. Při vynucování Trusted Types však může výchozí zásada prázdný řetězec převést na neprázdný značkový zápis, takže úspěšné přiřazení nemusí obsah vyprázdnit. Setter nevytváří deklarativní kořeny Shadow DOM.
element.innerHTML += markup přečte serializovaný zápis, připojí nový text a znovu zpracuje celý výsledek. Původní uzly se odpojí a posluchače událostí registrované přímo na nich se nepřenášejí na nové uzly. Chceš-li stávající uzly zachovat, přidávej nové pomocí append().
Nedůvěryhodný vstup nepředávej přímo do innerHTML: ve výchozím nastavení ho nečistí a atributy obsluhy událostí mohou vést k XSS, i když se vložené prvky script nespustí. Pro prostý text použij textContent; potřebuješ-li HTML, použij prověřený nástroj k jeho čištění. Samotná zásada Trusted Types čištění nezaručuje.
Jde o API webové platformy, nikoli o součást ECMAScript 2024. Podpora Trusted Types závisí na prostředí. Pokud CSP vynucuje Trusted Types a neexistuje výchozí zásada, přiřazení řetězce vyvolá TypeError. Parser HTML se zotavuje ze syntaktických chyb, ale v dokumentu XML může nesprávně utvořený fragment při přiřazení vyvolat SyntaxError. Pokud obsah nelze serializovat jako správně utvořené XML, může čtení vyvolat InvalidStateError.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML example</title>
</head>
<body>
<script>
const box = document.createElement("div");
box.innerHTML = "<strong>Hello</strong>";
const original = box.firstElementChild;
box.innerHTML += "<em> again</em>";
console.log(box.innerHTML);
console.log(box.textContent);
console.log(original === box.firstElementChild);
console.log(original.parentNode === null);
</script>
</body>
</html>Výsledek
<strong>Hello</strong><em> again</em> Hello again false true
Ulož příklad jako soubor HTML, otevři ho v prohlížeči bez vynucování Trusted Types a podívej se do vývojářské konzole. První dva řádky porovnávají značkový zápis s textem; poslední dva ukazují, že první uzel byl nahrazen a už nemá rodiče.
Související lekce
- JavaScript · Lekce 31 · Pokročilá · Verze: 4