Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Element.innerHTML, tagName a namespaceURI

Čítajte a nahrádzajte značkovaný obsah prvku DOM a rozlišujte prvky podľa lokálneho názvu a menného priestoru, keď sú HTML a SVG v jednom strome.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

element.innerHTML
 element.innerHTML = markup
 element.tagName
 element.namespaceURI

innerHTML vracia aktuálny obsah prvku ako serializovaný reťazec, bez značiek samotného prvku a bez koreňov Shadow DOM. Pri priradení reťazca alebo hodnoty TrustedHTML sa fragment spracuje v kontexte prvku a nahradí jeho podriadené uzly, nie samotný prvok. Odkazy na pôvodné uzly naďalej smerujú na pôvodné objekty, nie na nové uzly. Pri prvku HTML template sa čítanie a zápis týkajú jeho content. Priradenie null zodpovedá priradeniu prázdneho reťazca.

Dokument HTML používa parser HTML, ktorý sa dokáže zotaviť z chýb v značkách. Dokument XML vrátane XHTML poskytovaného ako XML používa parser XML. Ak fragment nie je správne sformovaný, vyvolá výnimku DOMException s názvom SyntaxError.

tagName je kvalifikovaný názov určený len na čítanie vrátane predpony, ak existuje. Písmená ASCII v názve sa menia na veľké iba pri prvkoch v mennom priestore HTML, ktorých dokument je HTML. Aj namespaceURI je len na čítanie: vracia URI menného priestoru určeného pri vytvorení prvku alebo null, ak prvok nepatrí do žiadneho menného priestoru. Presunutie prvku ani zmena atribútu xmlns hodnotu nezmenia. V strome s viacerými mennými priestormi porovnávajte namespaceURI a localName (názov bez predpony). Na výslovný výber menného priestoru pri vytváraní prvku použite document.createElementNS().

Nepriraďujte do innerHTML nedôveryhodný značkovaný obsah. Predvolene sa nečistí a môže umožniť útok XSS, napríklad cez atribúty obsluhy udalostí. Na obyčajný text použite textContent. Ak CSP vynucuje Trusted Types, priradenie bežného reťazca bez predvolenej politiky vyvolá TypeError. Hodnota TrustedHTML je len taká bezpečná ako politika, ktorá ju vytvorila. Tieto API patria k webovej platforme, nie k ECMAScriptu 2024; v prostrediach bez DOM s nimi nepočítajte.

Prí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ýsledok

<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 príklad ako súbor `.html` a otvorte ho priamo v prehliadači. Výstup nájdete v konzole nástrojov pre vývojárov. Oba prvky majú `localName` rovné `a`, ale ich `tagName` a `namespaceURI` sa líšia. Záverečné `true` znamená, že pôvodný podriadený uzol už nemá nadradený uzol.

Súvisiace lekcie

  • JavaScript · Lekcia 16 · Pokročilá · Verzia: 4

Zdroje