HTML entiteiten encoder / decoder

Een HTML-entiteit is een korte tekenreeks die een teken vertegenwoordigt in HTML-broncode. Entiteiten worden gebruikt wanneer een teken dubbelzinnig of ongeldig zou zijn in gewone HTML – bijvoorbeeld begrenzen `<` en `>` HTML-tags, dus een letterlijk `<` in tekstinhoud moet worden geschreven als `&lt;` zodat de browser het niet als het begin van een tag interpreteert.

HTML-entiteiten bestaan in twee vormen. Benoemde entiteiten gebruiken een leesbare naam na `&` en voor `;`, bijvoorbeeld `&amp;` voor een ampersand, `&copy;` voor een copyrightsymbool of `&mdash;` voor een gedachtestreep. Numerieke entiteiten gebruiken een decimaal of hexadecimaal Unicode-codepunt – `&#169;` en `&#xA9;` produceren beide het copyrightsymbool ©.

De vijf gereserveerde HTML-tekens die elke ontwikkelaar moet kennen:

• `&amp;` – het ampersandteken `&`
• `&lt;` – het kleiner-dan-teken `<`
• `&gt;` – het groter-dan-teken `>`
• `&quot;` – het dubbele aanhalingsteken `"`
• `&#39;` – het apostrof / enkel aanhalingsteken `'`

Buiten deze vijf definieert HTML benoemde entiteiten voor honderden andere tekens: letters met accenten (`&eacute;` = e met accent aigu), vaste spaties (`&nbsp;`), typografische leestekens (`&mdash;` = gedachtestreep), valutasymbolen (`&euro;` = euroteken), wiskundige symbolen en Griekse letters.

Encodeer HTML-entiteiten wanneer je platte tekst in een HTML-document invoegt en die tekst tekens kan bevatten die HTML reserveert. De meest voorkomende situaties:

• Gebruikersinhoud of blogteksten plakken in een CMS of template dat ruwe HTML opslaat.
• Code-voorbeelden insluiten in blogberichten of documentatiepaginas – een fragment zoals `<strong>vet</strong>` moet worden gecodeerd als `&lt;strong&gt;vet&lt;/strong&gt;` zodat de browser het als zichtbare tekst weergeeft.
• JSON-payloads bouwen die zijn ingebed in HTML `<script>`-tags, waar `<`, `>` en `&` de omringende HTML-structuur kunnen beschadigen.
• Attribuutwaarden opslaan die dubbele aanhalingstekens kunnen bevatten, om de omringende `"..."` begrenzing niet te doorbreken.
• Speciale tekens encoderen voor HTML-e-mailsjablonen.

Gebruik de basismodus wanneer je alleen de vijf gereserveerde tekens hoeft te escapen. Gebruik de uitgebreide modus voor maximale HTML-compatibiliteit of voor oudere systemen die alleen ASCII ondersteunen.

Decodeer HTML-entiteiten wanneer je al geescapede tekst ontvangt en de originele tekens nodig hebt om te lezen, verwerken of weergeven. In zoektermen wordt dit vaak HTML decode, HTML unescape of het converteren van HTML-gecodeerde tekst naar normale tekst genoemd. Veel voorkomende situaties:

• API-reacties waarvan stringvelden HTML-geescapede tekst bevatten – bijvoorbeeld `Tom &amp; Jerry` terwijl je `Tom & Jerry` verwachtte. In dat geval moet je HTML-entiteiten naar tekst converteren.
• Dubbel gecodeerde CMS-inhoud waarbij al geescapede tekst opnieuw is geescaped, waardoor strings zoals `&amp;lt;` zijn ontstaan in plaats van `&lt;` of `<`.
• RSS- of Atom-feed-vermeldingen waarvan de tekstinhoud typisch HTML-gecodeerd is.
• Logregels met HTML-geescapede queryparameters of foutmeldingen.
• Zichtbare tekst kopieren vanuit een HTML-bronbestand waar inhoud als entiteiten is opgeslagen.

Deze tool decodeert zowel benoemde entiteiten (`&amp;`, `&copy;`, `&mdash;`, `&nbsp;` en honderden meer) als numerieke entiteiten in decimale (`&#169;`) en hexadecimale (`&#xA9;`) notatie.

Deze encoder biedt twee niveaus van encoderingsdetail.

