Close
Angular React Web Components Blazor Angular
Open Source

右から左 (RTL) サポート

Ignite UI for Angular コンポーネントは右から左 (RTL) のレイアウトをサポートします。ページに dir="rtl" を設定すると、コンポーネントのレイアウトとキーボード操作の大部分が反転します。RTL 用の別のテーマは必要ありません。

概要

Ignite UI for Angular は、標準の HTML dir 属性から方向を取得します。方向を設定するプロパティを持つコンポーネントはなく、テーマの RTL 版もありません。既に読み込んでいるテーマが両方の方向に対応します。

レイヤー 方向に従う仕組み
スタイル コンポーネントのスタイルは、margin-inline-start などの CSS 論理プロパティと方向セレクターを使用するため、方向が変わるとすぐにレイアウトが反転します。
操作 Carousel、Slider、Stepper、Tabs など、水平方向のキーボード操作またはポインター操作を持つコンポーネントは、ユーザーが操作したときに方向を読み取ります。RTL では、Arrow Left キーと Arrow Right キーが読み順の方向に従います。

一部のコンポーネントは、方向に部分的にしか従いません。Angular での該当コンポーネントは、既知の制限に記載されています。

はじめる前に

RTL はレイアウトを反転するもので、テキストを翻訳するものではありません。 dir 属性が変更するのは読み順の方向のみです。コンポーネントの文字列を別の言語で表示するには、ローカライゼーションを参照してください。

方向は 1 か所で設定します。 アプリケーション全体の場合は、body 要素に dir="rtl" を設定します。ページの一部のみを反転するには、ページの一部に RTL を適用するで説明しているように、代わりにコンテナーに設定します。

独自のコンテンツにも論理プロパティが必要です。 コンポーネントは自動的に反転しますが、margin-left などの物理プロパティで記述したスタイルは、配置した位置に留まります。RTL 向けに独自のコンテンツのスタイルを設定するを参照してください。

次のステップ

利用可能なツール

ツール 場所 機能
dir 属性 任意の HTML 要素 (通常は body) 要素とその内部のすべての方向を設定します。rtl、ltr、auto を受け付けます。
CSS 論理プロパティ 独自のスタイルシート padding-left の代わりに padding-inline-start を使用するなど、読み順の方向を基準にコンテンツを配置します。
:dir(rtl) 擬似クラス 独自のスタイルシート dir 属性が要素自体と祖先要素のどちらにある場合でも、方向が右から左である要素に一致します。

一般的なワークフロー

アプリケーション全体で RTL を有効にする

ホスト ページの body 要素に dir="rtl" を設定します。ページ上のすべての Ignite UI for Angular コンポーネントが右から左にレンダリングされます。

src/index.html で属性を設定します:

<!doctype html>
<html lang="ar">
  <head>
    <meta charset="utf-8" />
    <title>My App</title>
  </head>
  <body dir="rtl">
    <app-root></app-root>
  </body>
</html>

実行時に方向を切り替える

ユーザーが別の言語を選択したときなど、アプリケーションの実行中に方向を変更するには、body 要素の dir 属性を設定します。コンポーネントのスタイルはすぐに更新され、コンポーネントは次にユーザーが操作したときに新しい方向を読み取ります。

import { Component, DOCUMENT, inject } from '@angular/core';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html'
})
export class AppComponent {
    private readonly document = inject(DOCUMENT);

    public setDirection(dir: 'ltr' | 'rtl') {
        this.document.body.dir = dir;
    }
}

ページの一部に RTL を適用する

アラビア語やヘブライ語のコンテンツを含むパネルなど、ページの一部のみを反転するには、その部分を含む要素に dir="rtl" を設定し、body は左から右のままにします。要素内のコンポーネントは、その要素の方向に従います。

次のサンプルでは、dir="rtl" を設定したコンテナーに Calendar を配置しています。Change Directionality を選択すると、コンテナーの方向が右から左と左から右の間で切り替わります。

方向を示す Icon を反転する

アイコンは自動的には反転せず、Angular Icon にはアイコンを反転するオプションがありません。右から左のレイアウトで方向を示すアイコンには、arrow_forward の代わりに arrow_back など、読み順の方向を指すアイコンを使用します。

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 Angular では、次のコンポーネントは方向に部分的にしか従いません。

