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

CKTIS / JavaScript

Escapování textu v HTML

Při generování HTML escapuj prostý text podle místa, kam jej vkládáš. Při přímém zápisu do běžného prvku DOM místo toho přiřaď původní řetězec vlastnosti `textContent`.

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

Syntaxe

const escapeHtmlText = (text) => text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
// Use escaped text only in the ordinary text position of trusted HTML markup.
const markup = `<p>${escapeHtmlText(text)}</p>`;
// If writing directly to an ordinary DOM element, use the original string instead.
element.textContent = text;

Escapování v textovém kontextu HTML je výstupní kódování prostého textu vloženého do zdrojového kódu HTML, například do obsahu prvku p. Nezakódovaný znak < může zahájit značku a & může zahájit odkaz na znak. Analyzátor HTML převede &lt; na doslovný znak < v textu a vyhodnocený znak už nepovažuje za začátek značky.

Při řetězení volání replaceAll nahraď nejdřív & za &amp; a potom < za &lt;. Tím zabráníš escapování znaků & přidaných pozdějšími náhradami. Příklad nahrazuje také > za &gt;, což je zde nepovinné; ani uvozovky v tomto kontextu escapovat nemusíš. Původní text zakóduj jednou, při vložení, a vynech ruční kódování, pokud ho už provádí šablona.

Chceš-li nastavit text běžného prvku DOM, přiřaď původní řetězec vlastnosti textContent. Nepoužívej k tomu innerHTML, protože řetězec zpracuje jako značkovací kód. Tuto funkci nepoužívej pro atributy, adresy URL, JavaScript ani CSS; mají jiná pravidla. Pokud chceš z nedůvěryhodného HTML zachovat část značek, použij sanitizaci HTML místo escapování textu.

Příklady

function escapeHtmlText(text) {
  return text.replaceAll('&', '&amp;')
    .replaceAll('<', '&lt;')
    .replaceAll('>', '&gt;');
}

const text = 'A & B <em>demo</em> &lt;';
console.log(`<p>${escapeHtmlText(text)}</p>`);

Výsledek

<p>A &amp; B &lt;em&gt;demo&lt;/em&gt; &amp;lt;</p>

Konzole vypíše zdrojový kód HTML, nikoli vykreslený text. Po zpracování vznikne odstavec bez prvku `em` a závěrečné `&lt;` zůstane doslovným textem.

Související lekce

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

Zdroje