CKTIS / JavaScript
HTMLElement.innerHTML: čítanie a nahrádzanie obsahu prvku
Pri čítaní vracia `innerHTML` obsah prvku ako značkový zápis. Pri priradení ho nahradí novými uzlami vytvorenými pri parsovaní, a to aj pri použití `+=`.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""HTMLElement.innerHTML je vlastnosť inštancie zdedená z Element, nie statická metóda. Pri čítaní vracia aktuálny obsah DOM ako reťazec bez značiek samotného prvku a bez koreňov Shadow DOM. Ide o serializáciu stromu, nie o kópiu pôvodného zdrojového textu.
Priradenie spracuje značkový zápis v kontexte prvku a nahradí jeho podriadené uzly, nie samotný prvok. Pri template nahradí obsah template.content. Setter prijíma reťazec alebo TrustedHTML. Web IDL prevedie null na prázdny reťazec ("") pred kontrolou Trusted Types. Ak sa reťazec dostane k parseru bez zmeny, obsah sa vyprázdni. Pri vynucovaní Trusted Types však môže predvolená politika premeniť prázdny reťazec na neprázdny značkový zápis, takže úspešné priradenie nemusí obsah vyprázdniť. Setter nevytvára deklaratívne korene Shadow DOM.
element.innerHTML += markup prečíta serializovaný zápis, pripojí nový text a znova spracuje celý výsledok. Pôvodné uzly sa odpoja a poslucháče udalostí zaregistrované priamo na nich sa neprenesú na nové uzly. Ak chceš zachovať existujúce uzly, pridaj nové pomocou append().
Nedôveryhodný vstup neodovzdávaj priamo do innerHTML: v predvolenom nastavení ho nečistí a atribúty obsluhy udalostí môžu viesť k XSS, aj keď sa vložené prvky script nespustia. Na obyčajný text použi textContent; ak potrebuješ HTML, použi overený nástroj na jeho čistenie. Samotná politika Trusted Types čistenie nezaručuje.
Ide o API webovej platformy, nie o súčasť ECMAScript 2024. Podpora Trusted Types závisí od prostredia. Ak CSP vynucuje Trusted Types a neexistuje predvolená politika, priradenie reťazca vyvolá TypeError. Parser HTML sa zotavuje zo syntaktických chýb, no v dokumente XML môže nesprávne utvorený fragment pri priradení vyvolať SyntaxError. Ak sa obsah nedá serializovať ako správne utvorené XML, čítanie môže vyvolať InvalidStateError.
Prí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ýsledok
<strong>Hello</strong><em> again</em> Hello again false true
Ulož príklad ako súbor HTML, otvor ho v prehliadači bez vynucovania Trusted Types a pozri si vývojársku konzolu. Prvé dva riadky porovnávajú značkový zápis s textom; posledné dva ukazujú, že prvý uzol bol nahradený a už nemá rodiča.
Súvisiace lekcie
- JavaScript · Lekcia 31 · Pokročilá · Verzia: 4