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('&', '&').replaceAll('<', '<').replaceAll('>', '>');
// 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 < 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 & a potom < za <. Tím zabráníš escapování znaků & přidaných pozdějšími náhradami. Příklad nahrazuje také > za >, 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('&', '&')
.replaceAll('<', '<')
.replaceAll('>', '>');
}
const text = 'A & B <em>demo</em> <';
console.log(`<p>${escapeHtmlText(text)}</p>`);Výsledek
<p>A & B <em>demo</em> &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é `<` zůstane doslovným textem.
Související lekce
- JavaScript · Lekce 28 · Pokročilá · Verze: 4