De basismodus encodeert alleen de vijf gereserveerde HTML-tekens: `&` wordt `&amp;`, `<` wordt `&lt;`, `>` wordt `&gt;`, `"` wordt `&quot;`, `'` wordt `&#39;`. Alle andere tekens – letters met accenten zoals `é` en `ü`, symbolen zoals `©` en `—`, emoji zoals 😀 – worden ongewijzigd doorgegeven. Gebruik de basismodus wanneer je doelomgeving Unicode native ondersteunt.

De uitgebreide modus encodeert dezelfde vijf gereserveerde tekens en converteert bovendien elk niet-ASCII-teken naar een decimale numerieke entiteit. Zo wordt `é` `&#233;`, `©` wordt `&#169;`, `—` wordt `&#8212;` en 😀 wordt `&#128512;`. Gebruik de uitgebreide modus wanneer je pure ASCII-uitvoer nodig hebt of voor oudere systemen.

Ontwikkelaars zoeken dezelfde taak soms met termen als htmlDecode, htmlEncode, HTML escape, HTML unescape, HTML encoderen of HTML decoderen. De formulering verschilt, maar het doel is hetzelfde: veilig converteren tussen leesbare tekens en hun HTML-entiteitsrepresentatie.

Voorbeeld heen-en-terugconversie in basismodus:

• Invoer: `Café & © 😀`
• Gecodeerd (basis): `Café &amp; © 😀`
• Gedecodeerd: `Café & © 😀`

Voorbeeld heen-en-terugconversie in uitgebreide modus:

• Invoer: `Café & © 😀`
• Gecodeerd (uitgebreid): `Caf&#233; &amp; &#169; &#128512;`
• Gedecodeerd: `Café & © 😀`

HTML-entiteiten encoderen en URL-encoderen zijn twee volledig verschillende mechanismen met verschillende doeleinden en verschillende uitvoer – ook al transformeren ze beide speciale tekens naar een alternatieve weergave.

HTML-entiteiten encoderen is bedoeld voor HTML-documenten. Het vervangt tekens met speciale betekenis in HTML-opmaak door entiteitsequenties die de HTML-parser als tekstinhoud behandelt. Het resultaat is nog steeds leesbare tekst – `&amp;` wordt weergegeven als `&` in een browser.

URL-encoderen (procentencodering) is bedoeld voor URL's. Het vervangt tekens die onveilig of gereserveerd zijn in een URL door procentgecodeerde bytesequenties. Een spatie wordt `%20`, een ampersand wordt `%26`, een kleiner-dan-teken wordt `%3C`.

Vergelijking van dezelfde tekens in beide systemen:

• `&` – HTML: `&amp;`, URL: `%26`
• `<` – HTML: `&lt;`, URL: `%3C`
• `>` – HTML: `&gt;`, URL: `%3E`
• `"` – HTML: `&quot;`, URL: `%22`
• `'` – HTML: `&#39;`, URL: `%27`

Als je HTML-gecodeerde tekst in een URL-encoder plakt, worden de entiteitstekens zelf (`&`, `;`, `#`) opnieuw gecodeerd – wat bijna nooit gewenst is. Gebruik deze pagina voor HTML-entiteiten decoderen, HTML-entiteiten encoderen en het converteren van HTML-gecodeerde tekst naar leesbare tekst.

HTML-entiteiten encoderen (deze tool) converteert tekens naar hun HTML-entiteitsequivalenten en keert dat proces om. Het voegt geen HTML-elementen toe, verwijdert of herstructureert ze niet. De documentstructuur blijft behouden; alleen de weergave van speciale tekens verandert.

HTML opschonen is een andere bewerking die HTML-opmaak verwijdert of herschrijft – ongewenste tags verwijdert, attributen normaliseert of potentieel gevaarlijke inhoud opschoont. Een opschoonbewerking kan `<b onclick="...">vet</b>` omzetten naar `<b>vet</b>` of alleen `vet`.

Deze tool schoont geen HTML op. Als je ruwe HTML in de encoder plakt, codeert het de punthaken en andere gereserveerde tekens in de opmaak, waardoor `<p>Hallo</p>` verandert in `&lt;p&gt;Hallo&lt;/p&gt;`. Het inspecteert, verwijdert of herstructureert geen elementen.

Ook is deze tool geen tekstopschooner. Het verwijdert geen overbodige spaties, verwijdert geen accenten en normaliseert geen regelafbrekingen. Zijn enige taak is het encoderen en decoderen van HTML-entiteiten.