HTML-entiteit converter

De HTML-entiteit converter is een gratis hulpmiddel waarmee je HTML-tekenverwijzingen omzet in leesbare tekens en andersom, voor gebruik in webpagina's, contentsystemen en andere tekstformaten.

Wat zijn HTML-entiteiten en waarom bestaan ze?

HTML-entiteiten geven tekens weer als tekst die HTML kan onderscheiden van de eigen opmaakcode. Een HTML-tekenverwijzing begint meestal met een ampersand en eindigt met een puntkomma. Dit kan een benoemde tekenverwijzing zijn, zoals & voor een ampersand, of een numerieke tekenverwijzing, zoals £ voor het pondteken.

Ze zijn nuttig voor tekens die in HTML een speciale betekenis hebben. Een letterlijk kleiner-dan-teken kan worden aangezien voor het begin van een tag. Daarom kun je het schrijven als <. Met tekenverwijzingen kunnen systemen bovendien bepaalde tekens opnemen in HTML of compatibele opmaaktalen zonder verwarring met opmaakcode of besturingssyntaxis.

Entiteitscodering is geen versleuteling en biedt geen geheimhouding. Iedereen kan een entiteitsverwijzing lezen of decoderen. Gebruik deze methode daarom nooit om wachtwoorden, persoonsgegevens of vertrouwelijke inhoud te verbergen.

Hoe gebruik ik de HTML-entiteit converter?

Voer de gewenste tekst in het veld Coderen of Decoderen in en bekijk daarna het bijbehorende resultaat bij HTML-entiteit gecodeerd of HTML-entiteit gedecodeerd. Gebruik de gecodeerde uitvoer als tekst in een geschikte HTML-tekst- of attribuutcontext moet worden opgenomen. Gebruik de gedecodeerde uitvoer als je de tekens nodig hebt waarnaar bestaande entiteiten verwijzen.

De omzetting vindt plaats op de server. Je invoer wordt via HTTPS naar de server verzonden en niet opgeslagen.

Controleer vóór het omzetten of je daadwerkelijk HTML-entiteiten nodig hebt. Een waarde in een querystring vereist meestal URL-procentcodering, terwijl een geïnternationaliseerde domeinnaam Punycode gebruikt. De URL-decoder en IDN Punycode-converter zijn bedoeld voor deze twee formaten.

Hoe ziet een gecodeerd of gedecodeerd resultaat eruit?

Een gedecodeerd resultaat vervangt herkende entiteitsverwijzingen door de tekens die ze voorstellen. In de gecodeerde vorm worden tekens juist weergegeven met entiteitssyntaxis.

Invoer: <p>Tea & cake</p>

Gedecodeerde uitvoer: <p>Tea & cake</p>

De punthaken in de gedecodeerde uitvoer zijn tekens die HTML-opmaak kunnen worden als je ze als HTML in een pagina invoegt. Decoderen schoont inhoud niet op, verwijdert geen scripts en maakt niet-vertrouwde HTML niet veilig. Behandel gedecodeerde inhoud op basis van de context waarin je deze gaat gebruiken.

Voorbeelden en lastige invoer

Benoemde entiteiten en numerieke tekenverwijzingen kunnen hetzelfde teken op verschillende manieren weergeven. Zo is &amp; de benoemde verwijzing voor een ampersand, &#38; de decimale numerieke verwijzing en &#x26; de hexadecimale vorm.

• Gewone spaties en letterlijke getallen zijn geen entiteitsverwijzingen en blijven normaal gesproken ongewijzigde tekst.
• Leestekens veranderen alleen als ze voorkomen als een herkende entiteitsverwijzing of bewust worden gecodeerd.
• Letters met accenten, niet-Latijnse schriften en emoji kunnen worden weergegeven met numerieke tekenverwijzingen. Die verwijzen naar Unicode-codepunten, onafhankelijk van de tekencodering van de HTML-bron. Een correcte weergave hangt af van lettertypeondersteuning. De tekencodering is wel van belang wanneer de gedecodeerde uitvoer wordt opgeslagen of verzonden.

Voeg bij het opstellen van entiteiten altijd de afsluitende puntkomma toe. Browsers accepteren in beperkte contexten sommige verwijzingen zonder puntkomma, maar deze verkorte vorm kan dubbelzinnig zijn en werkt minder betrouwbaar in verschillende parsers.

Waar kom je HTML-entiteiten in de praktijk tegen?

HTML-entiteiten komen vaak voor in HTML-broncode, contentmanagementsystemen, rich-texteditors en HTML-e-mail. In de codeweergave van WordPress kun je bijvoorbeeld &nbsp; tegenkomen voor een vaste spatie, of &amp; wanneer een ampersand in de opmaakcode behouden moet blijven.

Ze kunnen ook voorkomen in gegevens die via een ander formaat worden doorgegeven. Er ontstaan dan meerdere coderingslagen die je in de juiste volgorde moet verwerken.

