Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori