RTLコンポーネントパターン(Tailwind + shadcn/ui)
方向に依存しない論理コンポーネント。dir="rtl"を設定すると、flex/gridは自動的にミラーリングされます。バグはここにリストされた残りの部分に潜んでいます。
1. ユーティリティ変換表(暗記すること)
| LTRの習慣 | 論理プロパティ(常に使用) |
|---|---|
ml- / mr- | ms- / me- |
pl- / pr- | ps- / pe- |
left-0 / right-0 | start-0 / end-0 |
text-left / text-right | text-start / text-end |
border-l- / border-r- | border-s- / border-e- |
rounded-l- / rounded-r- | rounded-s- / rounded-e- |
ml-auto(遠い側に押し出す) | ms-auto |
これらはTailwind v3.3以降およびv4に存在します。これらを使用することで、コンポーネントは両方向で無料で動作します。
2. 方向性アイコン — 反転リスト
真に方向性のあるアイコンのみを反転します。意味的に安定したアイコンは絶対に反転しないでください。
反転する(rtl:-scale-x-100 または事前に反転されたSVG、または矢印には rtl:rotate-180):
- 次へ/前へ、戻るボタン、パンくずリストのセパレータ用のシェブロン/矢印
- インデント/アウトデント、返信(共有矢印)、転送、やり直し
- タイムラインマーカー、「サイドパネルを展開」アイコン
反転しない:
- 時計、ロック、検索、設定、チェック、ハート、スター、アップロード/ダウンロード、WiFi、ベル
<!-- RTLでの次への矢印は左を指す -->
<svg class="rtl:rotate-180">…</svg>
shadcn/ui + lucideの場合: <ChevronLeft className="rtl:rotate-180" /> は二重に間違っています。代わりに、提供する方向に適した正しいグリフを使用してください。RTL専用のプロダクトの場合: 次へ = ChevronLeft、戻る = ChevronRight。
3. フォーム
- ラベルは入力の上、インラインの先頭に配置します(標準)。
- テキスト入力: 名前/メッセージには
dir="auto"。電話番号、メール、国民ID、価格入力にはdir="ltr"+text-end(コンテンツはLTRですが、配置は右側に保たれます)。 - 入力グループアドオン: 通貨「تومان」は数値の後 → 視覚的に左側。両側に論理パディングを使用し、
prをハードコードしないでください。 - バリデーションアイコン:
right-0ではなくend-0で配置します。 - エラーテキスト: ペルシャ語で、「؛」と正しいZWNJを使用:「ایمیل معتبر نیست」、「رمز عبور باید ۸ نویسه یا بیشتر باشد」。
4. ナビゲーションとクローム
- サイドバー:
start-0(RTLでは右側にレンダリングされます)。アイコンのみの折りたたみバリアントは、ツールチップを反転させ続けます(Radixツールチップではside="start")。 - パンくずリスト: セパレータ =
ChevronLeft(RTLの「前方下方向」の方向)、最後のアイテムが現在地。 - ページネーション: ページ番号は左に向かって昇順: ۱ ۲ ۳ 4 で、次へ = ChevronLeft。
Prevは視覚的に右側にあります。 - タブ: 順序は右→左に流れます。アクティブな下線は
border-bで問題ありません。 - テーブル: 列の順序は自動的にミラーリングされます。数値セルは
text-endで配置し、ペルシャ数字の数字が独自のLTRランを維持できるようにします。
5. オーバーレイ
- ダイアログ/シート:
Sheet side="start"= RTLページでは右側のドロワー。 - ドロップダウン/ポップオーバー: Radixは
side/alignを使用 —align="start"はインラインの先頭(右側)に従います。デフォルトの衝突解決はRTLで正常に機能します。 - トースト: 位置
bottom-start(RTLでは視覚的に右下)に配置して、インラインの末尾にあるCTAと競合しないようにします。 - 切り詰められたペルシャ語テキストのツールチップ: Radixは正しく計測します。
max-wが設定されていることを確認してください。ペルシャ語の省略記号は正常に機能します。
6. カードとコンテンツブロック
- インラインの先頭端のアクセントバー:
border-s-2 border-s-emerald-500(右側にレンダリングされます)。 - メタ行(著者 · 日付 · 読了時間): 区切りドットは
ms-2 me-2またはflexgap-2を使用します。 - アクション付きのカード: プライマリアクションはインラインの末尾?いいえ — RTLの読み方では、プライマリCTAは従来、カードフッターのインライン末尾(左側)に配置され、LTRの慣習をミラーリングします。
7. モーションとトランスフォーム
dirはトランスフォームをミラーリングしません。以下すべてを監査してください。
translate-x-*(スライダー、オフキャンバス、マーキー)→ 明示的なRTLの双子が必要rotate-45装飾 → 通常は問題なし- カルーセルのスワイプ: embla/swiper —
direction: rtlオプションを設定するか、スクロールが逆方向になります - プログレスバー: 塗りつぶしは
start-0に固定され、左に向かって成長します。パーセンテージは ۷۰٪ - スケルトンシマー: キーフレーム
translate-xはミラーリングする必要があります。そうしないと、シマーが間違った方向にスライドします。
方向を意識したアニメーションパターン
/* オフキャンバスドロワー: インラインの先頭から入り、インラインの先頭に出る。
一組の宣言で両方向に対応します。 */
.drawer { transform: translateX(calc(var(--dir-sign, -1) * 100%)); }
[dir="rtl"] .drawer { --dir-sign: 1; }
.drawer.open { transform: translateX(0); }
/* バウンス/強調アイコン: 要素の飛行中ではなく、アニメーション全体を反転します */
[dir="rtl"] .cta-arrow { animation: nudge-rtl 1.2s infinite; }
@keyframes nudge-rtl { 50% { transform: translateX(-4px); } }
/* 数字カウンターとプログレス塗りつぶし: leftではなく、論理的なインラインサイズをアニメーション化します */
@keyframes fill { from { inline-size: 0 } }
- CSSの論理
inset-inline-start+ カスタムプロパティの符号切り替えは、方向ごとにキーフレーム全体を複製するよりも優れています。 prefers-reduced-motion: reduce→ ナッジ/マーキーを無効にし、不透明度フェードは維持します。
8. shadcn/ui RTLに関する注意事項(v4トークン、New Yorkスタイル)
- ほとんどのプリミティブは、アプリが
<html>にdir="rtl"を設定すると、RTLで正常に動作します。 - 既知のタッチアップ:
DropdownMenuContent align="start"は、メニューをトリガーの右端の下に固定します。SelectのシェブロンはChevronDown(方向フリー、変更なし)である必要があります。InputOTP、CommandDialog、ResizablePanelは手動レビューが必要です。 - フォントトークンを一度設定する: Vazirmatnを
--font-sans(globals.css)に設定すると、すべてのshadcnコンポーネントがそれを継承します。
9. 監査フック
rtl-auditチェックリストを使用してコンポーネントを出荷してください。特にアイコンの反転、トランスフォーム、left/rightクラスを確認します。