CKTIS / JavaScript
HTMLElement.innerHTML: четене и замяна на съдържанието на елемент
При четене `innerHTML` връща съдържанието на елемента като маркировка. Присвояването го заменя с нови възли, създадени при разбора, дори при използване на `+=`.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""HTMLElement.innerHTML е свойство на екземпляр, наследено от Element, а не статичен метод. При четене то връща текущото съдържание на DOM като низ, без таговете на самия елемент и без корените на Shadow DOM. Това е сериализация на дървото, а не копие на изходния текст.
Присвояването анализира маркировката в контекста на елемента и заменя неговите дъщерни възли, а не самия елемент. При template се заменя съдържанието на template.content. Сетърът приема низ или TrustedHTML. Web IDL преобразува null в празния низ ("") преди проверката за Trusted Types. Ако низът стигне непроменен до анализатора, съдържанието се изчиства. Когато обаче се налага използването на Trusted Types, политиката по подразбиране може да преобразува празния низ в непразна маркировка, така че успешното присвояване не гарантира изчистване на съдържанието. Сетърът не създава декларативни корени на Shadow DOM.
element.innerHTML += markup прочита сериализираната маркировка, добавя новия текст и анализира отново целия резултат. Старите възли се отделят от дървото и регистрираните директно върху тях слушатели за събития не се прехвърлят към новите възли. За да запазиш съществуващите възли, добавяй новите с append().
Не подавай ненадеждни входни данни директно към innerHTML: по подразбиране свойството не ги пречиства, а атрибутите за обработка на събития могат да доведат до XSS, макар че вмъкнатите елементи script не се изпълняват. За обикновен текст използвай textContent. Ако ти трябва HTML, използвай проверен инструмент за пречистване. Политиката на Trusted Types сама по себе си не гарантира пречистване.
Това е API на уеб платформата, а не част от ECMAScript 2024. Поддръжката на Trusted Types зависи от средата. Когато CSP налага Trusted Types и няма политика по подразбиране, присвояването на низ предизвиква TypeError. HTML анализаторът се възстановява след синтактични грешки, но в XML документ неправилно оформен фрагмент може да предизвика SyntaxError при присвояване. Ако съдържанието не може да се сериализира като правилно оформен XML, четенето може да предизвика InvalidStateError.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML example</title>
</head>
<body>
<script>
const box = document.createElement("div");
box.innerHTML = "<strong>Hello</strong>";
const original = box.firstElementChild;
box.innerHTML += "<em> again</em>";
console.log(box.innerHTML);
console.log(box.textContent);
console.log(original === box.firstElementChild);
console.log(original.parentNode === null);
</script>
</body>
</html>Резултат
<strong>Hello</strong><em> again</em> Hello again false true
Запази примера като HTML файл, отвори го в браузър, без да се налага използването на Trusted Types, и провери конзолата за разработчици. Първите два реда сравняват маркировката с текста, а последните два показват, че първият възел е заменен и вече няма родител.
Свързани уроци
- JavaScript · Урок 31 · Напреднало · Версия: 4