右から左 (RTL) サポート
Ignite UI for React コンポーネントは右から左 (RTL) のレイアウトをサポートします。ページに dir="rtl" を設定すると、コンポーネントのレイアウトとキーボード操作の大部分が反転します。RTL 用の別のテーマは必要ありません。
概要
Ignite UI for React は、標準の HTML dir 属性から方向を取得します。方向を設定するプロパティを持つコンポーネントはなく、テーマの RTL 版もありません。既に読み込んでいるテーマが両方の方向に対応します。
| レイヤー | 方向に従う仕組み |
|---|---|
| スタイル | コンポーネントのスタイルは、margin-inline-start などの CSS 論理プロパティと方向セレクターを使用するため、方向が変わるとすぐにレイアウトが反転します。 |
| 操作 | Carousel、Slider、Stepper、Tabs など、水平方向のキーボード操作またはポインター操作を持つコンポーネントは、ユーザーが操作したときに方向を読み取ります。RTL では、Arrow Left キーと Arrow Right キーが読み順の方向に従います。 |
一部のコンポーネントは、方向に部分的にしか従いません。React での該当コンポーネントは、既知の制限に記載されています。
はじめる前に
RTL はレイアウトを反転するもので、テキストを翻訳するものではありません。 dir 属性が変更するのは読み順の方向のみです。コンポーネントの文字列を別の言語で表示するには、ローカライゼーションを参照してください。
方向は 1 か所で設定します。 アプリケーション全体の場合は、body 要素に dir="rtl" を設定します。ページの一部のみを反転するには、ページの一部に RTL を適用するで説明しているように、代わりにコンテナーに設定します。
独自のコンテンツにも論理プロパティが必要です。 コンポーネントは自動的に反転しますが、margin-left などの物理プロパティで記述したスタイルは、配置した位置に留まります。RTL 向けに独自のコンテンツのスタイルを設定するを参照してください。
次のステップ
- ホスト ページで、アプリケーション全体で RTL を有効にします。
- ユーザーが言語を変更したときに、実行時に方向を切り替えます。
- アプリケーションで使用するコンポーネントの既知の制限を確認します。
利用可能なツール
| ツール | 場所 | 機能 |
|---|---|---|
dir 属性 |
任意の HTML 要素 (通常は body) |
要素とその内部のすべての方向を設定します。rtl、ltr、auto を受け付けます。 |
| CSS 論理プロパティ | 独自のスタイルシート | padding-left の代わりに padding-inline-start を使用するなど、読み順の方向を基準にコンテンツを配置します。 |
:dir(rtl) 擬似クラス |
独自のスタイルシート | dir 属性が要素自体と祖先要素のどちらにある場合でも、方向が右から左である要素に一致します。 |
方向を示すアイコン用に、Icon と Icon Button には mirrored プロパティもあります。方向を示す Icon を反転するを参照してください。
一般的なワークフロー
アプリケーション全体で RTL を有効にする
ホスト ページの body 要素に dir="rtl" を設定します。ページ上のすべての Ignite UI for React コンポーネントが右から左にレンダリングされます。
アプリケーションの index.html で属性を設定します:
<!doctype html>
<html lang="ar">
<head>
<meta charset="utf-8" />
<title>My App</title>
</head>
<body dir="rtl">
<!-- application content -->
</body>
</html>
実行時に方向を切り替える
ユーザーが別の言語を選択したときなど、アプリケーションの実行中に方向を変更するには、body 要素の dir 属性を設定します。コンポーネントのスタイルはすぐに更新され、コンポーネントは次にユーザーが操作したときに新しい方向を読み取ります。
function setDirection(dir: 'ltr' | 'rtl') {
document.body.dir = dir;
}
ページの一部に RTL を適用する
アラビア語やヘブライ語のコンテンツを含むパネルなど、ページの一部のみを反転するには、その部分を含む要素に dir="rtl" を設定し、body は左から右のままにします。要素内のコンポーネントは、その要素の方向に従います。
次のサンプルでは、dir="rtl" を設定したコンテナーに Calendar を配置しています。Change Directionality を選択すると、コンテナーの方向が右から左と左から右の間で切り替わります。
Carousel と Navigation Drawer のナビゲーション ボタン、インジケーター、スライド方向が反転するのは、dir="rtl" が body 要素またはコンポーネント自体に設定されている場合のみです。右から左のコンテナー内では、これら 2 つのコンポーネントにも dir="rtl" を設定します:
<div dir="rtl">
<IgrCarousel dir="rtl"></IgrCarousel>
</div>
方向を示す Icon を反転する
ほとんどのアイコンはどちらの方向でも同じように見えるため、アイコンは自動的には反転しません。矢印など、読み順の方向を指すアイコンの場合は、mirrored を設定すると、右から左のレイアウトでアイコンが水平方向に反転します。Icon と Icon Button がこれをサポートしています。
RTL 向けに独自のコンテンツのスタイルを設定する
独自のコンテンツのスタイルを CSS 論理プロパティで記述すると、コンポーネントと一緒に反転します。一方の方向にのみ適用するルールには、:dir(rtl) 擬似クラスを使用します:
.toolbar {
padding-inline-start: 16px; /* left in LTR, right in RTL */
}
.next-icon:dir(rtl) {
transform: scaleX(-1);
}
既知の制限
Ignite UI for React では、次のコンポーネントは方向に部分的にしか従いません。
| コンポーネント | 方向に従わない部分 |
|---|---|
| Grid、Tree Grid、Hierarchical Grid、Pivot Grid | レイアウトと水平スクロールは方向に従いますが、キーボード ナビゲーションは従いません。Arrow Left はフォーカスを前の列に、Arrow Right は次の列に移動するため、RTL では Arrow Left でフォーカスが右に移動します。 |
| Calendar (Date Picker と Date Range Picker のカレンダーを含む) | どちらの方向でも、Arrow Left は前日に、Arrow Right は翌日に移動します。 |
| Carousel、Navigation Drawer | ナビゲーション ボタン、インジケーター、スライド方向が反転するのは、dir="rtl" が body 要素またはコンポーネント自体に設定されている場合のみで、html 要素やその他の祖先要素に設定されている場合は反転しません。 |
コンポーネントがこのページの説明どおりに方向に従わない場合は、Ignite UI for React の Issue トラッカーで報告してください。
トラブルシューティング
Carousel の矢印が逆方向を指すのはなぜですか?
Carousel と Navigation Drawer は、body 要素の方向と自身の dir 属性を組み合わせます。dir="rtl" が html 要素にのみ設定されている場合は左から右にレンダリングされ、body 要素とコンポーネントの両方に設定されている場合は 2 つが打ち消し合います。dir="rtl" は 1 か所で設定してください。ページ全体の場合は body 要素に、右から左のコンテナー内のコンポーネントの場合はそのコンポーネントに設定します。
RTL で独自のコンテンツが左側に残るのはなぜですか?
margin-left や float: left などの物理プロパティを使用するスタイルは反転しません。RTL 向けに独自のコンテンツのスタイルを設定するで示しているように、margin-inline-start や float: inline-start などの論理プロパティに置き換えてください。
その他のリソース
- アクセシビリティ準拠 — Ignite UI for React が対象とするアクセシビリティ標準。
- MDN の
dir属性 — 値と継承。 - MDN の CSS 論理プロパティと値 — 方向に合わせて反転するプロパティ。
- HTML の構造マークアップと右から左のテキスト (W3C) — ドキュメント内で方向を設定する場所。
FAQ
ホスト ページの body 要素に dir="rtl" を設定します。Ignite UI for React コンポーネントは dir 属性から方向を取得するため、コンポーネントの設定や追加のパッケージは必要ありません。ページの一部のみを反転するには、代わりにコンテナー要素に属性を設定します。
いいえ。Ignite UI for React のテーマは両方の方向をサポートしており、左から右のページと右から左のページの両方に同じテーマ CSS を使用できます。
はい。body 要素、またはコンポーネントを含むコンテナーの dir 属性を変更します。Ignite UI for React コンポーネントのスタイルはすぐに更新され、コンポーネントは次にユーザーが操作したときに新しい方向を読み取ります。
一部サポートしています。Grid、Tree Grid、Hierarchical Grid、Pivot Grid は、ページの方向に合わせて列を配置し、水平方向にスクロールしますが、矢印キーによるナビゲーションは反転しません。RTL では、Arrow Left でフォーカスが前の列 (右側にある列) に移動します。
いいえ。dir 属性が変更するのは、読み順の方向とレイアウトのみです。組み込みのコンポーネント文字列の翻訳は、別のローカライゼーション手順です。