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