BiDi: ペルシア語/英語の混在コンテンツ
Unicode BiDiアルゴリズムは、混在方向のテキストを自動的に並べ替えますが、時には誤った順序になります。このスキルは、いつ介入すべきか、そして正確にどのようにするかを教えます。
1. メンタルモデル
- ベース方向は、最も近い祖先の
dir(ページ: RTL)から決定されます。 - 強いLTRコンテンツ(ラテン文字)の連続は埋め込まれ、内部ではLTRで流れます。
- 中立文字(句読点、数字に隣接する記号 + - / $ % など)は周囲の方向を取ります。これがスクランブルの原因です。
2. 介入ツールボックス
| ツール | 使用場面 | 例 |
|---|---|---|
<bdi> 要素 | ペルシア語テキスト内のインラインの外部要素、方向が不明な場合 | «فایل report_final.pdf را ببینید» |
<span dir="ltr"> | 既知のLTR要素で、内部でも左揃えにしたい場合 | <span dir="ltr">+98 912 345 6789</span> |
dir="auto" | ユーザー生成または予測不可能なコンテンツ | チャットバブル、コメント、ファイル名 |
CSS unicode-bidi: plaintext | スタイル付きspanで dir="auto" と同様の動作 | .user-content { unicode-bidi: plaintext; } |
isolate(bdiのデフォルト) | 要素が隣接要素の並べ替えを防ぐ | <bdi> のデフォルト動作 |
3. 標準的なケース
電話番号
ペルシア語テキスト内の +98 912 は、+ が間違った側に表示されることがよくあります。
تلفن پشتیبانی: <span dir="ltr">+98 21 9100 2000</span>
外国通貨の価格
RTLテキスト内の $99 は 99$ になります。
اشتراک جهانی: <span dir="ltr">$99/mo</span> — اشتراک داخلی: ۹۹٬۰۰۰ تومان
メール、URL、ハンドル
به <bdi>[email protected]</bdi> ایمیل بزنید.
مستندات: <bdi>https://docs.example.co/fa</bdi>
文中のラテンブランド名
通常はプレーンテキストで問題ありませんが、ペルシア語の接尾辞が付くと壊れます。
「نسخهی جدید Node.js」— 「Node.js」は安全です。「های Node.js」の場合、ラテン文字列の周りに <bdi> が必要です: <bdi>Node.js</bdi>های は間違い — 「افزونههای Node.js」のように言い換えてください。
コードとコマンド — 常にLTRブロック
<pre dir="ltr" style="text-align: left;">npm install raast</pre>
ペルシア語の散文内のインラインコマンド: <code dir="ltr">npx create-next-app</code>。
混在アイテムのリスト
アイテムマーカー(۱ ۲ ۳)はRTLの流れの中にあります。長いLTRアイテムは各アイテムごとに分離されたままです — ラテン文字/数字で始まるアイテムには <bdi> を配置してください。
製品識別子、シリアル番号、技術ID
最もスクランブルされやすいカテゴリ — 文字、数字、ダッシュが混在します:
شماره سریال: <bdi dir="ltr">SN-9F42-KM18</bdi>
کد پیگیری: <bdi dir="ltr">TRK-IR-14050823-0042</bdi>
شناسه محصول: <bdi dir="ltr">SKU 88451-B</bdi>
ルール:
- 識別子はコピーされたときにバイト完全でなければなりません。分離はレンダリングのみを変更し、文字列は決して変更しません。
- RTL文内の末尾のダッシュ/数字の連続は、
<bdi>なしでは並べ替えられます(例:88451-B→B-88451)。 - JSで構築されたデータベースルックアップ: 論理文字列を保持し、「表示用に事前反転」しないでください。
- テーブルのID列には、等幅フォント +
dir="ltr"+text-align: startを使用します。
ユーザー生成コンテンツ(チャット、コメント、ファイル名)
- コンテナ:
dir="auto"+ CSSunicode-bidi: plaintext— 各メッセージは最初の強い文字によって方向付けされます。 - ペルシア語ユーザーが英語のテキストを貼り付ける場合、またはその逆の場合でも、手動で
dirを切り替えることなく正しく読める必要があります。 dir="rtl"+text-align: startだけでは、ページの方向をUGCに強制しないでください。plaintextの要点は最初の強い文字ルールです。- ファイル名/ダウンロード: 拡張子(
.pdf、.zip)が分離しないように<bdi>でレンダリングします。
4. フォーム入力
dir="auto": 入力は最初の強い文字の方向を採用します — 名前/メッセージフィールドに適しています。- 明示的な
dir="ltr": メール、電話、ユーザー名、カード番号、URL、価格(text-align: endを使用するとRTLユーザーにとってカーソルが右から始まります...実際にはLTR入力ではtext-align: startのままにし、カーソルの動作をテストしてください)。
5. スクランブル出力のデバッグ — チェックリスト
- 要素はラップ/分離されていますか?(bdi / span dir=ltr)
- 中立文字(
+ - / . , ( ))が方向の境界に隣接していますか? 分離またはRLM(\u200F)/LRM(\u200E)マークを追加してください。 - LTR要素の末尾の句読点が間違った端にジャンプしていますか? → 分離内に末尾のスペースを含めてください。
- JSで構築された文字列ですか? BiDiはレンダリングの問題です — コード内で並べ替えを行わず、DOM/CSSを修正してください。
- 不可視文字のダンプ: BiDiインスペクターに貼り付けるか、
JSON.stringify()でテキストを出力してU+200E/Fの配置を確認してください。
6. RLM/LRM — メス
‏ (U+200F) / ‎ (U+200E) は、分離が不可能な場合(プレーンテキストメール、CSVセルなど)に中立文字を片側に強制します:
متن فارسی +98 -> + を数字に付けたままにする
控えめに使用してください — 一部のフォントで可視の文字化けが発生します。ウェブでは構造的分離を優先してください。
7. タイトル、メタ、単一行コンテキスト
- スクリプトが混在する
<title>: ブラウザはタブ内でBiDiを適切にレンダリングしますが、ページの言語で始めてください: «raast — مهارتهای RTL» 対 «مهارتهای RTL — raast»: ページ言語の強いスクリプトを先頭に配置します。 aria-label文字列も同じルールに従います。スクリーンリーダーはUnicode BiDiマークを処理するため、マークを保持してください。- JSON/APIペイロード: 常に論理順序で保存し、表示用に事前反転しないでください。