用語集
axe DevTools for Web が使用する用語
a11y
アクセシビリティの略。文字aに続いて11文字、そして文字yとして解釈されます。
アゴラ
アゴラはDequeの社内アーティファクトリポジトリです。Artifactoryインスタンスに基づいています。アゴラを通じて、ユーザーはaxe DevToolsのコンポーネントをダウンロードし、カスタムルールセットを管理および配布することができます。
ARIA
アクセシブル リッチ インターネット アプリケーション (ARIA) は、ワールド ワイド ウェブ コンソーシアム (W3C) によって公開されている技術仕様で、特に動的コンテンツやAjax、HTML、JavaScript、および関連する技術で開発されたユーザーインターフェイスコンポーネントのアクセシビリティを向上させる方法を定義しています。
支援技術
障がいを持つ人々の中には、ソフトウェアやウェブサイトと単独ではインタラクションできない人もいます。これらの人々は、インターネットを公平に利用するために支援技術を必要とします。非常に一般的な支援技術の一つはスクリーンリーダーです。これらのデバイスは、視覚障がいや盲目の人々のために画面上のテキストを音声で読み上げます。使用するプラットフォームに応じて、様々なスクリーンリーダーがあります。例としては、PCではNVDAやJAWS、MacではVoiceOver、AndroidではTalkBackがあります。
ベストプラクティス
Dequeのベストプラクティスは、特定の形式的手法が不足している場合や不十分な場合に、望ましいアクセシビリティ結果をもたらす、試行錯誤された手法です。公式には確立されたアクセシビリティルールセットには含まれていませんが、Dequeのベストプラクティスに従うことで、テストされたウェブページのアクセシビリティと全体的な品質が向上します。Dequeのベストプラクティスガイドラインに準拠していないからといって、自動的に失敗を意味するわけではないことに注意すべきです。さらに、アプリケーション、サイト、またはページの目標において、適切であるかを考慮するための専門的判断が必要です。時には、ベストプラクティスのアクセシビリティ手法が、特定の問題を解決するためには適用できなかったり、実用的でなかったりすることがあります。ベストプラクティスルールセットを構成するルールについては、ベストプラクティスを参照してください。
ブラウザ自動化プラットフォーム
axe Watcherにおいて、ブラウザ自動化プラットフォームはウェブサイトのテストを自動化するために使用するフレームワークです。プラットフォームにはCypress、Playwright、Puppeteer、WebdriverIO、WebDriverJSが含まれます。詳細については、
チェックポイント
a11yの専門家であるDequeのチームによって作成された、アクセシビリティ要件テストのための確立された方法で、テスト結果の一貫性と正確性を高めます。WCAG成功基準に基づいて、これらのガイドラインのより明確な分類と解釈を提供し、失敗は通常コンテンツタイプ別に分かれています。Dequeのチェックポイントは、アクセシビリティ評価中にレビュアーが一貫した正確なテスト結果を出すのを助けます。チェックポイントは、Dequeのデジタル平等への道の重要な部分であるDequeチェックポイント（およびその要件）のマスターリストの中で、最も関連性のあり、適用可能なセクションを指します。
コンポーネントテスト
CypressやPlaywright、そしてaxe Watcherを使って、個々のコンポーネント（例えばReactコンポーネント）を単独でテストすることができます。これをe2eテストと比較してください。これは、Webアプリケーション全体を実際の使用状況でテストするものです。axe Developer Hubでは、エンドツーエンドのシナリオでアクセシビリティの問題を検出することができ、Cypressでコンポーネントを単独でテストすることができます。e2eテストも参照してください。
設定の上書き
設定の上書きを使用すると、特定のテスト実行の設定をカスタマイズできます。(JavaScript/TypeScript) configurationOverrides プロパティまたは (Java) ConfigurationOverridesクラスでのテスト設定を通じて行います。これらの上書き設定は、組織のグローバル設定に準拠する必要があり、アクセシビリティ基準、ベストプラクティス、実験的ルール、axe-coreのバージョンの変更を含むことができます。
カスタムルールセット
カスタムルールセットは、axe DevToolsコンポーネントに新しいルールを追加したり、ルールの重要度/影響度を変更したり、テストからルールを削除したりするために渡されたルールデータ（ルールとチェック）を含むJSONファイルから作成されます。
重複
重複は、同じ文書オブジェクトモデル (DOM) ノードにおける同じアクセシビリティ問題が複数のページ状態で見られるものです。重複を含む問題を修正すると、すべての重複が消えます。それらはすべて同じ問題だからです。
e2eテスト
エンドツーエンド、またはe2eテストは、Webアプリケーション全体の機能をその実際の実装でテストすることを指します。axe Developer Hubでは、e2eシナリオでアクセシビリティ問題をテストでき、Cypressで個々のコンポーネントを単独でテストすることができます。コンポーネントテストも参照してください。
イベント
APIまたはCLIの使用状況を追跡するために、メトリクスライブラリはイベントを作成し、それを使用状況サービスに送信します。イベントには、ウェブページスキャン中に違反したアクセシビリティルールの数や、アクセシビリティスキャンが完了した日時などの使用情報が含まれます。
実験的ルール
実験的ルールは、新しい技術やアクセシビリティの問題の理解と認識を深めるために、まだ開発されテストされています。これらのルールはまだ開発中で、誤検出の可能性があるため、運用環境での使用には頼るべきではありません。最終的には、このルールセットのルールがアクセシビリティ標準の一部になる可能性があります。実験的ルールはデフォルトでは無効です。最新バージョンのaxe-coreでこのルールセットを構成するルールについては実験的ルールを参照してください。
フラッシュ
The フラッシュ function writes your axe Watcher test results to the Deque server and is required to make sure the results are recorded by axe Developer Hub. You need to call the flush function in your test suite.
Gitless
Gitlessとは、Gitリポジトリを使用しないテストスイートでWatcherパッケージを使用することを指します。Gitリポジトリを使用する必要はありませんが、Gitリポジトリを使用することで、アクセシビリティの欠陥を特定のコード変更に関連付け、その解決を助けることができます。
グローバル設定
グローバル設定はaxe設定の一部として、様々なオプションを一箇所で設定し、異なるDeque製品間で共有できるようにします。管理者は、特定の設定をユーザーが変更できるようにすることができます。
アイデンティティトークン
アイデンティティトークンは、DequeのAgoraアーティファクトリポジトリにアクセスするためにJFrogによって発行されるセキュリティトークンです。アイデンティティトークンは、作成時にコピーする必要があります。これがアクセスできる唯一の機会です。トークンは指定された時間間隔後に期限切れになります。通常は1年です。
影響
すべてのアクセシビリティ違反には影響レベルが割り当てられています。影響は、修正努力を優先順位付けする際に役立つ指標です。デフォルトでは、各違反タイプに対してDequeのアクセシビリティ専門家によって影響レベルが割り当てられます。これらの値はほとんどの状況に一般化されているので、ユーザーはルールセットのカスタマイズの一環としてそれらを変更する判断を使うことができます。重大またはクリティカルな影響レベルは、障害を持つユーザーが重大または克服不可能な使用バリアに直面することを意味します。これらは最も大きな法的責任を伴います。軽度および中程度の問題はそれほど深刻ではありませんが、障害を持つユーザーにとって重要な問題を表しており、ページが完全に準拠するためには対処が必要です。検出されたアクセシビリティ問題の影響を分類するために、次の4つのレベルが使用されます：
-
クリティカル: この影響レベルは、障害のあるユーザーがウェブページ上の機能にアクセスしたり対話したりすることが完全にブロックされることを意味します。解決策が実施されるまで、コンテンツは完全にアクセス不可能です。これは、組織が訴訟の脅威にさらされることを意味します。クリティカルな問題の修正は最優先事項であるべきです。
-
深刻: この影響レベルは、障害のあるユーザーがサイトと対話する際に重大な障害に直面することを意味します。これらのユーザーは、関連するコンテンツにアクセスしようとするときに大きなフラストレーションを経験します。解決策が実施されるまで、一部のコンテンツへのアクセスが難しい、または不可能になり、組織が法的行動の脅威にさらされることになります。修正は高い優先順位であるべきです。
-
中程度: この影響レベルは、障害のあるユーザーにいくつかの障害が存在することを意味しますが、それらが基本的なフローやコンテンツへのアクセスを妨げることはありません。このレベルの影響を持つ問題は、法的行動の脅威にさらされることがあります。ページが完全に準拠する前に修正を必要とし、解決すべきです。
-
軽度: 障害のあるユーザーにとって、中程度の問題よりも影響が少ない問題です。この問題は、中程度、深刻、クリティカルな問題よりも優先度が低いかもしれませんが、ページが完全に準拠するために解決が必要です。
インテリジェントガイド付きテスト (IGT)
インテリジェントガイド付きテスト (IGT) は、axe DevTools のウェブブラウザ拡張機能のインタラクティブなアクセシビリティテストコンポーネントであり、自動化テストでは検出できないアクセシビリティエラーを見つけるために設計されています。IGTは、テスト対象のウェブページに関する簡単な質問をユーザーに尋ね、このフィードバックを利用して、自動化テストでは不可能だったより多くのアクセシビリティエラーを発見します。インテリジェントガイド付きテストの詳細についてはインテリジェントガイド付きテストのドキュメントを訪問してください。
問題
ウェブページやウェブアプリケーションのコードで識別されたアクセシビリティガイドライン（WCAG 1.0、WCAG 2.0、Section 508、およびWAI-ARIAなどの標準によって定義された）の違反。
JSONアクセシビリティ結果
axe DevTools APIまたはCLIを使用してウェブサイトのアクセシビリティ問題をテストすると、結果はJSONファイルとして保存され、ドキュメントではJSONアクセシビリティ結果ファイルと呼ばれます。このファイルをaxe Reportsにアップロードすると、axe Reportsウェブサイトを通じてウェブサイトのアクセシビリティを時系列で監視できます。また、JSONアクセシビリティ結果ファイルをローカルでCLIを使用して.csv、.xmlまたは.htmlにフィルタリングや変換することもできます。詳細はCLIでのレポートをご覧ください。あるいは、APIを使用するとテスト実行中にJSONアクセシビリティ結果ファイルをレポートに変換することもできます（レポートの下で詳細をご覧ください）。
手動モード
デフォルトでは、axe Developer Hubは各ウェブページを自動的に分析し、新しいページの状態を検出した際にページを再分析します。この自動的な動作を無効にすることができます
- (JavaScript/TypeScript)
autoAnalyzeプロパティをaxe構成オブジェクトでfalseに設定します。 - (Java)
setAutoAnalyze()メソッドをfalseで呼び出します。
また、自動解析の動作を無効にすることができます
- (JavaScript/TypeScript)
stop()メソッドを呼び出します。 - (Java)
AxeWatcherController.stop()メソッドを呼び出します。
どちらの場合も、これによりWatcherが手動モードになります。手動モードでは、analyze()メソッドを呼び出したときにのみページが分析されます。
メトリクスライブラリ
DequeのAPIおよびCLIが使用情報を使用サービスに報告するために使用する内部ライブラリ。
修正されたテストスイート
変更されたテストスイートとは、新しいプロジェクトを作成した際にaxe Developer Hubが提供する指示に従って変更したテストスイートのことです。テストスイートを変更することで、既存のテストスイートに対してテストスイート自体の変更を最小限に抑えつつ、アクセシビリティテストを追加することができます。
要確認
問題は、アクセシビリティ基準の実際の違反であるかどうかを判断するために人間による検査が必要です。
ページ状態
ページ状態とは、特定の時点におけるウェブページのドキュメントオブジェクトモデル（DOM）の状態を指します。ページ状態は、ログイン画面やシングルページアプリケーション（SPA）などの動的UIを持つ複雑なウェブサイトに役立ちます。DOM状態の例としては以下が含まれます。
- 要素の可視性
- 要素の内容
- ラジオボタンやチェックボックスのチェック状態
Watcherパッケージは、DOMに変更が検出されるとウェブページを再スキャンし、毎回新しいページ状態を保存します。
プロジェクト
axe Developer Hubのプロジェクトは、アクセシビリティ結果、テスト実行情報、およびGitデータ（ブランチとコミット）を保持します。これらの情報とプロジェクトとの関連付けは、プロジェクトのプロジェクトIDによって行われます。axe Developer Hubで新しいプロジェクトを作成して名前を付けると、プロジェクトIDが生成され、それを使用してテストでプロジェクトを識別します。
レポート
レポートは、JSONアクセシビリティ結果ファイルをaxe Reportsにアップロードするか、別のアプリケーションで使用するためにローカルでレポート（.csv、.xml、または.htmlファイル）に変換することを指します。
RGAA
RGAA、またはRéférentiel Général d'Amélioration de l'Accessibilitéは、フランス政府のウェブアクセシビリティ基準です。これは主にWCAG 2.1に基づいており、ウェブコンテンツのアクセシビリティを評価するための具体的な技術基準を提供します。現在サポートされているバージョンはルールセットIDrgaav4として識別されるRGAA 4です。
ルール
ルールはアクセシビリティガイドラインの成功基準に対応しています。それらはJSONオブジェクトファイルによって定義されており、ID、説明、ヘルプメタデータに加え、1つ以上のチェックとオプションのパラメータを含みます。
セクション508
1973年のアメリカリハビリテーション法の修正条項であり、連邦機関が障害者がアクセスできるようにその電子情報技術を提供することを求めています。これは、World Wide Web Consortium（W3C）が開発したウェブコンテンツアクセシビリティガイドライン（WCAG）に基づく16の条項で構成されていますが、WCAG 1.0または2.0標準とは同一ではありません。
SHA
Gitコミットを作成すると、それを一意に識別するIDが生成されます。この一意のIDはSHAと呼ばれます（セキュアハッシュアルゴリズムの略称であり、暗号ハッシュ関数の一群です）。
使用サービス
axe DevTools for Web (APIとCLI)の使用メトリクスを記録するRESTウェブサービスです。Dequeが提供するパブリックサービスまたは自身のサービスのいずれかです。詳細については、axe DevTools for Web 使用サービスを参照してください。
違反
axe DevToolsによって特定された、1つ以上のアクセシビリティ基準に違反している問題です。
ウォッチャー
テストスイートに統合するコードコンポーネントはウォッチャーと呼ばれます。Dequeは、サポートされている言語およびテストフレームワーク向けにいくつかのエディションを提供しています。テストスイートにウォッチャーパッケージを統合することで、ウェブページを分析し、その結果をaxe Developer Hubに報告し、結果を確認することができます。ウォッチャーパッケージは、現在のGitコミットとブランチをスキャンし、テスト実行をそれに関連付けます。
WCAG
WCAG、またはWebコンテンツアクセシビリティガイドラインは、World Wide Web Consortium（W3C）によって開発され、障害者がウェブコンテンツにアクセスしやすくする方法を説明しています。WCAG 1.0は1999年5月に発行され、WCAG 2.0は2008年12月に発行されました。WCAG 2.0は、より高度な技術に広く適用され、自動テストと人的評価によってより正確にテスト可能です。WCAG 2.1は2018年6月に発行されました。これらのガイドラインには、特定の要素に対するテスト可能な基準を定義する成功基準が含まれています。最新のガイドラインであるWCAG 2.2は2023年に発行され、WCAG 2.1に対して9つの新しい成功基準を提供します。
ラッピング
ラッピングは、ブラウザ自動化プラットフォーム（例：Cypress）を修正して、ブラウザ自動化プラットフォームの機能が呼ばれるたびにアクセシビリティテストコード（ウォッチャーパッケージ内）を呼び出すことを指します。ラッピングを使用すると、コードに最小限の変更を加えて、既存のテストスイートにアクセシビリティテストを統合することができます。