Axe DevTools for Web v4.x への移行方法 (Ruby 用)

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Ruby 用 Axe DevTools for Web バージョン 4.x への移行手順

Not for use with personal data

Axe DevTools for Web Gems v4.x は、プロジェクト全体の主要な書き換えです。最も注目すべき変更点を以下にまとめ、それに続いて関連するパッケージのより具体的な変更を示します。

概要

axe-devtools-* のスイートは、統合ツールを簡素化し、より良い開発者体験を提供するために再設計されました。

以前のバージョンでは単一の gem が提供されていただけでしたが、このバージョンでは、一連の gem を提供しており、エンドユーザーが自身のワークフローに最適なものを選択できます。

モノリシックな gem 構造から個々の gem への分割により、いくつかの移行手順が必要です。以下の移行ガイドを利用できます。

以前の開発者セットアップからの変更はありません。必要な要件は次の通りです：

Deque's registry へのアクセスを確保してください。アクセスできない場合は、refer to the setup guide。

Deque のレジストリにアクセスできるようになったら、以下の gem を Gemfile または gemspec ファイルに含めることでインストールできます。

gem "axe-devtools-cucumber"

あるいは、gem のソースを指定することもできます：

gem "attest-devtools-cucumber", :source => 'https://agora.dequecloud.com/artifactory/api/gems/devtools-gems'

利用可能な gem は以下の通りです：

使用説明書や API の詳細情報につきましては、ドキュメントをご参照ください。

以下のコマンドを実行して、以前の Ruby インテグレーションをアンインストールできます：

gem uninstall axe-matchers
gem uninstall attest-ruby

Ruby インテグレーションにおける他の注目すべき変更点は以下の通りです：

カスタムルールを設定するための環境変数が ATTEST_PATH から AXE_RULESET_PATH に変更されました。advanced usage を参照してください。
デフォルトのルールセットが変更されました。Axe DevTools for Web はデフォルトのルールセットとしてwcag2で指定されたページを監査します。エンドユーザーによる変更は必要ありません。別のルールセットを設定したい場合は、Cucumber のドキュメントまたはRSpec のドキュメントで提供されているそれぞれの条項を使用することができます。このリリース以降デフォルトが再び変更されたことに注意してください。Axe DevTools for Web 4.5（2022年12月）より、デフォルトのルールセットはすべてのパッケージでWCAG 2.1 レベルAAに標準化され、最良のプラクティスはオフになっています。ルールのカスタマイズを参照してください。
RSpec の be_accessible マッチャーが be_axe_clean に名前が変更されました。
RSpec の be accessible ステップ定義が be axe clean に名前が変更されました。