Communitygithub.com

rtl-components

Tailwindの論理ユーティリティを使用したRTL対応コンポーネントパターン。フォーム、カード、ナビゲーション、テーブル、モーダル、ページネーション、パンくずリスト、またはペルシャ語/アラビア語RTLページ向けのUIコンポーネントを構築する際や、ミラーリングレイアウトのバグを修正する際に使用します。ms/me/ps/peユーティリティ、アイコンフリップ、サイドバーの配置、shadcn/ui RTLに関する注意事項をカバーします。

rtl-components とは?

このスキルは、RTL(右書き)言語向けのUIコンポーネントを構築するための実践的なパターン集です。Tailwind CSSの論理プロパティ(ms/me, ps/pe, start/end)を使用することで、LTRとRTLの両方で自動的に正しく表示されるコンポーネントを作成できます。特に、Tailwind v3.3以降とv4をサポートし、shadcn/uiとの組み合わせに関する具体的な注意点も網羅しています。 フォーム、ナビゲーション、オーバーレイ、カード、アニメーションなど、UIコンポーネントの各カテゴリごとに、RTL対応のために必要な実装パターンとバグを避けるためのヒントを提供します。例えば、方向性のあるアイコンのみを反転させるルール、サイドバーの配置、RTLでのページネーションの正しい順序、パースペクティブ混みのアニメーションの実装方法などが含まれます。 また、`rtl-audit`チェックリストを提供し、開発者がコンポーネントをリリースする前にRTL対応の確認を徹底できるようにします。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントと組み合わせて、RTLコンポーネントのコード生成やレビューを効率的に行うために設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mhmdsdqi87-cloud/TEKA_raast/tree/HEAD/skills/rtl-components

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

RTLコンポーネントパターン(Tailwind + shadcn/ui)

方向に依存しない論理コンポーネント。dir="rtl"を設定すると、flex/gridは自動的にミラーリングされます。バグはここにリストされた残りの部分に潜んでいます。

1. ユーティリティ変換表(暗記すること)

LTRの習慣論理プロパティ(常に使用)
ml- / mr-ms- / me-
pl- / pr-ps- / pe-
left-0 / right-0start-0 / end-0
text-left / text-righttext-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 またはflex gap-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クラスを確認します。

Individual skills in this repo

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

関連スキル