Axe DevTools C# 概要

Axe DevTools C# に含まれるもの:

• axe-core バージョン 4
• Microsoft Visual Studio 2019 IDE サポート
• Microsoft .NET Core 2.2.0 CLI サポート

スキャンはデフォルトでWCAG 2.1レベルAAに基づいて実行され、ベストプラクティスと実験的なルールはオフになっています。ルールセットを変更したり、ベストプラクティスを有効にするには、ルールをカスタマイズを参照してください。

前提条件

Axe DevTools には、選択したブラウザーの Selenium WebDriver バインディングが必要です。Axe DevTools を使用するには、まず Selenium WebDriver をインストールして設定する必要があります。

仮定と既知の制限事項

• この統合を使用する際の仮定:

  • テストを実行する前にページの希望する状態を設定していること。
  • axe を実行し設定を適用する以外に Selenium オブジェクトを変更していないこと。
  • テストが完了したら、テストしたウェブページを閉じること。

• ベストプラクティス: ページを更新せずに追加のテストを実行しないでください。Selenium テスト実行中にウェブページの状態を変更し、元の予期されたページ状態を復元せずにテストを実行すると、予測不能なテスト結果を引き起こします。Axe DevTools C# はテスト中にウェブページにコンテンツを挿入することがあります。以前にテストされたページで Axe DevTools を繰り返し実行しようとすると、予測不能なテスト結果を引き起こします。

カスタムエレメントとElementInternals

Axe DevTools C# 4.13.0からは、スキャンがJavaScriptのElementInternalsを通じてWebコンポーネントが宣言するARIAセマンティクスを読み取るようになり、マークアップに存在するroleおよびaria-*属性だけではありません。構成は不要です。DOM内のセマンティクスが依然として優先されます: 要素に明示的なroleまたはaria-*属性があれば、ElementInternalsからの値を上書きします。

これが効果を持つためには、コンポーネントは内部情報を公開しなければなりませんし、プライベートクラスフィールドにそれらを格納するコンポーネントは読み取れません。ElementInternalsを使用するカスタムエレメントのテストを参照してください。