Encodeur et décodeur d’entités HTML nommées

Convertissez du texte vers ou depuis des entités HTML nommées sans installer de bibliothèque ni dépendre du DOM d’un navigateur. Le mode d’encodage protège les caractères sensibles au balisage, notamment l’esperluette, les chevrons, les guillemets et l’apostrophe, ainsi que plusieurs symboles et signes typographiques courants. Le décodage restitue les entités reconnues et refuse les noms inconnus au lieu de masquer une erreur probable.

Encodez le texte avant de l’insérer dans du HTML

Choisissez le mode d’encodage lorsqu’un texte brut doit être représenté sans ambiguïté dans une source HTML. Une esperluette peut commencer une référence d’entité, les chevrons peuvent être pris pour des balises et les guillemets peuvent perturber la syntaxe environnante. Le convertisseur remplace les caractères pris en charge par des références nommées telles que <code>&amp;amp;</code>, <code>&amp;lt;</code>, <code>&amp;gt;</code>, <code>&amp;quot;</code> et <code>&amp;apos;</code>.

Il reconnaît aussi des caractères usuels liés aux devises, à la propriété intellectuelle, aux mathématiques, à la ponctuation et à l’espacement : copyright, marque déposée, euro, espace insécable, tirets, guillemets courbes, puces et points de suspension. Une seule passe est effectuée, de sorte que les esperluettes ajoutées par la conversion ne sont pas encodées une seconde fois. Les lettres, chiffres, espaces, emoji et caractères non couverts restent inchangés.

Cet encodage représente du texte, mais ne remplace pas un assainissement HTML complet : il ne valide pas un document, ne retire pas les balises dangereuses et ne garantit pas qu’une valeur convient à un contexte JavaScript, CSS ou URL.

Décodez les entités avec une validation stricte

Utilisez le décodage lorsque l’entrée contient des références nommées et que vous avez besoin des caractères d’origine pour l’affichage, la comparaison, l’indexation, l’exportation ou un autre traitement. Chaque référence complète composée d’une esperluette, d’un nom et d’un point-virgule est recherchée dans la table fixe de la capacité. Les formes reconnues sont remplacées par les caractères Unicode correspondants, sans modifier le texte environnant.

Les noms sont sensibles à la casse, car deux capitalisations peuvent avoir des sens différents en HTML. Ce refus strict sécurise les automatisations : une faute comme <code>&amp;copry;</code> ne traverse pas silencieusement la chaîne pour réapparaître sous forme de texte défectueux. Une esperluette ordinaire qui n’est pas suivie d’un nom et d’un point-virgule reste intacte.

Cette capacité vise uniquement les entités nommées ; les références numériques décimales et hexadécimales sont hors contrat. Le même dictionnaire fixe s’applique toujours, indépendamment du navigateur, d’une bibliothèque, du réseau ou des paramètres régionaux.

Choisissez le mode et intégrez le résultat

Envoyez deux champs : <code>text</code> contient la chaîne source et <code>mode</code> vaut <code>encode</code> ou <code>decode</code>. Tous deux sont obligatoires afin qu’une intégration n’ait jamais à deviner le sens de la conversion. La réponse renvoie le <code>text</code> converti ainsi que le <code>mode</code> appliqué, ce qui rend les journaux et les workflows explicites.

Pour encoder, transmettez le contenu rédigé avant son insertion dans le balisage, puis stockez ou envoyez le résultat. Pour décoder, considérez toute entité inconnue comme une erreur de validation et corrigez le producteur au lieu d’ignorer l’anomalie. L’algorithme n’utilise ni réseau, ni hasard, ni horodatage, ni état persistant ; il convient donc aux tests de référence et à la génération reproductible.

Dans un grand système, placez la conversion à une frontière nette : encodez à l’entrée d’une représentation HTML et décodez seulement à sa sortie. Alterner sans cesse les modes brouille la responsabilité de l’échappement et favorise un double encodage accidentel.