CKTIS / JavaScript
Element.innerHTML, tagName a namespaceURI
Čtěte a nahrazujte značkovaný obsah prvku DOM a rozlišujte prvky podle místního názvu a jmenného prostoru, když jsou HTML a SVG v jednom stromu.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
element.innerHTML
element.innerHTML = markup
element.tagName
element.namespaceURIinnerHTML vrací aktuální obsah prvku jako serializovaný řetězec, bez značek samotného prvku a bez kořenů Shadow DOM. Při přiřazení řetězce nebo hodnoty TrustedHTML se fragment zpracuje v kontextu prvku a nahradí jeho podřízené uzly, nikoli samotný prvek. Odkazy na původní uzly stále míří na původní objekty, ne na nové uzly. U prvku HTML template se čtení a zápis týkají jeho content. Přiřazení null odpovídá přiřazení prázdného řetězce.
Dokument HTML používá parser HTML, který se dokáže zotavit z chyb ve značkách. Dokument XML, včetně XHTML poskytovaného jako XML, používá parser XML. Pokud fragment není správně utvořený, vyvolá se výjimka DOMException s názvem SyntaxError.
tagName je kvalifikovaný název pouze pro čtení, včetně předpony, pokud existuje. Písmena ASCII v názvu se převádějí na velká pouze u prvků ve jmenném prostoru HTML, jejichž dokument je HTML. Také namespaceURI je pouze pro čtení: vrací URI jmenného prostoru určeného při vytvoření prvku, nebo null, pokud prvek do žádného jmenného prostoru nepatří. Přesunutí prvku ani změna atributu xmlns hodnotu nezmění. Ve stromu s více jmennými prostory porovnávejte namespaceURI a localName (název bez předpony). Pomocí document.createElementNS() zvolíte jmenný prostor výslovně při vytváření prvku.
Nepřiřazujte do innerHTML nedůvěryhodný značkovaný obsah. Ve výchozím nastavení se nečistí a může umožnit útok XSS, například přes atributy obsluhy událostí. Pro prostý text použijte textContent. Pokud CSP vynucuje Trusted Types, přiřazení běžného řetězce bez výchozí politiky vyvolá TypeError. Hodnota TrustedHTML je jen tak bezpečná jako politika, která ji vytvořila. Tato API patří k webové platformě, nikoli k ECMAScriptu 2024; v běhových prostředích bez DOM s nimi nepočítejte.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML and SVG element names</title>
</head>
<body>
<script>
const container = document.createElement('div');
const previous = document.createElement('span');
container.appendChild(previous);
container.innerHTML = '<a>HTML</a><svg><a>SVG</a></svg>';
const htmlLink = container.firstElementChild;
const svgLink = container.lastElementChild.firstElementChild;
console.log(container.innerHTML);
for (const link of [htmlLink, svgLink]) {
console.log(`${link.tagName} | ${link.localName} | ${link.namespaceURI}`);
}
console.log(previous.parentNode === null);
</script>
</body>
</html>Výsledek
<a>HTML</a><svg><a>SVG</a></svg> A | a | http://www.w3.org/1999/xhtml a | a | http://www.w3.org/2000/svg true
Uložte příklad jako soubor `.html` a otevřete ho přímo v prohlížeči. Výstup najdete ve vývojářské konzoli. Oba prvky mají `localName` rovno `a`, ale jejich `tagName` a `namespaceURI` se liší. Závěrečné `true` znamená, že původní podřízený uzel už nemá rodičovský uzel.
Související lekce
- JavaScript · Lekce 16 · Pokročilá · Verze: 4