Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Výběr potomka pomocí querySelector() a změna jeho obsahu pomocí innerHTML

Najděte prvního potomka odpovídajícího selektoru CSS, ošetřete chybějící výsledek a přečtěte nebo nahraďte značkovaný obsah vybraného prvku.

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

Syntaxe

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

Element.querySelector/innerHTML spojuje dvě operace: vyhledání prvku a práci s jeho obsahem. root.querySelector(selectors) přijímá řetězec se selektorem CSS nebo se seznamem selektorů oddělených čárkami. Vrací první odpovídající prvek mezi potomky v pořadí stromu DOM, bez ohledu na pořadí selektorů v seznamu. Nikdy nevrací samotný root. Pokud nic neodpovídá, vrací null; neplatná syntaxe selektoru vyvolá výjimku DOMException s názvem SyntaxError. Než vlastnost přečtete nebo nastavíte, výsledek zkontrolujte.

Nalezený prvek musí být potomkem root, ale při vyhodnocování selektoru mohou hrát roli i předci mimo tento podstrom. Pomocí :scope > .message vyberete pouze přímé potomky root se třídou message. Nejde o vyhledávání v celém dokumentu jako u document.querySelector().

Přečtením target.innerHTML získáte řetězec se serializovaným obsahem bez značek samotného prvku a bez kořenů Shadow DOM. Při přiřazení se fragment zpracuje v kontextu prvku a nahradí jeho přímé potomky, nikoli prvek samotný. U prvku template se místo toho nahradí obsah šablony. Uložené reference a posluchače událostí zůstávají spojeny s původními odpojenými uzly, ne s novými. V dokumentu XML přiřazení nesprávně utvořeného fragmentu vyvolá SyntaxError; pokud se obsah nepodaří serializovat do XML, čtení může vyvolat InvalidStateError. V obou případech jde o DOMException.

Nedůvěryhodný vstup nepřiřazujte přímo do innerHTML: vlastnost ve výchozím nastavení značky neočišťuje a může vést k XSS. Pro prostý text použijte textContent. Potřebujete-li značkovaný obsah z nedůvěryhodného zdroje, nejprve jej očistěte. Trusted Types vstup samy neočišťují. Jestliže je prostředí podporuje a CSP je vynucuje, přiřazení běžného řetězce bez vhodné výchozí zásady vyvolá TypeError. Místo něj předejte TrustedHTML vytvořený zásadou, která vstup očišťuje.

Tato API patří do webové platformy, nikoli do ECMAScript 2024. Ověřte, že běhové prostředí poskytuje DOM a podporuje potřebné bezpečnostní funkce.

Pří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ýsledek

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

Uložte příklad jako soubor `.html` a otevřete ho v prohlížeči bez CSP vynucující Trusted Types. Výstup najdete v konzoli prohlížeče. Změní se pouze první nalezený prvek. Jeho původní potomek už nemá rodičovský uzel, druhý prvek si ponechá text `Unchanged` a hledání bez výsledku vrátí `null`.

Související lekce

  • JavaScript · Lekce 18 · Pokročilá · Verze: 4

Zdroje