Aussi disponible en : English · Español · Português · العربية
Codes d’échappement ANSI : ce que fait chacun, et quelle norme le définit
Collez une sortie colorée pour la voir rendue et expliquée, ou composez une séquence et regardez diverger les deux écritures d’une même couleur.
Ce que sont les codes d’échappement ANSI
Une séquence d’échappement est une suite de caractères ordinaires que le terminal lit comme une instruction au lieu de l’afficher. Presque toutes celles que l’on rencontre commencent par le caractère d’échappement suivi d’un crochet ouvrant, puis quelques nombres, puis une lettre qui dit ce que ces nombres voulaient dire. Quand cette lettre finale est m, la séquence est SGR — Select Graphic Rendition — et les nombres sont les codes de couleur et d’attribut que tout le monde appelle codes de couleur ANSI.
Le mécanisme est simple et à état : un code active quelque chose, et cela reste actif jusqu’à ce qu’un autre le désactive. C’est pourquoi oublier la réinitialisation à la fin d’une chaîne colorée laisse le reste de l’invite de la mauvaise couleur, et pourquoi ces codes s’écrivent presque toujours par paires.
Ce qui n’est pas simple, c’est leur provenance. Tout ce qui se publie à leur sujet les présente en un seul tableau plat, et ce sont trois normes sous une même syntaxe. Les couleurs et attributs ordinaires relèvent d’ECMA-48. Les couleurs vives sont une extension de l’aixterm d’IBM. Les codes 256 couleurs et couleur vraie viennent d’ISO 8613-6, et la référence d’xterm les décrit comme marqués dans la cinquième édition d’ECMA-48 comme réservés à une normalisation future : les deux codes auxquels on recourt le plus sont donc, dans la norme que tout le monde cite à leur sujet, réservés plutôt que définis.
Comment s’en servir
- Collez une sortie de terminal, ou prenez un exemple. Les exemples couvrent un log de build, la même couleur écrite de façon standard, des vives face à des ordinaires, une séquence entièrement portable, et une comportant deux défauts.
- Lisez l’aperçu et le tableau des codes. L’aperçu montre ce qu’un terminal dessinerait. En dessous, chaque code SGR trouvé est listé avec la norme qui le définit et ce qu’il signifie, et les remarques expliquent ce qu’il faut savoir de ce que vous avez collé.
- Composez-en une et comparez les écritures. Activez gras, italique et souligné, choisissez une couleur, et la même instruction apparaît deux fois : une fois avec des deux-points, une fois avec des points-virgules. Elles veulent dire la même chose et ne sont pas interchangeables.
Le séparateur que personne n’écrit de façon standard
Les codes de couleur étendue prennent des sous-paramètres : 38 annonce une couleur d’avant-plan, puis 5 et un index dans la palette de 256, ou 2 et trois valeurs de canal pour la couleur vraie. La référence d’xterm écrit ces sous-paramètres séparés par des deux-points, et indique clairement qu’elle admet aussi bien les deux-points, qu’elle qualifie de standard, que les points-virgules, qu’elle qualifie d’hérités. Tous les tutoriels, toutes les bibliothèques et tous les outils émettent la forme à points-virgules.
Ce n’est pas affaire de goût, et le coût retombe sur celle que vous choisissez. En lisant le code des deux moteurs de rendu JavaScript les plus employés pour cela, tous deux découpent les paramètres au seul point-virgule — l’un par un découpage direct, l’autre en rognant les points-virgules finaux puis en découpant de même — et aucun ne contient de deux-points où que ce soit dans son traitement des paramètres. L’écriture que la référence qualifie de standard est donc exactement celle que ces bibliothèques laissent tomber en silence : la couleur disparaît et le texte s’affiche sans style, sans la moindre erreur nulle part.
Il y a une seconde victime sur la même ligne. La forme à deux-points de la couleur vraie porte un identifiant d’espace colorimétrique avant la valeur de rouge, habituellement écrit vide, de sorte que l’écriture complète comporte un trou qui ressemble à une faute de frappe. La forme à points-virgules n’a aucune place pour ce champ, et c’est pourquoi presque personne ne sait qu’il existe.
Le résumé honnête est qu’aucune écriture n’est à la fois standard et largement prise en charge, et c’est pourquoi cette page vous dit quel compromis fait votre séquence plutôt que de désigner l’une des deux comme la bonne. Si vous écrivez pour un terminal, la forme à points-virgules est celle qu’attendent les terminaux. Si vous écrivez pour une spécification, la forme à deux-points est celle qu’elle énonce.
Ce que cette page ne peut pas vous dire
Les seize premières couleurs ne sont fixées par rien. Les codes 30 à 37 nomment une couleur, pas une valeur : à quoi ressemble réellement le rouge dépend du thème du terminal de celui qui regarde, et la même sortie donne deux images différentes dans deux fenêtres voisines. L’aperçu emploie ici un jeu courant pour qu’il y ait quelque chose à voir : c’est une démonstration, pas une réponse. À partir de l’index 16, c’est l’inverse — le cube de 216 couleurs et la rampe de 24 gris sont définis par l’arithmétique, donc exacts.
La formule sur la réservation en vue d’une normalisation future est la caractérisation d’ECMA-48 par xterm, non une citation d’ECMA-48. ECMA-48 est publiée sous forme de PDF qui a résisté à l’extraction de texte à chaque tentative faite ici : plutôt que de paraphraser un document qui n’a pas pu être lu, l’attribution reste là où elle est vérifiable, auprès de la référence qui avance l’affirmation.
Seul SGR est interprété. Une séquence qui déplace le curseur, efface l’écran ou fixe le titre de la fenêtre est reconnue, signalée, puis laissée telle quelle : la rendre reviendrait à simuler un terminal entier plutôt qu’à expliquer un code de couleur. Les séquences qui ne commencent pas par le couple échappement et crochet — les anciens contrôles à un seul caractère, et les commandes au système d’exploitation qui fixent un titre — sortent de ce que ceci lit.
Enfin, ceci décrit ce que signifient les codes, non ce qu’en fait votre terminal. Le clignotement est presque partout ignoré. L’atténué est ignoré par les uns et rendu comme une couleur plus terne par les autres. Le souligné double est inégal. Un terminal a le droit de ne rien faire d’un code qu’il n’implémente pas, et la plupart font discrètement exactement cela.
Pourquoi est-ce gratuit ?
Analyser des séquences d’échappement relève du traitement de chaînes, et cela s’exécute dans votre navigateur. Aucun serveur n’intervient : il n’y a donc rien à facturer ni de compte à créer.
Rien n’est envoyé, ce qui compte ici plus qu’ailleurs : une sortie de terminal collée contient souvent des chemins, des noms de machines et, à l’occasion, un jeton. Rechargez la page et elle aura tout oublié.