.tsxファイルと.jsxファイルにアクセシビリティの問題がないかをチェックします。VoiceViewスクリーンリーダーなどの支援技術で正しく説明または操作できないコンポーネントを検出し、ほとんどの問題をワンクリックで修正できる機能を提供します。A11y Inspectorはデフォルトで有効になっており、無効にすることはできません。
A11y Inspectorは、Vega ESLintプラグインと同じアクセシビリティルールを使用します。インスペクターを使用して、コード作成中の問題を検出します。ESLintプラグインを使用して、コマンドラインまたはビルドパイプラインからアプリをチェックします。
前提条件
- Vega Studioバージョン0.24.2以降。インストール手順については、Vega Studioのセットアップを参照してください。
アクセシビリティの問題を検出する
A11y Inspectorは、開いた各.tsxファイルと.jsxファイルを分析し、エディターで問題箇所に波線の下線を表示します。下線の色は重大度を示しています。
- **ブロッカー **(赤)- 支援技術ではこの要素を使用できません。最初にこれらを修正してください。
- **クリティカル ** (黄色)- エレメントは廃止されたアクセシビリティプロップを使用しています。
- **メジャー **(青)- 要素には、ユーザーが理解したり操作したりするのに役立つ情報が欠けています。
A11y: 2 broken · 1 bad)。注釈には、[修正]、[プレビュー]、および [説明] ボタンが含まれます。
ワークスペース全体をスキャン
インスペクターは、ファイルを開くときにファイルをチェックします。ワークスペース内のすべての.tsxファイルと.jsxファイルを一度にチェックするには:
- コマンドパレットを開きます。
- [A11y Inspector: Run Lint] を実行します。
サイドバーで課題を表示する
アクセシビリティビューには、ワークスペースのすべてのアクセシビリティ問題が一覧表示されます。開くには、** A11y インスペクターを実行します。 **コマンドパレットからサイドバーを表示します。 課題の整理方法を変更するには、ビューのタイトルバーで [Group by Severity] または [Group by File] を選択します。- 重大度別にグループ化 - ブロッカー、クリティカル、メジャーの問題をまとめて一覧表示します。
- ファイル別にグループ化 - 問題が含まれるファイルごとに問題を一覧表示します。
問題を選択すると、エディターでその問題に移動します。
問題を理解する
問題の概要を表示するには、下線付きの要素にカーソルを合わせます。ツールチップには、ルール名、診断メッセージ、重要度、およびドキュメントへのリンクが表示されます。 詳細については、CodeLens アノテーションの説明を選択してください。説明パネルには以下が表示されます。- ルール名と重要度
- 診断メッセージ
- 問題の解決方法に関するガイダンス
- 導入前と導入後のコード例
- ルールの抑制構文
- 関連ドキュメントへのリンク
問題を修正
一度に1つの問題を修正することも、ワークスペース内の修正可能なすべての問題を一度に修正することもできます。1つの問題を修正する
- 問題の横にある電球アイコンを選択するか、CodeLens アノテーションの [修正] を選択します。
- 適用する修正を選択します。 インスペクターが修正を適用すると、波状の下線が要素から消えます。
- 欠落している
aria-labelを追加します。 - 欠落している
roleを追加します。 - 欠落している
aria-checkedまたはaria-selected状態を追加します。 - 欠落している
accessibilityHintを追加します。 - 非推奨のプロップの名前を変更します(例:
accessibilityLabelをaria-labelに、またはaccessibilityRoleをroleに)。 - 無効なロール値を置き換えます(例:
headerをheadingに、またはimageをimgに)。
適用前に修正をプレビューする
-
CodeLensアノテーションで [プレビュー] を選択します。
インスペクターには、提案された変更が緑色で強調表示されています。
- [修正を適用] を選択して修正を適用するか、[元に戻す] を選択して修正を破棄します。
ワークスペースの問題をすべて解決
- コマンドパレットを開きます。
- [A11y Inspector: Fix All] を実行します。 [アクセシビリティ] ビューのタイトルバーで [すべて修正] を選択することもできます。
問題を抑止する
問題が要素に当てはまらない場合は、その要素を抑制できます。抑制コメントを追加するには、電球メニューから抑制アクションを選択するか、自分でコメントを追加します。
たとえば、装飾画像のラベル欠落ルールを抑制するには:
eslint-disable-next-lineコメントは、次の行のすべてのルールを抑制します。
アクセシビリティ規則
Vega ESLintプラグインでは、ブロッカールールはデフォルトで
errorであり、クリティカルルールとメジャールールはデフォルトでwarnです。
関連トピック
- Vega ESLintプラグインのインストールと構成
- Vega開発者向けアクセシビリティリソース
- アクセシビリティプロパティ(React Native 0.83)
- アクセシビリティプロパティ(React Native 0.72)
- Vega Studioのコマンド

