Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.innerHTML, tagName i namespaceURI

Odczytuj i zastępuj znaczniki wewnątrz elementu DOM oraz rozpoznawaj elementy po nazwie lokalnej i przestrzeni nazw, także gdy HTML i SVG występują w jednym dokumencie.

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

Składnia

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

innerHTML zwraca ciąg znaków powstały przez serializację aktualnej zawartości elementu, bez jego własnych znaczników i bez korzeni Shadow DOM. Przypisanie ciągu lub wartości TrustedHTML parsuje fragment w kontekście elementu i zastępuje jego węzły potomne, nie sam element. Zachowane referencje do poprzednich węzłów nadal wskazują na stare obiekty, a nie na nowe węzły. W przypadku elementu HTML template odczyt i zapis dotyczą jego content. Wartość null jest traktowana jak pusty ciąg.

W dokumencie HTML używany jest parser HTML, który może skorygować niepoprawny zapis. W dokumencie XML, także XHTML przetwarzanym jako XML, używany jest parser XML; fragment, który nie jest poprawnie sformułowany, powoduje wyjątek DOMException o nazwie SyntaxError.

tagName to kwalifikowana nazwa elementu, tylko do odczytu. Zawiera prefiks, jeśli został nadany. Tylko dla elementów z przestrzeni nazw HTML w dokumencie HTML nazwa jest zamieniana na wielkie litery ASCII. namespaceURI również jest tylko do odczytu: zwraca URI przestrzeni nazw ustalone przy tworzeniu elementu albo null, jeśli element nie należy do żadnej przestrzeni nazw. Przeniesienie elementu ani zmiana atrybutu xmlns nie zmienia tej wartości. W dokumentach z mieszanymi przestrzeniami nazw porównuj namespaceURI i localName, czyli nazwę bez prefiksu; aby jawnie wybrać przestrzeń nazw przy tworzeniu elementu, użyj document.createElementNS().

Nie przypisuj niezaufanych znaczników do innerHTML: właściwość domyślnie ich nie oczyszcza i może umożliwić XSS, na przykład przez atrybuty obsługi zdarzeń. Do zwykłego tekstu użyj textContent. Jeśli polityka CSP wymusza Trusted Types, przypisanie zwykłego ciągu bez polityki domyślnej powoduje TypeError. Wartość TrustedHTML jest bezpieczna tylko w takim stopniu, w jakim bezpieczna jest polityka, która ją utworzyła. Są to interfejsy platformy WWW, a nie część ECMAScript 2024; poza środowiskiem z DOM nie zakładaj ich dostępności.

Przykłady

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

Wynik

<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

Zapisz przykład jako plik `.html` i otwórz go bezpośrednio w przeglądarce. Wynik zobaczysz w konsoli narzędzi deweloperskich. Oba elementy mają `localName` równe `a`, ale różne `tagName` i `namespaceURI`. Ostatnie `true` oznacza, że poprzedni węzeł potomny nie ma już rodzica.

Powiązane lekcje

  • JavaScript · Lekcja 16 · Zaawansowany · Wersja: 4

Źródła