База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Element.innerHTML, tagName и namespaceURI

Четете и заменяйте маркираното съдържание на DOM елемент и различавайте елементите по локално име и пространство от имена, когато HTML и SVG са в едно дърво.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

innerHTML връща текущото съдържание на елемента като сериализиран низ, без таговете на самия елемент и без корените на Shadow DOM. При присвояване на низ или стойност TrustedHTML фрагментът се анализира в контекста на елемента и заменя дъщерните му възли, а не самия елемент. Препратките към старите възли продължават да сочат към същите обекти, а не към новите възли. При HTML елемента template четенето и записването се отнасят до неговото свойство content. Присвояването на null е равносилно на присвояване на празен низ.

HTML документът използва HTML анализатор, който може да се справи с грешки в маркирането. XML документът, включително XHTML, предоставен като XML, използва XML анализатор. Неправилно оформен фрагмент предизвиква изключение DOMException с име SyntaxError.

tagName е квалифицираното име само за четене, включително префикса, ако има такъв. ASCII буквите в името се преобразуват в главни само за елементи в пространството от имена HTML, които са в HTML документ. namespaceURI също е само за четене: връща URI на пространството от имена, определено при създаването на елемента, или null, ако елементът не принадлежи към такова пространство. Преместването на елемента или промяната на атрибут xmlns не променят стойността. В дърво с няколко пространства от имена сравнявайте namespaceURI и localName (името без префикс). Използвайте document.createElementNS(), за да изберете изрично пространство от имена при създаване на елемент.

Не присвоявайте ненадеждно маркирано съдържание на innerHTML: по подразбиране то не се пречиства и може да доведе до XSS, например чрез атрибути за обработка на събития. За обикновен текст използвайте textContent. Ако CSP налага Trusted Types, присвояването на обикновен низ без политика по подразбиране предизвиква TypeError. Стойността TrustedHTML е толкова безопасна, колкото политиката, която я е създала. Това са API на уеб платформата, а не възможности на ECMAScript 2024; не приемайте, че са налични в среди без DOM.

Примери

<!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>

Резултат

<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

Запазете примера като файл с разширение `.html` и го отворете директно в браузър. Вижте резултата в конзолата за разработчици. И двата елемента имат `localName` със стойност `a`, но стойностите им за `tagName` и `namespaceURI` се различават. Последното `true` означава, че старият дъщерен възел вече няма родител.

Свързани уроци

  • JavaScript · Урок 16 · Напреднало · Версия: 4

Източници