Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Výber potomka pomocou querySelector() a zmena jeho obsahu pomocou innerHTML

Nájdite prvého potomka zodpovedajúceho selektoru CSS, ošetrite chýbajúci výsledok a prečítajte alebo nahraďte značkovaný obsah vybraného prvku.

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

Syntax

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

Element.querySelector/innerHTML spája dve operácie: vyhľadanie prvku a prácu s jeho obsahom. root.querySelector(selectors) prijíma reťazec so selektorom CSS alebo so zoznamom selektorov oddelených čiarkami. Vráti prvý vyhovujúci prvok medzi potomkami v poradí stromu DOM, bez ohľadu na poradie selektorov v zozname. Nikdy nevráti samotný root. Ak nič nevyhovuje, vráti null; neplatná syntax selektora vyvolá výnimku DOMException s názvom SyntaxError. Pred čítaním alebo nastavením vlastnosti výsledok skontrolujte.

Nájdený prvok musí byť potomkom root, ale pri vyhodnocovaní selektora môžu zohrávať úlohu aj predkovia mimo tohto podstromu. Použite :scope > .message, ak chcete nájsť iba priamych potomkov root s triedou message. Nejde o vyhľadávanie v celom dokumente ako pri document.querySelector().

Čítanie target.innerHTML vráti reťazec so serializovaným obsahom bez značiek samotného prvku a bez koreňov Shadow DOM. Pri priradení sa fragment spracuje v kontexte prvku a nahradí jeho priame potomky, nie samotný prvok. Pri prvku template sa namiesto toho nahradí obsah šablóny. Uložené referencie a poslucháče udalostí ostávajú spojené so starými odpojenými uzlami, nie s novými. V dokumente XML priradenie nesprávne utvoreného fragmentu vyvolá SyntaxError; čítanie môže vyvolať InvalidStateError, ak serializácia do XML zlyhá. Obe sú výnimky typu DOMException.

Nedôveryhodný vstup nepriraďujte priamo do innerHTML: vlastnosť v predvolenom nastavení značky nečistí a môže viesť k XSS. Na obyčajný text použite textContent. Ak potrebujete značkovaný obsah z nedôveryhodného zdroja, najprv ho vyčistite. Trusted Types vstup samy nečistia. Ak ich prostredie podporuje a CSP ich vynucuje, priradenie obyčajného reťazca bez vhodnej predvolenej politiky vyvolá TypeError. Namiesto neho odovzdajte TrustedHTML z politiky, ktorá vstup čistí.

Tieto API patria do webovej platformy, nie do ECMAScript 2024. Overte, či prostredie poskytuje DOM a podporuje potrebné bezpečnostné funkcie.

Príklady

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

Výsledok

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

Uložte príklad ako súbor `.html` a otvorte ho v prehliadači bez CSP vynucujúcej Trusted Types. Výstup nájdete v konzole prehliadača. Zmení sa iba prvý nájdený prvok. Jeho pôvodný potomok už nemá rodičovský uzol, druhý prvok si ponechá text `Unchanged` a vyhľadávanie bez výsledku vráti `null`.

Súvisiace lekcie

  • JavaScript · Lekcia 18 · Pokročilá · Verzia: 4

Zdroje