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

CKTIS / JavaScript

Ubežno kodiranje besedila v HTML

Pri ustvarjanju HTML kodiraj navadno besedilo glede na mesto vstavljanja. Če pišeš neposredno v običajen element DOM, namesto tega uporabi `textContent` z izvirnim nizom.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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;

Ubežno kodiranje v besedilnem kontekstu HTML pomeni izhodno kodiranje navadnega besedila, ki ga vstaviš v izvorno kodo HTML, denimo v vsebino elementa p. Nekodirani < lahko začne oznako, & pa sklic na znak. Razčlenjevalnik pretvori &lt; v dobesedni < v besedilu, ne da bi ga obravnaval kot začetek oznake.

Pri zaporednih klicih replaceAll najprej zamenjaj & z &amp;, nato pa < z &lt;. Tako ne kodiraš znakov &, ki jih dodajo poznejše zamenjave. Primer zamenja tudi > z &gt;, kar tu ni nujno; tudi narekovajev v tem kontekstu ni treba kodirati. Izvirno besedilo kodiraj samo enkrat ob vstavljanju, ročno kodiranje pa izpusti, če ga že opravi predloga.

Besedilo običajnega elementa DOM nastavi tako, da izvirni niz prirediš lastnosti textContent. Za to ne uporabljaj innerHTML, saj razčleni označevalno kodo. Te funkcije ne uporabljaj za atribute, URL-je, JavaScript ali CSS, ker zanje veljajo drugačna pravila. Če želiš ohraniti del oznak iz nezaupanja vrednega HTML, uporabi čiščenje HTML namesto ubežnega kodiranja besedila.

Primeri

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>`);

Rezultat

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

Konzola izpiše izvorno kodo HTML, ne prikazanega besedila. Po razčlenjevanju nastane odstavek brez elementa `em`, zadnji `&lt;` pa ostane dobesedno besedilo.

Povezane lekcije

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

Viri