Communitygithub.com

rtl-bidi

Gérez le mélange de texte persan/arabe avec l'anglais, les nombres, les numéros de téléphone, les e-mails, les URL, le code et les devises dans les interfaces RTL. Utilisez-le lorsque le texte contient les deux scripts, lorsque la sortie semble mélangée avec un mauvais ordre ou placement, ou pour les champs de saisie, les prix et les blocs de code sur les pages RTL. Couvre l'algorithme bidi, les éléments bdi, le CSS unicode-bidi et les bugs de mélange courants.

Qu'est-ce que rtl-bidi ?

Cette compétence résout les problèmes d'affichage liés à l'algorithme BiDi (bidirectionnel) d'Unicode lorsqu'un texte mélange du persan/arabe (écriture RTL) avec de l'anglais, des chiffres, des URL, des e-mails, des numéros de téléphone, du code ou des devises. L'algorithme BiDi réordonne automatiquement le texte de directions opposées, mais il fait parfois des erreurs, notamment avec les caractères neutres comme la ponctuation ou les symboles monétaires (+, -, /, $, %), qui prennent la direction de leur entourage et peuvent sauter du mauvais côté. La compétence fournit une boîte à outils d'intervention complète avec l'élément HTML `<bdi>`, les attributs `dir="ltr"`, `dir="auto"` et la propriété CSS `unicode-bidi: plaintext`. Elle explique quand utiliser chaque outil à l'aide d'exemples concrets : numéros de téléphone, prix en devises étrangères, e-mails, URLs, noms de marques latins, identifiants techniques (SKU, numéros de série), code et contenu généré par l'utilisateur. Elle couvre également les marques RLM/LRM (U+200F/U+200E) comme solution de dernier recours pour les contextes en texte brut (e-mails, CSV) où l'isolement structurel n'est pas possible. La compétence détaille les cas canoniques de scrambling (inversion +/chiffres, déplacement de l'extension de fichier) et propose une checklist de débogage : vérifier l'isolement, les caractères neutres adjacents à une frontière de direction, l'inclusion de l'espace de fin dans l'isolement, ne pas réordonner dans le code JS (le bidi est un problème de rendu), et inspecter les caractères invisibles avec `JSON.stringify()`. Elle donne aussi des conseils pour les titres (`<title>`), les attributs `aria-label` et les payloads JSON/API (toujours stocker dans l'ordre logique, jamais pré-inverser).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mhmdsdqi87-cloud/TEKA_raast/tree/HEAD/skills/rtl-bidi

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Bidi : Contenu mixte persan/anglais

L'algorithme BiDi d'Unicode réordonne automatiquement le texte de direction mixte — parfois mal. Cette compétence enseigne quand intervenir et comment exactement.

1. Le modèle mental

  • La direction de base provient de l'attribut dir sur l'ancêtre le plus proche (page : RTL).
  • Les séquences de contenu fortement LTR (lettres latines) s'incrustent et s'écoulent de gauche à droite à l'intérieur.
  • Les caractères neutres (ponctuation, signes adjacents aux chiffres comme + - / $ %) prennent la direction de leur environnement — c'est là que le scrambling se produit.

2. La boîte à outils d'intervention

OutilQuandExemple
Élément <bdi>Atome étranger en ligne dans du texte persan, direction inconnue«فایل report_final.pdf را ببینید»
<span dir="ltr">Atome connu LTR que vous voulez aussi aligné à gauche en interne<span dir="ltr">+98 912 345 6789</span>
dir="auto"Contenu généré par l'utilisateur ou imprévisiblebulles de chat, commentaires, noms de fichiers
CSS unicode-bidi: plaintextIdentique à dir="auto" mais pour les spans stylisés.user-content { unicode-bidi: plaintext; }
isolate (par défaut pour bdi)Empêche l'atome de réordonner ses voisinscomportement par défaut de <bdi>

3. Cas canoniques

Numéros de téléphone

+98 912 dans un texte persan affiche souvent le + du mauvais côté.

تلفن پشتیبانی: <span dir="ltr">+98 21 9100 2000</span>

Prix en devise étrangère

$99 flottant dans un texte RTL devient 99$ :

اشتراک جهانی: <span dir="ltr">$99/mo</span> — اشتراک داخلی: ۹۹٬۰۰۰ تومان

E-mails, URLs, handles

به <bdi>[email protected]</bdi> ایمیل بزنید.
مستندات: <bdi>https://docs.example.co/fa</bdi>

Noms de marques latins en milieu de phrase

Généralement corrects en texte brut, mais après un suffixe persan, ça casse : «نسخه‌ی جدید Node.js» — «Node.js» est sûr ; «های Node.js» nécessite <bdi> autour de la séquence latine si un suffixe s'attache : <bdi>Node.js</bdi>های est faux — reformulez en «افزونه‌های Node.js».

Code & commandes — toujours des blocs LTR

<pre dir="ltr" style="text-align: left;">npm install raast</pre>

Commandes en ligne dans un texte persan : <code dir="ltr">npx create-next-app</code>.

Listes d'éléments mixtes

Les marqueurs d'éléments (۱ ۲ ۳) vivent dans le flux RTL ; les longs éléments LTR à l'intérieur restent isolés par élément — mettez <bdi> sur tout élément commençant par des lettres latines/chiffres.

Identifiants de produits, numéros de série et ID techniques

La catégorie la plus sujette au scrambling — mélange de lettres, chiffres et tirets :

شماره سریال: <bdi dir="ltr">SN-9F42-KM18</bdi>
کد پیگیری: <bdi dir="ltr">TRK-IR-14050823-0042</bdi>
شناسه محصول: <bdi dir="ltr">SKU 88451-B</bdi>

Règles :

  • Les identifiants doivent rester byte-exacts lors du copier-coller — l'isolement ne change que le rendu, jamais la chaîne.
  • Les séquences de tirets/chiffres en fin de phrase RTL se réordonneront sans <bdi> (ex. 88451-B → B-88451).
  • Recherches en base de données construites en JS : conservez la chaîne logique ; ne « pré-inversez » pas pour l'affichage.
  • Police monospace à largeur fixe + dir="ltr" + text-align: start pour les colonnes d'ID dans les tableaux.

Contenu généré par l'utilisateur (chat, commentaires, noms de fichiers)

  • Conteneur : dir="auto" + CSS unicode-bidi: plaintext — chaque message s'oriente selon son premier caractère fort.
  • Un utilisateur persan collant du texte anglais, ou vice versa, doit lire correctement sans changer manuellement dir.
  • N'imposez jamais la direction de la page sur le contenu généré par l'utilisateur avec dir="rtl" + text-align: start seul ; la règle du premier caractère fort est l'essence de plaintext.
  • Noms de fichiers/téléchargements : affichez-les dans <bdi> pour que les extensions (.pdf, .zip) ne se détachent pas.

4. Champs de saisie de formulaires

  • dir="auto" : le champ adopte la direction du premier caractère fort — idéal pour les champs de nom/message.
  • dir="ltr" explicite : e-mail, téléphone, nom d'utilisateur, numéro de carte, URL, prix (avec text-align: end pour que le curseur commence à droite pour les utilisateurs RTL... en fait, gardez text-align: start sur le champ LTR pour la santé mentale du curseur ; testez).

5. Débogage d'un affichage mélangé — la checklist

  1. L'atome est-il encapsulé/isolé ? (bdi / span dir=ltr)
  2. Les caractères neutres (+ - / . , ( )) sont-ils adjacents à une frontière de direction ? Ajoutez un isolement ou une marque RLM (\u200F)/LRM (\u200E).
  3. La ponctuation finale d'un atome LTR saute-t-elle à la mauvaise extrémité → incluez l'espace de fin dans l'isolement.
  4. Chaîne construite en JS ? Le bidi est un problème de rendu — ne réordonnez pas dans le code, corrigez le DOM/CSS.
  5. Vidage des caractères invisibles : collez dans un inspecteur bidi ou utilisez JSON.stringify() sur le texte pour voir le placement des U+200E/F.

6. RLM/LRM — le scalpel

&rlm; (U+200F) / &lrm; (U+200E) forcent les caractères neutres d'un côté lorsque l'isolement est impossible (ex. e-mails en texte brut, cellules CSV) :

متن فارسی‎ +98‎  -> garde le + attaché au nombre

À utiliser avec parcimonie — mojibake visible dans certaines polices ; préférez l'isolement structurel sur le web.

7. Titres, métadonnées et contextes sur une seule ligne

  • <title> avec scripts mixtes : les navigateurs rendent le bidi dans les onglets raisonnablement, mais commencez par la langue de la page : «raast — مهارت‌های RTL» vs «مهارت‌های RTL — raast» : mettez le script fort de la langue de la page en premier.
  • Les chaînes aria-label suivent les mêmes règles ; les lecteurs d'écran gèrent les marques bidi Unicode, donc conservez-les.
  • Les payloads JSON/API : stockez toujours dans l'ordre logique ; ne pré-inversez jamais quoi que ce soit pour l'affichage.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés