CKTIS / JavaScript
Odabir potomka metodom querySelector() i promjena sadržaja svojstvom innerHTML
Pronađite prvog potomka koji odgovara CSS selektoru, obradite slučaj bez rezultata te pročitajte ili zamijenite sadržaj s oznakama unutar odabranog elementa.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const target = root.querySelector(selectors);
if (target !== null) {
const previousMarkup = target.innerHTML;
target.innerHTML = markup;
}Element.querySelector/innerHTML povezuje dvije operacije: pronalaženje elementa i rad s njegovim sadržajem. root.querySelector(selectors) prima znakovni niz s CSS selektorom ili popisom selektora odvojenih zarezima. Vraća prvi odgovarajući element među potomcima prema redoslijedu u stablu DOM-a, neovisno o redoslijedu selektora na popisu. Nikad ne vraća sam root. Ako nema podudaranja, vraća null; neispravna sintaksa selektora izaziva iznimku DOMException pod nazivom SyntaxError. Provjerite rezultat prije čitanja ili dodjele vrijednosti svojstvu.
Rezultat mora biti potomak elementa root, ali pri provjeri podudaranja mogu se uzeti u obzir i preci izvan tog podstabla. Upotrijebite :scope > .message da biste pronašli samo izravnu djecu elementa root s klasom message. To nije pretraga cijelog dokumenta kao document.querySelector().
Čitanjem target.innerHTML dobivate serijalizirani sadržaj kao znakovni niz, bez oznaka samog elementa i bez korijena Shadow DOM-a. Pri dodjeli fragment se raščlanjuje u kontekstu elementa i zamjenjuje njegovu djecu, a ne sam element. Kod elementa template zamjenjuje se sadržaj predloška. Spremljene reference i slušatelji događaja ostaju povezani sa starim odvojenim čvorovima, ne s novima. U XML dokumentu dodjela neispravno oblikovanog fragmenta izaziva SyntaxError; čitanje može izazvati InvalidStateError ako serijalizacija u XML ne uspije. Obje su iznimke tipa DOMException.
Ne dodjeljujte nepouzdane podatke izravno svojstvu innerHTML: ono prema zadanim postavkama ne pročišćava oznake i može dovesti do XSS-a. Za običan tekst koristite textContent. Ako vam trebaju oznake iz nepouzdanog izvora, najprije ih pročistite. Trusted Types ne pročišćava podatke sam po sebi. Kad okruženje podržava Trusted Types, a CSP ih zahtijeva, dodjela običnog znakovnog niza bez odgovarajućeg zadanog pravila izaziva TypeError. Umjesto toga predajte TrustedHTML proizveden pravilom koje pročišćava ulazne podatke.
Ovi API-ji pripadaju web-platformi, a ne standardu ECMAScript 2024. Provjerite nudi li izvršno okruženje DOM i podržava li potrebne sigurnosne mehanizme.
Primjeri
<!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>Rezultat
<em>Before</em> <strong>After</strong> true Unchanged true
Spremite primjer kao datoteku `.html` i otvorite je u pregledniku bez CSP-a koji zahtijeva Trusted Types. Izlaz je u konzoli preglednika. Mijenja se samo prvi pronađeni element. Njegovo staro dijete više nema roditeljski čvor, drugi element zadržava tekst `Unchanged`, a pretraga bez podudaranja vraća `null`.
Povezane lekcije
- JavaScript · Lekcija 18 · Napredno · Verzija: 4