Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
Vega StudioのA11y Inspectorは、編集中にアプリの.tsxファイルと.jsxファイルにアクセシビリティの問題がないかをチェックします。VoiceViewスクリーンリーダーなどの支援技術で正しく説明または操作できないコンポーネントを検出し、ほとんどの問題をワンクリックで修正できる機能を提供します。A11y Inspectorはデフォルトで有効になっており、無効にすることはできません。 A11y Inspectorは、Vega ESLintプラグインと同じアクセシビリティルールを使用します。インスペクターを使用して、コード作成中の問題を検出します。ESLintプラグインを使用して、コマンドラインまたはビルドパイプラインからアプリをチェックします。

前提条件

アクセシビリティの問題を検出する

A11y Inspectorは、開いた各.tsxファイルと.jsxファイルを分析し、エディターで問題箇所に波線の下線を表示します。下線の色は重大度を示しています。
  • **ブロッカー **(赤)- 支援技術ではこの要素を使用できません。最初にこれらを修正してください。
  • **クリティカル ** (黄色)- エレメントは廃止されたアクセシビリティプロップを使用しています。
  • **メジャー **(青)- 要素には、ユーザーが理解したり操作したりするのに役立つ情報が欠けています。
フラグが付けられた各要素の上に、CodeLensの注釈で問題の数と重大度が表示されます(例:A11y: 2 broken · 1 bad)。注釈には、[修正]、[プレビュー]、および [説明] ボタンが含まれます。

ワークスペース全体をスキャン

インスペクターは、ファイルを開くときにファイルをチェックします。ワークスペース内のすべての.tsxファイルと.jsxファイルを一度にチェックするには:
  1. コマンドパレットを開きます。
  2. [A11y Inspector: Run Lint] を実行します。
結果はVega Studioサイドバーのアクセシビリティビューに表示されます。

サイドバーで課題を表示する

アクセシビリティビューには、ワークスペースのすべてのアクセシビリティ問題が一覧表示されます。開くには、** A11y インスペクターを実行します。 **コマンドパレットからサイドバーを表示します。 課題の整理方法を変更するには、ビューのタイトルバーで [Group by Severity] または [Group by File] を選択します。
  • 重大度別にグループ化 - ブロッカー、クリティカル、メジャーの問題をまとめて一覧表示します。
  • ファイル別にグループ化 - 問題が含まれるファイルごとに問題を一覧表示します。
Vega Studioサイドバーのアクセシビリティビュー。重大度別にグループ分けされています。ブロッカーグループが拡大され、無効なロール値、スイッチエレメントの状態が欠落している、AccessibilityDescribedByの参照が壊れているなどの5つの問題がリストされています。 問題を選択すると、エディターでその問題に移動します。

問題を理解する

問題の概要を表示するには、下線付きの要素にカーソルを合わせます。ツールチップには、ルール名、診断メッセージ、重要度、およびドキュメントへのリンクが表示されます。 詳細については、CodeLens アノテーションの説明を選択してください。説明パネルには以下が表示されます。
  • ルール名と重要度
  • 診断メッセージ
  • 問題の解決方法に関するガイダンス
  • 導入前と導入後のコード例
  • ルールの抑制構文
  • 関連ドキュメントへのリンク
「ブロッカー」とマークされた、missing-accessible-labelルールの説明パネル。診断メッセージ、aria-labelを追加する変更前後のコード例を含む修正方法ガイダンス、eslint-disable-next-lineコメントを使用した抑制方法の例、およびアクセシビリティドキュメントへのリンクが表示されます。

問題を修正

一度に1つの問題を修正することも、ワークスペース内の修正可能なすべての問題を一度に修正することもできます。

1つの問題を修正する

  1. 問題の横にある電球アイコンを選択するか、CodeLens アノテーションの [修正] を選択します。
  2. 適用する修正を選択します。 インスペクターが修正を適用すると、波状の下線が要素から消えます。
クイックフィックスでは次のことが可能になります。
  • 欠落しているaria-labelを追加します。
  • 欠落しているroleを追加します。
  • 欠落しているaria-checkedまたはaria-selected状態を追加します。
  • 欠落しているaccessibilityHintを追加します。
  • 非推奨のプロップの名前を変更します(例:accessibilityLabelをaria-labelに、またはaccessibilityRoleをroleに)。
  • 無効なロール値を置き換えます(例:headerをheadingに、またはimageをimgに)。

適用前に修正をプレビューする

  1. CodeLensアノテーションで [プレビュー] を選択します。 インスペクターには、提案された変更が緑色で強調表示されています。 エディターで修正をプレビューしているA11y Inspector。TouchableOpacity要素には下線が引かれ、aria-label="TODO"を追加した変更案が緑色でインラインで表示されます。上のCodeLensバーには、[修正を承認]、[元に戻す]、[修正]、[プレビュー]、および [説明] が表示されます。
  2. [修正を適用] を選択して修正を適用するか、[元に戻す] を選択して修正を破棄します。

ワークスペースの問題をすべて解決

  1. コマンドパレットを開きます。
  2. [A11y Inspector: Fix All] を実行します。 [アクセシビリティ] ビューのタイトルバーで [すべて修正] を選択することもできます。
インスペクターは、利用可能なすべてのクイックフィックスをワークスペース全体に適用します。クイックフィックスがない問題は問題ビューに表示され、手動で修正できます。 [アクセシビリティ] ビューに問題が表示されない場合、ワークスペースはすべてのA11yインスペクタールールに合格します。 コミットする前に変更を確認してください。

問題を抑止する

問題が要素に当てはまらない場合は、その要素を抑制できます。抑制コメントを追加するには、電球メニューから抑制アクションを選択するか、自分でコメントを追加します。 たとえば、装飾画像のラベル欠落ルールを抑制するには:
インスペクターはESLint抑制コメントも認識します。ESLintコメントを使用すると、インスペクターとVega ESLintプラグインの両方で問題が発生しないようにできます。
ルール名のないeslint-disable-next-lineコメントは、次の行のすべてのルールを抑制します。

アクセシビリティ規則

Vega ESLintプラグインでは、ブロッカールールはデフォルトでerrorであり、クリティカルルールとメジャールールはデフォルトでwarnです。

関連トピック


最終更新日 2026年10月19日