• Een JSON-payload kan een HTML-fragment bevatten waarvan de tekst entiteiten gebruikt. JSON-escaping en het decoderen van HTML-entiteiten zijn afzonderlijke bewerkingen.
• Een querystring kan procentgecodeerde HTML bevatten. Decodeer eerst de URL-laag en bepaal daarna of de resulterende tekst ook entiteiten bevat.
• Een data-URI kan HTML of andere tekst met entiteiten bevatten, terwijl de URI zelf procentcodering of Base64 kan gebruiken.
• Een HTML-e-mail kan zichtbare leestekens coderen en daarnaast MIME-overdrachtscodering gebruiken voor het transport.
• Een geïnternationaliseerde domeinnaam kan naast HTML met entiteitscodering staan, maar de domeinnaam zelf wordt normaal gesproken weergegeven met Punycode en niet met HTML-entiteiten.

Waarom mislukt het decoderen of krijg ik onleesbare tekens?

Decoderen mislukt meestal doordat de invoer onjuist is opgebouwd, een ander coderingsschema gebruikt of uit meerdere coderingslagen bestaat. Controleer de oorspronkelijke tekst op benoemde of numerieke HTML-tekenverwijzingen in plaats van omzettingen te blijven herhalen zonder het resultaat te beoordelen.

• Ongeldige verwijzing: Een ontbrekende ampersand, hekje of puntkomma kan herkenning verhinderen. Vergelijk de tekst met vormen zoals &amp; of &#38;.
• Dubbel gecodeerde invoer: Tekst zoals &amp;lt; kan na één keer decoderen veranderen in &lt;. Er is dan bewust nog een tweede decoderingsstap nodig om er een kleiner-dan-teken van te maken.
• Verkeerde tekenset: Tekst die met de verkeerde tekencodering wordt geïnterpreteerd, kan vervangende symbolen of beschadigde letters met accenten tonen.
• Verkeerd formaat: Tekst met procenttekens kan URL-gecodeerd zijn. Een lange tekenreeks met letters, cijfers, plustekens, schuine strepen of afsluitende gelijktekens kan Base64 zijn.
• Bij Base64-invoer, de verkeerde variant of het verkeerde alfabet: URL-veilige Base64 gebruikt andere tekens dan standaard-Base64. Ontbrekende opvulling kan bij sommige decoders eveneens problemen veroorzaken. Deze kwesties horen niet bij de syntaxis van HTML-entiteiten en vereisen een Base64-decoder.

Veelgestelde vragen

Waarom ziet &nbsp; eruit als een gewone spatie?

&nbsp; staat voor een vaste spatie. Die ziet er meestal uit als een normale spatie, maar voorkomt op die positie een regelafbreking. Editors kunnen dit teken onzichtbaar bewaren. Bekijk daarom de broncode of controleer het betreffende teken afzonderlijk als je problemen met spatiëring onderzoekt.

Zijn namen van HTML-entiteiten hoofdlettergevoelig?

Ja. Benoemde tekenverwijzingen hebben een vastgelegde schrijfwijze en het gebruik van hoofdletters kan bepalen of een verwijzing wordt herkend. Gebruik de exact gepubliceerde naam met de bijbehorende puntkomma, in plaats van te vertrouwen op automatische foutcorrectie door de browser.

Heb ik voor elke letter met een accent een entiteit nodig?

Nee. Een HTML-document waarvan UTF-8 correct is gedeclareerd, kan tekens zoals é, £ en 中文 rechtstreeks bevatten. Entiteiten blijven nuttig wanneer de opmaaksyntaxis, een ouder systeem of een specifieke publicatieregel ze vereist.

Kan ik HTML-entiteiten in XML gebruiken?

In XML is slechts een kleine groep benoemde entiteiten vooraf gedefinieerd, waaronder &amp;, &lt;, &gt;, &quot; en &apos;. Veel namen die geldig zijn in HTML, zijn ongeldig in XML tenzij ze door een documenttype worden gedefinieerd. Numerieke tekenverwijzingen zijn daarom vaak de veiligere keuze.

Kan een entiteitsconverter kapotte HTML repareren?

Nee. De converter kan entiteitsverwijzingen omzetten, maar brengt tags niet in balans, herstelt geen onjuiste nesting en valideert geen documenten. Controleer na het omzetten de omliggende opmaakcode en gebruik een HTML-validator als de pagina zich nog steeds onverwacht gedraagt.

Laatste controles

Controleer of de bron benoemde of numerieke HTML-tekenverwijzingen gebruikt, zet alleen de vereiste tekenverwijzingslaag om en vergelijk het resultaat met de bedoelde zichtbare tekst. Bekijk eventuele punthaken, aanhalingstekens en ampersands in hun werkelijke HTML-context voordat je gedecodeerde inhoud op een live pagina plaatst.