Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Wybór elementu za pomocą querySelector() i zmiana jego zawartości przez innerHTML

Znajdź pierwszy pasujący element potomny za pomocą selektora CSS, obsłuż brak wyniku i odczytaj lub zastąp znaczniki wewnątrz wybranego elementu.

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

Składnia

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

Element.querySelector/innerHTML łączy dwie operacje: znalezienie elementu i pracę z jego zawartością. root.querySelector(selectors) przyjmuje ciąg z selektorem CSS lub listą selektorów rozdzielonych przecinkami. Zwraca pierwszy pasujący element potomny w kolejności drzewa DOM, niezależnie od kolejności selektorów na liście. Nie zwraca samego root. Brak dopasowania daje null; nieprawidłowa składnia selektora powoduje wyjątek DOMException o nazwie SyntaxError. Sprawdź wynik przed odczytem lub przypisaniem właściwości.

Pasujący element musi leżeć pod root, ale selektor może uwzględniać przodków spoza tego poddrzewa. Użyj :scope > .message, by dopasować wyłącznie bezpośrednie dzieci root z klasą message. Nie jest to wyszukiwanie w całym dokumencie, jak w przypadku document.querySelector().

Odczyt target.innerHTML zwraca ciąg ze zserializowaną zawartością, bez znaczników samego elementu i bez korzeni Shadow DOM. Przypisanie parsuje fragment w kontekście elementu i zastępuje jego dzieci, a nie sam element. W przypadku elementu template zastępuje zawartość szablonu. Zachowane referencje i nasłuchiwacze nadal dotyczą starych, odłączonych węzłów, nie nowych. W dokumencie XML źle sformułowany fragment powoduje przy zapisie SyntaxError, a odczyt może zgłosić InvalidStateError, gdy serializacja do XML jest niemożliwa. Oba są wyjątkami DOMException.

Nie przypisuj niezaufanych danych bezpośrednio do innerHTML: ta właściwość domyślnie nie oczyszcza znaczników i może prowadzić do XSS. Do zwykłego tekstu użyj textContent. Jeśli potrzebujesz znaczników z niezaufanego źródła, najpierw je oczyść. Trusted Types same nie oczyszczają danych. Tam, gdzie są obsługiwane i wymuszane przez CSP, przypisanie zwykłego ciągu bez odpowiedniej polityki domyślnej powoduje TypeError; zamiast tego można przekazać TrustedHTML z polityki oczyszczającej dane.

To API platformy WWW, a nie część ECMAScript 2024. Sprawdź, czy środowisko udostępnia DOM i czy obsługuje potrzebne mechanizmy zabezpieczeń.

Przykłady

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

Wynik

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

Zapisz przykład jako plik `.html` i otwórz go w przeglądarce bez CSP wymuszającej Trusted Types. Wyniki zobaczysz w konsoli przeglądarki. Zmienia się tylko pierwszy pasujący element. Stare dziecko nie ma już rodzica, drugi element zachowuje tekst `Unchanged`, a brak dopasowania daje `null`.

Powiązane lekcje

  • JavaScript · Lekcja 18 · Zaawansowany · Wersja: 4

Źródła