アクセシビリティ準拠
このページには、Ignite UI for React が対象とするアクセシビリティ標準、各コンポーネントのドキュメントが現在カバーしている内容、およびアクセシビリティの問題を報告する方法を記載しています。
アクセシビリティ サポートは、コンポーネント自体と、それらをスタイル設定するテーマ設定エンジンの 2 つのレイヤーによって提供されます。特定のコンポーネントの対応状況を確認するにはこのページを、コントラスト、テキストのスケーリング、チャートの色の動作についてはテーマ設定のアクセシビリティを使用してください。
このページの範囲。 以下の情報は、デフォルト テーマと、各コンポーネントの現在ドキュメント化されている動作を反映しています。これはサポートの概要であり、正式な適合宣言ではありません。カスタム テーマ、タイポグラフィの変更、アニメーションや色のオーバーライドによって結果が変わる可能性があります。
対象とする標準
| 標準 | 地域 | 要求事項 |
|---|---|---|
| WCAG 2.1 Level AA | 国際 | 以下に示す達成基準。他の 2 つの標準が参照する基準となるものです。 |
| 第 508 条 (改訂版) | 米国 | 連邦政府の調達。改訂版第 508 条標準 (2017 年公開、2018 年 1 月適用開始) 以降は WCAG 2.0 Level AA を参照により組み込んでいるため、同じ対応で満たされます。 |
| EN 301 549 | 欧州 | ICT のアクセシビリティについて参照される、WCAG を基盤とした欧州標準。これを基盤とする欧州アクセシビリティ法は、2025 年 6 月 28 日から適用されます。 |
第 508 条には、以前は §1194.22 に基づく独自の 16 の規則が定義されていました。これらは、WCAG を直接採用する改訂版標準に置き換えられました。したがって、WCAG 2.1 Level AA を対象とすることで、上記の 3 つのフレームワークすべてに対応できます。
UI コンポーネントに適用される達成基準
WCAG への適合は、より広範なガイドラインに対してではなく、個々の達成基準に対して主張されます。UI コンポーネント ライブラリが影響を与えることができる基準は次のとおりです:
| 基準 | レベル | コンポーネントにとっての意味 |
|---|---|---|
| 1.1.1 非テキスト コンテンツ | A | アイコンと画像にテキストによる代替を提供します。 |
| 1.3.1 情報及び関係性 | A | 視覚的に伝えられる構造がマークアップでも伝えられます。 |
| 1.3.2 意味のある順序 | A | 読み上げ順序が視覚的な順序と一致します。 |
| 1.4.3 コントラスト (最低限) | AA | テキストと背景のコントラスト比が 4.5:1 を満たします。 |
| 1.4.4 テキストのサイズ変更 | AA | コンテンツを失うことなくテキストを 200% まで拡大できます。 |
| 1.4.11 非テキストのコントラスト | AA | コントロールの境界と状態のコントラスト比が 3:1 を満たします。 |
| 1.4.13 ホバー又はフォーカスで表示されるコンテンツ | AA | ツールチップとポップオーバーは閉じることができ、表示が維持されます。 |
| 2.1.1 キーボード | A | すべての機能にキーボードで到達できます。 |
| 2.1.2 キーボード トラップなし | A | フォーカスを常に外に戻すことができます。 |
| 2.4.3 フォーカス順序 | A | タブ順序が意味のある順序に従います。 |
| 2.4.7 フォーカスの可視化 | AA | フォーカスされたコントロールが視覚的に示されます。 |
| 2.5.3 ラベルを含む名前 | A | アクセシブル名に表示ラベルが含まれます。 |
| 3.2.1 フォーカス時 | A | フォーカスだけではコンテキストの変化が発生しません。 |
| 3.2.2 入力時 | A | 値の変更だけではコンテキストの変化が発生しません。 |
| 3.3.2 ラベル又は説明 | A | 入力にラベルまたは説明が付いています。 |
| 4.1.2 名前、役割、値 | A | すべてのコントロールが名前、役割、および現在の状態を公開します。 |
アクセシビリティの提供方法
| レイヤー | 担当する範囲 | ドキュメントの場所 |
|---|---|---|
コンポーネント ライブラリ (Angular では igniteui-angular) |
キーボード操作、フォーカスの移動、ARIA のロールと状態、スクリーン リーダーの読み上げ。 | 以下の索引、および各コンポーネントのトピック。 |
テーマ設定エンジン (igniteui-theming) |
カラー コントラスト、テキスト サイズ、チャートのカラー パレット、カスタム コントロール向けのスタイル設定ユーティリティ。 | テーマ設定のアクセシビリティ |
コンポーネントのサポート状況
この索引には、各コンポーネントのドキュメントが現在カバーしている内容を記録しています。未ドキュメント化は、そのコンポーネント自身のドキュメントにこの動作の説明がないことを意味します。これはドキュメントについての記述であり、コンポーネントについての記述ではありません。
| ステータス | 意味 |
|---|---|
| ドキュメント化済み | 動作は、行内でリンクされているコンポーネント自身のドキュメントで説明されています。 |
| 構成が必要 | 必要な構成に記載されている設定を適用すると利用できます。 |
| 未ドキュメント化 | コンポーネントのドキュメントでは、この動作はまだ説明されていません。 |
| コンポーネント | キーボード操作 | スクリーン リーダー / ARIA | リファレンス |
|---|---|---|---|
| Grid | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Hierarchical Grid | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Tree Grid | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Tree | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| List | 未ドキュメント化 | 未ドキュメント化 | — |
| Avatar | ドキュメント化済み | ドキュメント化済み | アクセシビリティ |
| Badge | ドキュメント化済み | ドキュメント化済み | アクセシビリティ |
| Banner | 未ドキュメント化 | 未ドキュメント化 | — |
| Button | 未ドキュメント化 | 未ドキュメント化 | — |
| Button Group | 未ドキュメント化 | 未ドキュメント化 | — |
| Calendar | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Card | 未ドキュメント化 | 未ドキュメント化 | — |
| Carousel | ドキュメント化済み | ドキュメント化済み | アクセシビリティ |
| Checkbox | 未ドキュメント化 | 未ドキュメント化 | — |
| Chip | 未ドキュメント化 | 未ドキュメント化 | — |
| Circular Progress | 未ドキュメント化 | 未ドキュメント化 | — |
| Combo | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Date Time Input | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Date Picker | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Dialog | 未ドキュメント化 | 未ドキュメント化 | — |
| Divider | 未ドキュメント化 | 未ドキュメント化 | — |
| Dock Manager | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Dropdown | 未ドキュメント化 | 未ドキュメント化 | — |
| Expansion Panel | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Icon | 未ドキュメント化 | 未ドキュメント化 | — |
| Icon Button | 未ドキュメント化 | 未ドキュメント化 | — |
| Input | 未ドキュメント化 | 未ドキュメント化 | — |
| Linear Progress | 未ドキュメント化 | 未ドキュメント化 | — |
| Navbar | 未ドキュメント化 | 未ドキュメント化 | — |
| Navigation Drawer | 未ドキュメント化 | 未ドキュメント化 | — |
| Radio | 未ドキュメント化 | 未ドキュメント化 | — |
| Rating | 未ドキュメント化 | 未ドキュメント化 | — |
| Select | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Slider | 未ドキュメント化 | 未ドキュメント化 | — |
| Snackbar | 未ドキュメント化 | 未ドキュメント化 | — |
| Stepper | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Switch | 未ドキュメント化 | 未ドキュメント化 | — |
| Tabs | ドキュメント化済み | 未ドキュメント化 | キーボード ナビゲーション |
| Text Area | 未ドキュメント化 | 未ドキュメント化 | — |
| Toast | 未ドキュメント化 | 未ドキュメント化 | — |
| Tooltip | ドキュメント化済み | ドキュメント化済み | アクセシビリティ |
未ドキュメント化とマークされている行は、このドキュメントのギャップであり、既知の欠陥ではありません。次のレビュー サイクルより前に特定のコンポーネントの適合に関する回答が必要な場合は、Issue を作成してお問い合わせください。
必要な構成
アクセシビリティの結果の一部は、コンポーネント単体ではなく、アプリケーションの構成方法に依存します。
| 懸念事項 | 基準 | 構成する内容 |
|---|---|---|
| アニメーションと動き | 2.3.1 3 回の閃光、又は閾値以下 | 構成は必要ありません。アニメーション プレーヤーはオペレーティング システムの prefers-reduced-motion: reduce 設定を読み取り、設定されている場合はアニメーションを継続時間 0 で再生します。 |
残りの項目は、すべてのプラットフォームに適用されます。
| 懸念事項 | 基準 | 構成する内容 |
|---|---|---|
| 一時的なメッセージの時間制限 | 2.2.1 タイミング調整可能 | Snackbar や Toast など、自動的に閉じるコンポーネントは表示時間の設定を公開しています。ユーザーがメッセージを読む時間を確保できるように、表示時間を延長するか、自動的に閉じる動作を無効にしてください。 |
| テーマ設定後のカラー コントラスト | 1.4.3 コントラスト (最低限) | 前景色は固定値ではなく、contrast-color() または adaptive-contrast() で設定してください。テーマ設定のアクセシビリティを参照してください。 |
| アイコンのみのコントロールのアクセシブル名 | 4.1.2 名前、役割、値 | 独自のマークアップでアクセシブル名を指定してください。アイコンのみを表示するコントロールには、名前を付けるまで名前がありません。 |
正式な適合ドキュメント
このページはドキュメントの索引であり、適合の主張ではありません。弊社のドキュメントがカバーしている内容を記録したものであり、いずれかの標準に対してコンポーネントを認証するものではありません。
調達、契約、または監査の目的で、追跡可能な基準ごとの適合宣言が必要な場合は、アカウント マネージャーまたはインフラジスティックスのサポートを通じて、最新のアクセシビリティ適合レポート (VPAT) をリクエストしてください。製品、バージョン、およびレポートが対象とすべき標準 (WCAG 2.1 Level AA、第 508 条、または EN 301 549) を明記してください。
このページの以前の版には、コンポーネントごとの適合マトリックスが掲載されていました。それらの表は、追跡可能な基準ごとの評価に裏付けられていない適合レベルを主張していたため、書き直すのではなく削除されました。適合レポートがその情報の正式な情報源です。
アクセシビリティの問題の報告
コンポーネントにアクセシビリティの問題を見つけた場合は、Ignite UI for React の Issue トラッカーで報告してください。
コンポーネント、使用した支援技術とブラウザー、期待される動作、および影響を受けると思われる WCAG の達成基準を含めてください。アクセシビリティに関する報告は、上記の基準に照らしてトリアージされます。
その他のリソース
- テーマ設定のアクセシビリティ — コントラスト、テキストのスケーリング、およびチャート パレット。
- WCAG 2.1 クイック リファレンス — すべての達成基準と達成方法。
- WAI-ARIA オーサリング プラクティス — インタラクション パターンごとに期待されるキーボードおよび ARIA の動作。
- 第 508 条 — 米国連邦政府の調達要件。
- 正式な適合ドキュメント — 調達用の適合レポート (VPAT) のリクエスト方法。
FAQ
適合は、コンポーネント ライブラリ単体ではなく、完成したアプリケーションの特性です。Ignite UI for React は WCAG 2.1 Level AA を対象とし、コンポーネントごとの動作を上記の索引にドキュメント化していますが、結果を決定するのは、ユーザーが追加するマークアップ、コンテンツ、および構成です。上記の索引を使用して依存しているコンポーネントを確認し、ドキュメントどおりに動作しないものがあれば報告してください。
このステータスは、コンポーネント自身のドキュメントでその動作がまだ説明されていないことを意味します。コンポーネントが基準を満たしていないという記述ではありません。ドキュメント化されている動作とそうでない動作を区別できるように、ドキュメントがカバーしている内容を記録したものです。
いいえ。改訂版第 508 条標準 (2017 年公開、2018 年 1 月適用開始) は以前の §1194.22 の規則を置き換え、WCAG Level AA を参照により採用しているため、WCAG を満たすことで第 508 条にも対応できます。
一部適用されます。キーボードと ARIA の動作はテーマ設定の影響を受けません。カラー コントラストは影響を受けます。色をオーバーライドすると、テキストが必要な比率を下回る可能性があります。テーマ設定のアクセシビリティで説明されているとおりに、カスタム パレットを検証してください。
上記のリファレンス列からリンクされている、コンポーネント自身のトピックで確認できます。グリッド ファミリは専用のキーボード ナビゲーション トピックを共有しています。