Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Izbira potomca z metodo querySelector() in sprememba vsebine z lastnostjo innerHTML

Poiščite prvega potomca, ki se ujema s selektorjem CSS, obravnavajte primer brez zadetka ter preberite ali zamenjajte označeno vsebino izbranega elementa.

Različica: 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 dve operaciji: iskanje elementa in delo z njegovo vsebino. root.querySelector(selectors) sprejme niz s selektorjem CSS ali seznam selektorjev, ločenih z vejicami. Vrne prvi ujemajoči se element med potomci po vrstnem redu v drevesu DOM, ne glede na vrstni red selektorjev na seznamu. Nikoli ne vrne samega root. Če ni zadetka, vrne null; neveljavna sintaksa selektorja sproži izjemo DOMException z imenom SyntaxError. Pred branjem ali nastavljanjem lastnosti preverite rezultat.

Rezultat mora biti potomec elementa root, vendar se pri preverjanju ujemanja lahko upoštevajo tudi predniki zunaj tega poddrevesa. Z :scope > .message omejite zadetke na neposredne otroke elementa root z razredom message. To ni iskanje po celotnem dokumentu kot pri document.querySelector().

Branje target.innerHTML vrne serializirano vsebino kot niz brez oznak samega elementa in brez korenov Shadow DOM. Pri prirejanju se fragment razčleni v kontekstu elementa in zamenja njegove otroke, ne pa elementa samega. Pri elementu template se namesto tega zamenja vsebina predloge. Shranjeni sklici in poslušalci dogodkov ostanejo povezani s starimi odstranjenimi vozlišči, ne z novimi. V dokumentu XML prirejanje nepravilno oblikovanega fragmenta sproži SyntaxError; če serializacija v XML ni mogoča, lahko branje sproži InvalidStateError. Obe izjemi sta tipa DOMException.

Nezaupanja vrednega vhoda ne prirejajte neposredno lastnosti innerHTML: ta privzeto ne očisti oznak in lahko povzroči XSS. Za golo besedilo uporabite textContent. Če potrebujete označeno vsebino iz nezaupanja vrednega vira, jo najprej očistite. Trusted Types vhoda ne očistijo sami. Če jih okolje podpira in jih CSP uveljavlja, prirejanje navadnega niza brez ustreznega privzetega pravilnika sproži TypeError. Namesto tega podajte TrustedHTML iz pravilnika, ki očisti vhod.

To so API-ji spletne platforme, ne del ECMAScript 2024. Preverite, ali izvajalno okolje zagotavlja DOM in podpira potrebne varnostne funkcije.

Primeri

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

Primer shranite kot datoteko `.html` in jo odprite v brskalniku brez CSP, ki uveljavlja Trusted Types. Izpis je v konzoli brskalnika. Spremeni se samo prvi zadetek. Njegovo staro podrejeno vozlišče nima več nadrejenega vozlišča, drugi element ohrani besedilo `Unchanged`, iskanje brez zadetka pa vrne `null`.

Povezane lekcije

  • JavaScript · Lekcija 18 · Napredna · Različica: 4

Viri