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

CKTIS / JavaScript

Избор на наследник с querySelector() и промяна на съдържанието му с innerHTML

Намерете първия наследник, който съответства на CSS селектор, обработете липсата на съвпадение и прочетете или заменете маркираното съдържание на избрания елемент.

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

Синтаксис

const target = root.querySelector(selectors);
if (target !== null) {
  const previousMarkup = target.innerHTML;
  target.innerHTML = markup;
}

Element.querySelector/innerHTML съчетава две операции: намиране на елемент и работа със съдържанието му. root.querySelector(selectors) приема низ с CSS селектор или списък от селектори, разделени със запетаи. Връща първия съвпадащ елемент сред наследниците според реда в DOM дървото, независимо от реда на селекторите в списъка. Никога не връща самия root. При липса на съвпадение връща null, а при невалиден синтаксис на селектора хвърля DOMException с име SyntaxError. Проверете резултата, преди да прочетете или зададете стойност на свойство.

Резултатът трябва да е наследник на root, но при проверката за съвпадение могат да се вземат предвид и предшественици извън това поддърво. Използвайте :scope > .message, за да намерите само преките деца на root с клас message. За разлика от document.querySelector() това не е търсене в целия документ.

Четенето на target.innerHTML връща сериализираното съдържание като низ, без таговете на самия елемент и без корените на Shadow DOM. При присвояване фрагментът се анализира в контекста на елемента и заменя децата му, а не самия елемент. При елемент template се заменя съдържанието на шаблона. Запазените препратки и слушателите на събития остават свързани със старите отделени възли, а не с новите. В XML документ присвояването на недобре оформен фрагмент хвърля SyntaxError; ако сериализацията в XML е невъзможна, четенето може да хвърли InvalidStateError. И двете са изключения от тип DOMException.

Не присвоявайте недоверени входни данни директно на innerHTML: по подразбиране свойството не пречиства маркирания текст и това може да доведе до XSS. За обикновен текст използвайте textContent. Ако ви трябва маркирано съдържание от недоверен източник, първо го пречистете. Trusted Types не пречиства данните автоматично. Ако средата поддържа Trusted Types и CSP налага използването им, присвояването на обикновен низ без подходяща политика по подразбиране хвърля TypeError. Вместо него подайте TrustedHTML от политика, която пречиства входните данни.

Тези API са част от уеб платформата, а не от ECMAScript 2024. Проверете дали средата за изпълнение предоставя DOM и поддържа необходимите механизми за сигурност.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>querySelector() and innerHTML</title>
</head>
<body>
  <script>
    {
      const panel = document.createElement("div");
      panel.innerHTML = '<p class="message"><em>Before</em></p><p class="message">Unchanged</p>';

      const target = panel.querySelector(".message");
      if (target !== null) {
        const oldChild = target.firstElementChild;
        console.log(target.innerHTML);
        target.innerHTML = "<strong>After</strong>";
        console.log(target.innerHTML);
        console.log(oldChild.parentNode === null);
        console.log(target.nextElementSibling.textContent);
      }
      console.log(panel.querySelector(".missing") === null);
    }
  </script>
</body>
</html>

Резултат

<em>Before</em>
<strong>After</strong>
true
Unchanged
true

Запазете примера като файл `.html` и го отворете в браузър без CSP, която налага Trusted Types. Резултатите се виждат в конзолата на браузъра. Променя се само първият съвпадащ елемент. Старото му дете вече няма родителски възел, вторият елемент запазва текста `Unchanged`, а търсенето без съвпадение връща `null`.

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

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

Източници