アクセシビリティ (A11y) の閾値を変更する
アクセシビリティの問題に対する組織の取り扱い方をカスタマイズし、優先順位を設定します
A11yは単語「accessibility」の数字を使った省略形（ナンバーニム）であり、「11」は初めの「a」と終わりの「y」の間にある文字数を表しています。 accessibilityについてさらに学びたい方は続きをご覧ください。 a11y閾値 とその計算に使用するAxe Developer Hubの基準について詳しく説明します。
A11yの閾値とは？
A11yの閾値は、組織が許容するアクセシビリティのエラーに対する許容度を反映したものであり、次の2つの基準から算出される数値です。
- 計算が すべての アクセシビリティ問題を考慮するか、それとも最新のテスト実行で発見された 新たな 問題のみを考慮するかです。（新たな問題の検出はWebプロジェクトにのみ対応しています。モバイル対応は近日公開予定です！）
- どのレベルの 影響度 （重大、深刻、普通、軽微）が閾値の計算に含まれるかを決定します。
a11yの基準を変更すると、その変更は 今後の 計算にのみ影響し、古いa11yの閾値は再計算されません。アイコンが計算の横に表示され、設定が変更されたことを示し、カーソルをアイコンに合わせると、閾値が変更されたことを思い出させるポップアップが表示されます。
a11yの閾値を使用すると、組織に重要な要素に従ってAxe Developer Hubをカスタマイズできます。新たな問題が主な関心事ですか、それともすべての問題を追跡したいですか？どの影響度レベルを優先すべきですか？
例えば、現在の組織の焦点が重大な問題の緩和にのみある場合もあれば、 重要な 問題と深刻な問題の両方を改善することを目指している場合もあります。組織がアクセシビリティ問題への取り組みを始めたばかりの場合、優先される影響度レベルを制限して圧倒されないようにする必要があるかもしれません。後に、組織のアクセシビリティ問題の緩和に関する知識が向上するにつれ、a11yの閾値を変更して影響の少ないアクセシビリティ問題も対象に含めることができます。
a11yの閾値はどのように使用されるのか？
a11yの閾値は、プロジェクトのアクセシビリティの品質を即座に把握するための指標であり、Axe Developer Hubで問題を特定する際に目立って表示されます。ゼロを超える値は許容されるアクセシビリティの閾値を超えていることを示し、対処が必要な問題を示します。時間が経つにつれ、コミットごとやリリースごとにアクセシビリティの閾値を追跡し、プロジェクトのアクセシビリティの健康状態の全体像を把握することができます。
下の例では、各パネルの左側に計算されたa11y閾値が表示されているのがわかります。ここでは、値が 2 となっており、現在の閾値を超える2つの問題があることを示しています。
a11yの閾値の値 2 をクリックすると、該当する影響レベルの問題がフィルタに追加され、a11yの閾値を超えた問題のみを詳しく調べられます。（この場合、 2 をクリックすると、すべての問題がフィルタに追加されます。なぜなら、すべてがa11yの設定で設定されていたからです。）
a11yの閾値を設定する
管理者のみがa11yの閾値の基準を変更できます。そうすることで、エンタープライズの全ユーザーに影響を与えます。
あなたの Axeアカウントページ でページ上部のCONFIGURATIONタブをクリックします。設定ページで Axe Developer Hub ページの左側のリストから、a11yしきい値設定を表示および編集します。
a11yしきい値の設定を変更した後、SAVEをクリックします。
含まれる問題
「 含まれる問題 」の値は、選択された影響に合致するすべてのアクセシビリティ問題をしきい値計算に含めるか、新しいアクセシビリティ問題のみを含めるかを示します。 新規 のアクセシビリティ問題とは、現在のスキャンで検出された、比較対象のスキャンで見つからなかった問題のことです。それが前回のテスト実行、前回のコミット、またはデフォルトブランチでの最新のスキャンであるかにかかわらずです。 すべての問題を含めるように設定された場合、a11yしきい値の表示値はすべてのページで一貫しています。新しい問題のみを見るように設定されている場合、各ページが異なるベースラインに対するスキャンを比較するため、値はページごとに異なる場合があります。
注意：新しい問題の検出はウェブプロジェクトのみで利用可能です。モバイルは近日公開予定です。
含まれる影響
「 含まれる影響 」の値は、計算に含める影響レベルを示します。 クリティカル 影響のある問題は、無効化することはできません。これらの問題は、障害者がウェブページやモバイルアプリの機能にアクセスしたり操作したりすることを完全に妨げます。 すべての影響レベルについて詳しくはこちら。
GitHubアクションでのA11yしきい値の使用
Axe Developer Hub GitHubアクション をウェブプロジェクトで使用する場合、a11yしきい値は、アクセシビリティ問題を含むプルリクエストをブロックする門番として機能します。アクションはプルリクエストに問題を示すコメントを追加します：
上記の例では、プルリクエストコメントは、失敗した問題のリストを表示するためのAxe Developer Hubウェブサイトのページへのリンクを含んでいます。GitHubアクションのデフォルトの動作を変更して、プルリクエストのマージを妨げるのではなく、ユーザーにアクセシビリティ問題を警告するみにすることができます。
仕組み
GitHubアクションは、Axe Developer Hubサーバー（そのRESTエンドポイントを介して）にプルリクエストに関連する最新のコミットを問い合わせます。ウェブサービスは、a11yしきい値設定によって決定されたアクセシビリティ問題の数を返します。ゼロを超えるアクセシビリティエラーはすべて失敗と見なされ、プルリクエストにコメントを追加し、マージを妨げる可能性があります。
詳細は GitHubアクションの使用 を参照してください。