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

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.namespaceURI

innerHTML 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

Zdroje