コンポーネント 方向に従わない部分
Grid、Tree Grid、Hierarchical Grid、Pivot Grid レイアウトと水平スクロールは方向に従いますが、キーボード ナビゲーションは従いません。Arrow Left はフォーカスを前の列に、Arrow Right は次の列に移動するため、RTL では Arrow Left でフォーカスが右に移動します。
Calendar (Date Picker と Date Range Picker のカレンダーを含む) どちらの方向でも、Arrow Left は前日に、Arrow Right は翌日に移動します。
Tree どちらの方向でも、Arrow Left はノードを折りたたむか親ノードに移動し、Arrow Right はノードを展開します。
Icon アイコンを反転するオプションがありません。方向を示す Icon を反転するを参照してください。

コンポーネントがこのページの説明どおりに方向に従わない場合は、Ignite UI for Angular の Issue トラッカーで報告してください。

トラブルシューティング

$direction: rtl のコンパイルが失敗するのはなぜですか?

core() ミックスイン (バージョン 13.1.0 より前は igx-core()) には、$direction パラメーターがなくなりました。通常のテーマが両方の方向をサポートするため、バージョン 13.2.0 でこのパラメーターは RTL 専用の *-rtl.css テーマ ファイルとともに削除されました。@include igx-core($direction: rtl) または @include core($direction: rtl) を @include core() に置き換え、通常のテーマ ファイルを使用し、アプリケーション全体で RTL を有効にするで説明しているように dir 属性を設定してください。ng update を実行して 13.2.0 以降に更新すると、これら 2 つの変更が Sass に自動的に適用されます。

実行時の方向の変更にコンポーネントが従わないのはなぜですか?

21.2.0 より前のバージョンでは、アプリケーションの起動時に body 要素または html 要素から方向を 1 回だけ読み取ります。これらのバージョンでは、アプリケーションがブートストラップされる前に dir 属性を設定するか、21.2.0 以降に更新してください。21.2.0 以降では、ユーザーが操作するたびにコンポーネントが方向を読み取ります。

RTL で独自のコンテンツが左側に残るのはなぜですか?

margin-left や float: left などの物理プロパティを使用するスタイルは反転しません。RTL 向けに独自のコンテンツのスタイルを設定するで示しているように、margin-inline-start や float: inline-start などの論理プロパティに置き換えてください。

その他のリソース

FAQ

Ignite UI for Angular で RTL を有効にするにはどうすればよいですか?

ホスト ページの body 要素に dir="rtl" を設定します。Ignite UI for Angular コンポーネントは dir 属性から方向を取得するため、コンポーネントの設定や追加のパッケージは必要ありません。ページの一部のみを反転するには、代わりにコンテナー要素に属性を設定します。

Ignite UI for Angular で RTL を使用するには別のテーマが必要ですか?

いいえ。Ignite UI for Angular のテーマは両方の方向をサポートしており、左から右のページと右から左のページの両方に同じテーマ CSS を使用できます。RTL 専用の *-rtl.css テーマ ファイルは、バージョン 13.2.0 で削除されました。

ページを再読み込みせずに LTR と RTL を切り替えることはできますか?

はい。body 要素、またはコンポーネントを含むコンテナーの dir 属性を変更します。Ignite UI for Angular コンポーネントのスタイルはすぐに更新され、コンポーネントは次にユーザーが操作したときに新しい方向を読み取ります。

Ignite UI for Angular のグリッドは RTL をサポートしていますか?

一部サポートしています。Grid、Tree Grid、Hierarchical Grid、Pivot Grid は、ページの方向に合わせて列を配置し、水平方向にスクロールしますが、矢印キーによるナビゲーションは反転しません。RTL では、Arrow Left でフォーカスが前の列 (右側にある列) に移動します。

RTL によって Ignite UI for Angular コンポーネントのテキストは翻訳されますか?

いいえ。dir 属性が変更するのは、読み順の方向とレイアウトのみです。組み込みのコンポーネント文字列の翻訳は、別のローカライゼーション手順です。