accessibility-rules について
accessibility-rulesは、Word、Excel、PowerPoint、PDF、ePubを対象とする文書アクセシビリティ検査のリファレンスです。問題をルール種別ごとに整理し、文書向けルールをWCAG 2.2の基準に対応付けます。
主な機能
- 01ファイル形式と重大度別のルール分類
- 02WCAG 2.2レベルA・AAへの対応付け
- 03エラー、警告、ヒントの定義
- 04確信度レベルの提示
- 05Section 508とEN 301 549の対応表
活用シーン
- 01文書形式ごとのアクセシビリティルールの検索
- 02検出事項とWCAG基準の対応付け
- 03必須修正と改善案の区別
- 04PDF/UA準拠に関するルールの確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ community-access/ accessibility-agents --skill accessibility-rulesインストール後、Claude Code で/accessibility-rulesを入力して読み込まれたか確認します。
詳細
ドキュメントのアクセシビリティルールリファレンス
ルール ID の接頭辞
| 接頭辞 | 形式 | サブエージェント | 件数 |
|---|---|---|---|
| DOCX-E* | Word のエラー | word-accessibility | 9 ルール |
| DOCX-W* | Word の警告 | word-accessibility | 6 ルール |
| DOCX-T* | Word のヒント | word-accessibility | 3 ルール |
| XLSX-E* | Excel のエラー | excel-accessibility | 8 ルール |
| XLSX-W* | Excel の警告 | excel-accessibility | 5 ルール |
| XLSX-T* | Excel のヒント | excel-accessibility | 3 ルール |
| PPTX-E* | PowerPoint のエラー | powerpoint-accessibility | 7 ルール |
| PPTX-W* | PowerPoint の警告 | powerpoint-accessibility | 6 ルール |
| PPTX-T* | PowerPoint のヒント | powerpoint-accessibility | 4 ルール |
| PDFUA.* | PDF/UA 準拠 | pdf-accessibility | 30 ルール |
| PDFBP.* | PDF のベストプラクティス | pdf-accessibility | 22 ルール |
| PDFQ.* | PDF の品質/パイプライン | pdf-accessibility | 4 ルール |
| EPUB-E* | ePub のエラー | epub-accessibility | 7 ルール |
| EPUB-W* | ePub の警告 | epub-accessibility | 6 ルール |
| EPUB-T* | ePub のヒント | epub-accessibility | 3 ルール |
WCAG 2.2 達成基準との対応
WCAG 2.2 レベル A および AA のすべての達成基準を網羅しています。ドキュメント固有のルールがある基準にはルール ID を記載しています。人による判断が必要な基準には「手動レビュー」と記載しています。Web/アプリのコンテキストにのみ適用される基準にはダッシュを記載しています。各基準の詳しい説明については、wcag-guide エージェントを参照してください。
注: WCAG 2.2 では 4.1.1 Parsing が削除されました(最新のユーザーエージェントでは「常に満たされる」ため、テスト対象ではなくなりました)。
レベル A(必ず修正)
| WCAG | 達成基準 | 関連ルール |
|---|---|---|
| 1.1.1 | 非テキストコンテンツ | DOCX-E001, XLSX-E001, PPTX-E001, PDFUA.IMG.ALT, EPUB-E005 |
| 1.2.1 | 音声のみおよび映像のみ(収録済み) | 手動レビュー(埋め込みメディア) |
| 1.2.2 | キャプション(収録済み) | 手動レビュー(埋め込み動画) |
| 1.2.3 | 音声解説またはメディアの代替コンテンツ(収録済み) | 手動レビュー(埋め込み動画) |
| 1.3.1 | 情報および関係性 | DOCX-E002, DOCX-E003, DOCX-E005, XLSX-E002, XLSX-E004, PPTX-E004, PDFUA.TAGGED, PDFUA.HEADINGS |
| 1.3.2 | 意味のある順序 | PPTX-E006, PDFUA.READING_ORDER, EPUB-E006 |
| 1.3.3 | 感覚的な特徴 | 手動レビュー(すべての形式) |
| 1.4.1 | 色の使用 | XLSX-E007, 手動レビュー(その他の形式) |
| 1.4.2 | 音声の制御 | 手動レビュー(埋め込み音声) |
| 2.1.1 | キーボード | PDFUA.FORMS(インタラクティブ PDF) |
| 2.1.2 | キーボードトラップなし | PDFUA.FORMS(インタラクティブ PDF) |
| 2.1.4 | 文字キーのショートカット | ---(Web/アプリ固有) |
| 2.2.1 | タイミング調整可能 | ---(Web/アプリ固有) |
| 2.2.2 | 一時停止、停止、非表示 | 手動レビュー(ドキュメント内のアニメーションコンテンツ) |
| 2.3.1 | 3 回の閃光、または閾値以下 | 手動レビュー(アニメーションコンテンツ) |
| 2.4.1 | ブロックスキップ | PDFUA.BOOKMARKS, PDFBP.NAV, EPUB-E004 |
| 2.4.2 | ページタイトル | DOCX-E004, XLSX-E006, PPTX-E002, PDFUA.TITLE, EPUB-E001 |
| 2.4.3 | フォーカス順序 | PDFUA.FORMS(インタラクティブ PDF) |
| 2.4.4 | リンクの目的(コンテキスト内) | DOCX-E006, XLSX-E005, PPTX-E005 |
| 2.5.1 | ポインターのジェスチャー | ---(Web/アプリ固有) |
| 2.5.2 | ポインターのキャンセル | ---(Web/アプリ固有) |
| 2.5.3 | 名前のラベル | PDFUA.FORMS(インタラクティブ PDF) |
| 2.5.4 | 動きによる作動 | ---(Web/アプリ固有) |
| 3.1.1 | ページの言語 | DOCX-T001, XLSX-T003, PPTX-T004, PDFUA.LANG, EPUB-E003 |
| 3.2.1 | フォーカス時 | ---(Web/アプリ固有) |
| 3.2.2 | 入力時 | ---(Web/アプリ固有) |
| 3.2.6 | 一貫したヘルプ | ---(Web/アプリ固有) |
| 3.3.1 | エラーの特定 | PDFUA.FORMS(インタラクティブ PDF) |
| 3.3.2 | ラベルまたは説明 | PDFUA.FORMS(インタラクティブ PDF) |
| 3.3.7 | 冗長な入力 | ---(Web/アプリ固有) |
| 4.1.2 | 名前、役割、値 | DOCX-E009, PDFUA.FORMS, PDFUA.TAGS |
レベル AA(修正推奨)
| WCAG | 基準 | 関連ルール |
|---|---|---|
| 1.2.4 | ライブキャプション | ---(Web/アプリ固有) |
| 1.2.5 | 音声解説(事前録画) | 手動レビュー(埋め込み動画) |
| 1.3.4 | 画面の向き | ---(Web/モバイル固有) |
| 1.3.5 | 入力目的の識別 | PDFUA.FORMS(インタラクティブ PDF) |
| 1.4.3 | コントラスト(最低限) | 手動レビュー(Office 形式)、PDFBP.Contrast |
| 1.4.4 | テキストのサイズ変更 | 手動レビュー(PDF のリフロー) |
| 1.4.5 | テキストの画像 | PDFBP.IMG_TEXT |
| 1.4.10 | リフロー | 手動レビュー(PDF のリフロー) |
| 1.4.11 | 非テキストのコントラスト | 手動レビュー(すべての形式) |
| 1.4.12 | テキストの間隔 | 手動レビュー(PDF のテキスト間隔) |
| 1.4.13 | ホバーまたはフォーカス時のコンテンツ | ---(Web/アプリ固有) |
| 2.4.5 | 複数の手段 | 手動レビュー(複数ページのドキュメント) |
| 2.4.6 | 見出しとラベル | DOCX-E003、DOCX-E007、PDFUA.HEADINGS |
| 2.4.7 | フォーカスの可視化 | PDFUA.FORMS(インタラクティブ PDF) |
| 2.4.11 | フォーカスが隠れないこと(最低限) | ---(Web/アプリ固有) |
| 2.5.7 | ドラッグ操作 | ---(Web/アプリ固有) |
| 2.5.8 | ターゲットサイズ(最低限) | 手動レビュー(インタラクティブ PDF) |
| 3.1.2 | 部分ごとの言語 | 手動レビュー(Office 形式)、PDFUA.LANG_PARTS |
| 3.2.3 | 一貫したナビゲーション | ---(Web/アプリ固有) |
| 3.2.4 | 一貫した識別 | ---(Web/アプリ固有) |
| 3.3.3 | エラーの提案 | PDFUA.FORMS(インタラクティブ PDF) |
| 3.3.4 | エラーの防止(法的、金融、データ) | PDFUA.FORMS(インタラクティブ PDF) |
| 3.3.8 | アクセシブルな認証(最低限) | ---(Web/アプリ固有) |
| 4.1.3 | ステータスメッセージ | ---(Web/アプリ固有) |
重大度の定義
| 重大度 | 意味 | 支援技術ユーザーへの影響 |
|---|---|---|
| エラー | アクセスを妨げる | 支援技術ではコンテンツにアクセスできない、または使用できない |
| 警告 | 利用体験を損なう | コンテンツにはアクセスできるが、利用体験が悪い、または分かりにくい |
| ヒント | ベストプラクティス | コンテンツは機能するが、支援技術での利用体験を向上させるために改善できる |
信頼度レベル
| レベル | 重み | 意味 |
|---|---|---|
| 高 | 1.0 | サブエージェントは、これが実際の問題であると確信しています |
| 中 | 0.7 | 問題である可能性が高いものの、人間による判断が必要です |
| 低 | 0.3 | 問題の可能性があり、レビュー対象としてフラグが付けられています |
準拠規格
| 規格 | 適用範囲 | 主なルール |
|---|---|---|
| WCAG 2.2 レベル A | 国際 | すべてのエラーレベルのルール |
| WCAG 2.2 レベル AA | 国際 | すべてのエラーおよび警告ルール |
| Section 508 | 米国連邦政府 | WCAG 2.0 レベル AA に対応 |
| EN 301 549 | 欧州連合 | WCAG 2.1 レベル AA に対応 |
| PDF/UA (ISO 14289) | PDF 固有 | すべての PDFUA.* ルール |
コメント
Markdown 対応