Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Element.innerHTML — čtení a nahrazení obsahu HTML

Element.innerHTML čte obsah prvku jako značkování HTML nebo jej nahrazuje uzly vytvořenými z dodaného značkování. Nedůvěryhodná data neočišťuje a může způsobit XSS.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const markup = element.innerHTML;
element.innerHTML = markup;

Element.innerHTML je vlastnost Web API, nikoli součást samotného ECMAScriptu. Při čtení serializuje obsah prvku bez jeho vnější značky a bez stromů shadow DOM. Výsledek se nemusí přesně shodovat s původním zdrojovým textem.

Při přiřazení se značkování analyzuje v kontextu prvku a nahradí jeho dosavadní obsah; samotný prvek se nenahrazuje. U template se mění obsah šablony. V dokumentu XML způsobí nesprávně utvořené XML chybu SyntaxError.

Zabezpečení: přiřazení ve výchozím nastavení neodstraňuje nebezpečné prvky ani atributy. To, že se vložené prvky script nespouštějí, nezabraňuje XSS, například prostřednictvím atributů obsluhy událostí. Nepředávejte přímo nedůvěryhodné HTML. Pokud jsou vynucovány Trusted Types, může být přiřazení běžného řetězce odmítnuto.

Příklad používá pouze pevné, důvěryhodné značkování. Druhé přiřazení nahradí první obsah, takže zůstane jeden potomek. Spusťte jej v prohlížeči; přítomnost Node 24 v repozitáři nedokazuje dostupnost tohoto API.

Příklady

const box = document.createElement('div');
box.innerHTML = '<strong>Hello</strong>';
console.log(box.innerHTML);
box.innerHTML = '<em>Bye</em>';
console.log(box.innerHTML);
console.log(box.children.length);

Výsledek

<strong>Hello</strong>
<em>Bye</em>
1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje