【ITニュース解説】Point Claude Code at axe-core's Violations, Not at 'Make This Page Accessible'
2026年11月04日に「Dev.to」が公開したITニュース「Point Claude Code at axe-core's Violations, Not at 'Make This Page Accessible'」について初心者にもわかりやすく解説しています。
ITニュース概要
AIコーディングエージェントに「ページをアクセシブルに」と漠然と指示すると、不適切なARIA追加でかえってエラーが増える恐れがある。これを防ぐには、axe-coreが検出した具体的な違反リストをAIへの指示にし、Playwrightで修正前後の自動テストを行うと効果的だ。ただし、自動テストで検出できない問題は手動で確認する必要がある。
ITニュース解説
AIによるウェブ開発が加速する中、ウェブサイトのアクセシビリティを確保することはますます重要になっている。アクセシビリティとは、障害の有無や利用環境に関わらず、すべての人がウェブサイトを問題なく利用できる状態を指す。しかし、AIに漠然と「このページをアクセシブルにして」と指示するだけでは、かえって問題を引き起こす可能性があることが指摘されている。
2026年2月にWebAIMが行った調査によると、100万件のウェブサイトのホームページをスキャンした結果、82.7%のサイトでARIA(Accessible Rich Internet Applications)が使用されていた。ARIAを使用しているページでは平均133個ものARIA属性が見られ、平均59.1個のアクセシビリティエラーが検出された。一方で、ARIAを使用していないページでは平均42個のエラーだった。WebAIMはこの結果について、ARIAを使用しているページはより複雑であるため、ARIAが直接エラーの原因とは断定できないと慎重に述べている。しかし、このデータは、単にARIAを多く使うことが必ずしもエラーの削減に繋がっていないことを示唆している。
このような状況で、もしAIコーディングエージェントに「このページをアクセシブルにして」と指示するとどうなるだろうか。AIは最も手早く見える変更として、ラベルがついていないと思われるすべての要素にaria-label属性を無差別に付与しようとするかもしれない。その結果生成されるコードの差分は膨大で、正しく修正されたかどうかを検証することは難しい。W3C(World Wide Web Consortium)のガイドラインは、このような行為が「開発者が意図せずアクセシビリティのセマンティクス(意味合い)を上書きしてしまう可能性がある」と明確に警告している。これは、本来のHTMLが持つ意味をARIAが上書きしてしまい、かえってスクリーンリーダーなどの支援技術が正しく情報を伝えられなくなるリスクがあるためである。
このような問題を防ぐための解決策は、AIエージェントに漠然とした「願い」を与えるのではなく、具体的で検証可能な「リスト」を与えることである。そのための有効なツールとしてaxe-coreという自動アクセシビリティテストライブラリがある。axe-coreは、ウェブページのアクセシビリティ違反を検出し、その違反がどのルールに違反しているかを示すルールIDと、影響を受けている要素を特定するためのCSSセレクタのリストを提供してくれる。この詳細なリストこそが、AIエージェントに与えるべきプロンプト(指示)となる。さらに、AIが修正を適用した後、その修正が正しく行われたことを自動的に検証するために、Playwrightという自動テストフレームワークを活用する。
具体的な手順を見てみよう。まず、意図的にアクセシビリティ違反を含んだサンプルHTMLページを用意する。例えば、以下のような問題があるページを想定する。文字と背景のコントラストが低い(灰色文字に白背景)、メールアドレス入力欄にラベルがない、ボタンがアイコンだけでテキストがない、HTMLドキュメントに言語属性(lang)がない、といった問題である。
この用意したページに対して、axe-core/cliというコマンドラインツールを使ってスキャンを実行する。このツールは、ウェブページをChromeブラウザで開き、アクセシビリティ違反がないかを自動的にチェックしてくれる。スキャン結果はJSON形式で出力され、どのルール(例: color-contrast、label、button-name、html-has-lang)に違反しているか、その違反の深刻度、影響を受ける要素のCSSセレクタ、そしてその問題をどのように修正すべきかといった詳細な情報が含まれる。このJSONデータが、AIに具体的な指示を出すための重要な情報源となる。
次に、AIに修正を依頼する前に、修正が正しく行われたことを確認するためのテストコードを記述する。ここではPlaywrightと@axe-core/playwrightを組み合わせて使用する。Playwrightはウェブブラウザの操作を自動化できるツールで、これを使ってウェブページを開き、@axe-core/playwrightで再度アクセシビリティスキャンを実行する。このテストは、当初は意図的に失敗するように設定する。なぜなら、まだアクセシビリティ違反が修正されていない状態だからである。この「失敗するテスト」は、まるで門番のように機能し、修正が完了してテストがパスするまで、コードの変更が承認されないようにする。このようなテスト駆動開発のアプローチは、AIエージェントの作業の品質を保証するために非常に効果的だ。このテストは、継続的インテグレーション(CI)環境に組み込むことで、プルリクエストごとに自動的にアクセシビリティ違反をチェックし、問題があれば開発者に警告する仕組みを構築できる。もし既存のウェブページにすぐに修正できないアクセシビリティ負債がある場合でも、特定のルールを一時的に無効にする設定も可能だが、それは慎重に行うべきである。
準備が整ったら、いよいよAIエージェントに修正を依頼する。ここで重要なのは、AIに渡すプロンプトの内容である。漠然とした指示ではなく、先ほどaxe-coreで得たJSONデータに基づき、以下のような具体的で制約の多い指示を与える。
axe-results/signup.jsonに記載されているアクセシビリティ違反を修正する。- 各ルールIDごとに作業し、
nodes[].targetに指定された要素のみを変更する。 - 可能な限りネイティブなHTML要素を優先する。例えば、
aria-labelよりもfor属性を持つ<label>要素を使用する。ボタンにはaria-labelではなく、視覚的に見えるテキストを記述する。 - 色のコントラストに関する違反の場合、背景色に対して4.5:1以上のコントラスト比になる色を選び、その比率を明記する。
- テストファイルやPlaywrightの設定ファイル、
axeのスキャンタグは編集しない。また、ルールを無効にしたり、要素をスキャン対象から除外したりもしない。 npx playwright testコマンドがパスしたら、作業は完了とする。- 修正が完了したら、各ルールIDについて、どのような変更を行ったかを一行で簡潔に報告する。
このように明確なプロンプトを与えることで、AIエージェントは具体的な目標と制約の中で作業を進めることができる。無駄な変更や誤った変更を防ぎ、求められている修正に集中させることが可能になる。
AIエージェントが修正を提案したら、その内容を人間がレビューする。このレビュープロセスでは、以下の点を重点的に確認する。
- AIがテストファイルやPlaywrightの設定ファイルに変更を加えていないか。これらが変更されている場合、テストの結果は信頼できない。
- HTMLやCSSの変更が、プロンプトで指示したルールIDに対応しているか。意図しない「スコープクリープ」(指示外の変更)がないかを確認する。
- AIが
aria-*属性を追加した場合、それがネイティブなHTML要素で代替できないか検討する。視覚的にラベルが見える<label>要素や、ボタンのテキスト化など、すべての人が利用しやすい方法を優先する。
例えば、サンプルページに対する良い修正案は、HTMLの<html>タグにlang="en"を追加し、色のコントラストが低い灰色テキストの色をより濃い色(例: #767676、コントラスト比約4.54:1)に変更し、メール入力欄に<label for="email">とid="email"を追加し、アイコンだけのボタンに「Create account」といったテキストを追加し、アイコンのSVGにはaria-hidden="true"を付与してスクリーンリーダーから隠す、といったものになるだろう。
最後に、axeのような自動テストツールがすべてのアクセシビリティ問題を検出できるわけではないことを理解しておく必要がある。Deque(axeの開発元)の報告によると、自動テストでカバーできる問題は監査対象の約57%に過ぎない。例えば、画像の代替テキスト(alt属性)が存在するかどうかは検出できるが、そのテキストが画像の情報を適切に説明しているかまでは判断できない。また、ウェブページのタブ移動の順序が論理的か、フォーム送信失敗時にスクリーンリーダーがどのように読み上げるかなども自動テストでは検出できない。axeのスキャン結果には「レビューが必要」(incomplete)と分類される項目も存在し、これらはAIエージェントに修正させるのではなく、人間が手動で確認し、実際にページを操作してアクセシビリティを検証すべき部分である。
結論として、AIをウェブアクセシビリティの向上に効果的に活用するためには、AIに「漠然とした願い」を伝えるのではなく、axe-coreのようなツールで得られた具体的で検証可能な「リスト」をプロンプトとして与えることが重要である。そして、その修正結果はPlaywrightなどの自動テストで検証し、最終的には人間が詳細にレビューすることで、AIと人間が協力してよりアクセシブルなウェブサイトを開発できる。AIは強力なツールだが、その能力を最大限に引き出すには、人間の明確な指示と検証が不可欠なのである。