アクセシビリティ (A11y) 阈値の変更
アクセシビリティの問題に対する組織の対応をカスタマイズして優先順位を決定する
A11y は「アクセシビリティ」という単語の数字ベースの省略形（またはニューロニム）で、11（11）はアクセシビリティの始まりのaと終わりのyの間の文字数を表しています。a11y 阈値とその計算に使われる基準について詳しく知るために読み続けてください。
A11y 阈値とは何ですか？
a11y 阈値はアクセシビリティエラーに関する組織の許容度を反映し、次の2つの基準から計算される数値です：
- 計算にAxe Developer Hubがテスト実行中に見つけたすべてつのアクセシビリティ問題を含めるのか、それとも直近のテスト実行でのみ発見された新規つの問題を含めるのか。（新規問題の検出は、ウェブプロジェクトにのみ対応。モバイル対応は近日中！）
- どの影響レベル（重大、深刻、適度、軽微）を阈値計算に含めるか。
a11y 阈値の基準を変更した場合、その変更は今後の計算にのみ影響します。古いa11y 阈値は再計算されません。設定が変更されたことを示すアイコンが計算の横に表示され、それにカーソルを合わせると、阈値が変更されたことを示すリマインダーが表示されます：
a11y 阈値を使用して、組織にとって重要なポイントにAxe Developer Hubをカスタマイズできます。新しい問題が主な関心事ですか、それともすべての問題を追跡したいですか？どの影響レベルを優先すべきですか？
たとえば、組織の現在の焦点は重大な問題を軽減することに両方限定するか、重大で深刻な問題を改善することを目的とするかもしれません。アクセシビリティ問題の取り組みを始めたばかりの組織では、優先させる影響レベルを制限する必要があるかもしれません。後に、アクセシビリティ問題の軽減に関する知識が向上した際、a11y 阈値を変更して、影響が小さいアクセシビリティ問題を含めることができます。
A11y 阈値の使用方法
a11y 阈値は、プロジェクトのアクセシビリティの質を迅速に把握するための指標を提供し、Axe Developer Hubで問題を特定するための詳細な分析を行うときに目立つ形で表示されます。値がゼロを超えると、許可されるアクセシビリティの阈値を超えていることになり、対応が必要な問題があることを示します。時が経つにつれて、コミットごと、リリースごとにアクセシビリティの阈値を追跡し、プロジェクトのアクセシビリティ状態を把握することができます。
以下の例では、各パネルの左のセクションに計算されたa11y 阈値が表示されています。ここでは、2の値が現在の阈値を超える2つの問題を示しています：
a11y 阈値の値（ここでは2）をクリックすると、影響レベルに対応する問題がフィルタに追加され、a11y 阈値を超えた問題のみを詳細に調査できるようになります。（この場合、2をクリックすると、a11y 設定ですべてが設定されているので、すべての問題がフィルタに追加されます。）
A11y 阈値の設定
a11y 阈値の基準を変更できるのは管理者のみです。変更すると、企業のすべてのユーザーに対して適用されます。
「マイ Axeアカウントページ」でページ上部の「設定」タブをクリックします。「設定」ページで、ページ左側のリストからAxe Developer Hubを選択してa11yしきい値の設定を表示および編集します。
a11y 阈値の設定を変更した後、保存をクリックします。
含まれる問題
含まれる問題の値は、すべての影響に達したアクセシビリティ問題を阈値計算に含めるか、新しいアクセシビリティ問題のみを含めるかを示します。新規のアクセシビリティ問題は、以前のテスト実行、コミット、またはデフォルトブランチでの最新スキャンと比較して見つかった現在のスキャンで検出された問題です。 すべての問題を含めるように設定された場合、a11y 阈値に表示される値はすべてのページで一貫しています。新しい問題のみを確認するように設定された場合、各ページは異なる基準値とスキャンを比較するため、値はページごとに異なる場合があります。
注意: 新規問題の検出は、ウェブプロジェクトにのみ対応。モバイル対応は近日中。
含まれる影響
含まれる影響の値は、計算に含める影響レベルを示します。重大影響の問題は、ユーザーがウェブページまたはモバイルアプリ上の機能にアクセスしたり、操作したりすることを完全に妨げるため、選択を外すことはできません。すべての影響レベルについてさらに学ぶ。
GitHub Action と A11y 阈値の利用
ウェブプロジェクトでのAxe Developer Hub GitHub Action使用時、a11y 阈値はアクセシビリティの問題を含むプルリクエストをブロックするゲートキーパーとして機能します。このアクションは問題を示すコメントをプルリクエストに追加します：
上記の例では、プルリクエストコメントには、Axe Developer Hubのウェブサイト上のページへのリンクが含まれており、失敗した問題の一覧を確認できます。GitHubアクションのデフォルトの動作を変更して、アクセシビリティの問題をユーザーに警告するだけにし、プルリクエストのマージを阻止しないように設定することができます。
仕組み
GitHubアクションは、プルリクエストに関連付けられた最新のコミットを取得するために、Axe Developer Hubサーバーに（そのRESTエンドポイントを通じて）クエリを送信します。ウェブサービスは、a11yしきい値設定によって決定されたアクセシビリティ問題の数を返します。アクセシビリティエラーがゼロを超えると失敗と見なされ、プルリクエストにコメントが追加され、マージを阻止する可能性があります。
詳細についてはGitHubアクションの使用をご覧ください。