A11yDocs マニュアル アクセシビリティ検査記録簿の試験の進め方

アクセシビリティ検査記録簿の試験の進め方

このページでは、アクセシビリティ検査記録簿(A11yFlow)を使ってアクセシビリティ試験を進める手順を説明します。

アクセシビリティ検査記録簿は、アクセシビリティ試験の記録簿です。方針、試験対象ページ、共通項目、ページ別チェック、集計、公開用Markdown、スナップショットを順番に保存できます。

使い始める前の準備

  1. ライセンス認証を行います。
  2. 拡張アプリ アクセシビリティ検査記録簿 を有効化します。
  3. 子ブログがある場合は、子ブログでも拡張アプリを有効化します。
  4. 試験記録は原則として親ブログで行います。
  5. エントリー編集画面にチェックシートを表示する場合は、config.server.php でフックを有効化します。
define('HOOK_ENABLE', 1);
  1. 使用テーマの管理テンプレートに、チェックシート挿入用の記述を追加します。
<!-- BEGIN_MODULE Admin_InjectTemplate id="a11y-flow-field" --><!-- END_MODULE Admin_InjectTemplate -->

追加候補:

admin/blog/field.html
admin/category/field.html
admin/entry/field.html

ダッシュボードを確認する

管理画面の アクセシビリティ検査記録簿 を開きます。

URL例:

https://example.com/bid/1/admin/app_mszm_a11yflow_index/

最初にダッシュボードが表示されます。ダッシュボードでは、試験状況、次にやること、よく使う操作を確認できます。

1. 方針を作成する

方針 タブで、サイトのアクセシビリティ方針を作成します。

入力する主な項目:

項目入力例
ウェブサイトのURLhttps://example.com
目標とする適合レベルWCAG 2.2 / レベルAA
対応度準拠 / 一部準拠 / 配慮
例外事項PDF資料、動画、外部サービス埋め込みなど
達成期限日付
お問い合わせ部署広報・情報システム部など
電話番号・受付時間公開する問い合わせ情報
お問い合わせフォームURLhttps://example.com/contact/
改訂履歴初版公開、試験結果反映など

操作手順:

  1. 必要な項目を入力します。
  2. ひな形がある項目は 入力欄へ を押すと入力できます。
  3. Markdownを作成 を押します。
  4. 生成されたMarkdownを確認します。
  5. 必要に応じて文章を修正します。
  6. 方針を保存して次へ を押します。

2. 対象ページを選定する

対象ページ:選定 タブで、試験対象ページの候補を作ります。

基本的な考え方:

操作手順:

  1. 試験から外すURLがあれば 除外URL に入力します。
  2. サイトマップから取得する を押します。
  3. 候補URL一覧から、必ず含めたい代表ページにチェックを入れます。
  4. 必要に応じて 手動で候補URLを追加 を開き、サイトマップに出ないURLを追加します。
  5. 必要に応じて 代表ページを手動で追加 を開き、必ず含めたいページを追加します。
  6. 検査するページ数を入力 に件数を入力します。
  7. ランダムチョイスを実行 を押します。
  8. 選択結果を確認します。
  9. 対象ページの選定を保存して次へ を押します。

3. 対象ページを確定する

対象ページ:確定 タブで、選定したページを正式な試験対象として保存します。

操作手順:

  1. 確定対象の一覧を確認します。
  2. 不足や偏りがあれば、前の 対象ページ:選定 に戻って調整します。
  3. 問題なければ 試験実施ページを確定して保存して次へ を押します。

ここで保存した一覧が、以降の試験、集計、公開用Markdownの対象になります。

4. 試験環境を設定する

試験実施:環境 タブで、試験の前提条件を保存します。

入力する主な項目:

項目入力例
規格番号および改正年JIS X 8341-3:2016をベースにWCAG 2.2で補う
チェックツールaxe-core、手動確認(キーボード操作・スクリーンリーダー)
ウェブコンテンツ技術HTML CSS JavaScript
OS・ユーザーエージェント・支援技術Windows 11、Microsoft Edge、Google Chrome、NVDA
チェックシート表示各ページの達成基準チェックシートを表示するか
対象とするレベルA / AA / AAA

操作手順:

  1. 規格、チェックツール、技術、検証環境を入力します。
  2. 各ページの編集画面でチェックシートを使う場合は、各ページの達成基準チェックシートを有効にする をオンにします。
  3. 対象レベルを選びます。通常は AA を選ぶことが多いです。
  4. 試験範囲を保存して次へ を押します。

5. 共通項目を入力する

試験実施:共通 タブで、サイト全体に共通する達成基準の判断を入力します。

共通項目の例:

操作手順:

  1. 共通ページの URL(検査ツール用) に、代表となる公開ページURLを入力します。
  2. 達成基準ごとに 適用 を選びます。
  3. 試験結果を ○ / × / △ で入力します。
  4. 必要に応じて 詳細 を開き、注記、不適合の理由、確認方法、確認日を入力します。
  5. 共通設定を保存 を押します。

共通で固定する項目がない場合は、共通項目なしで完了して次へ を押します。

6. ページ別に試験する

試験実施:一覧 タブで、確定した各ページの状態を確認し、ページごとのチェックシートへ進みます。

操作手順:

  1. 一覧で対象ページを確認します。
  2. フィルタ すべて / 未確認 / 問題あり / 問題なし を使い、作業対象を絞ります。
  3. 各行の 編集 を開きます。
  4. エントリー編集画面内の アクセシビリティ検査記録簿 で、達成基準ごとに結果を入力します。
  5. 公開ページを確認したい場合は、チェックシートの 検査ツールで見る を開きます。
  6. アクセシビリティ検査員が開いた公開ページで検査し、必要な内容をアクセシビリティ検査記録簿のチェックシートへ記録します。
  7. すべての対象ページが「未試験」以外になるまで繰り返します。

チェックシートの入力ルール

入力内容
適用その達成基準を試験対象にするか
結果 問題なし、× 不適合あり、 注記あり
検査ツール公開ページを アクセシビリティ検査員 で開く
詳細注記、不適合の理由、確認方法、確認日

注意:

7. 結果を確定する

結果確定 タブで、入力済みのチェックシートを集計します。

操作手順:

  1. 試験結果を確定する前に、一度ブラウザを再読み込みします。
  2. 試験を確定して結果を集計して次へ を押します。
  3. 必要に応じて 集計結果を表示する を押し、集計表と不適合一覧を確認します。
  4. 不備があればページ別チェックシートに戻って修正します。
  5. 修正した場合は、もう一度 試験を確定して結果を集計して次へ を押します。

8. 試験結果Markdownを作成する

試験結果 タブで、公開用のMarkdownを生成します。

入力・生成する内容:

区分内容
試験実施ページリスト確定した試験対象ページ一覧
不適合一覧× がある場合の課題一覧
試験の記録表明日、試験期間、追加措置
試験記録の補足試験実施機関、ツールバージョン、選定根拠、除外理由
該当レベルの試験結果公開方針ページに掲載するMarkdown

操作手順:

  1. 表明日、試験実施期間、試験実施機関などを入力します。
  2. 試験実施ページリストMarkdownを作成 を押します。
  3. 不適合がある場合は 不適合一覧Markdownを作成 を押します。
  4. 該当の適合レベルの達成基準の試験結果Markdownを作成 を押します。
  5. 生成されたMarkdownを確認し、必要に応じて手動で調整します。
  6. 試験結果を保存して次へ を押します。

9. スナップショットを保存する

スナップショット タブで、試験完了時点の記録を固定します。

操作手順:

  1. 公開用スナップショットを更新 を押します。
  2. JSONが生成されたことを確認します。
  3. スナップショットを保存 を押します。

スナップショットは、後から「この時点でどの方針・対象ページ・試験結果だったか」を確認するための記録です。公開後や納品前には必ず保存してください。

修正が発生した場合の戻り方

試験中に修正が発生した場合は、次の順番で戻ります。

  1. 対象ページを修正します。
  2. アクセシビリティ検査員 で再検査します。
  3. アクセシビリティ検査記録簿のページ別チェックシートを更新します。
  4. 結果確定 で再集計します。
  5. 試験結果 でMarkdownを再生成します。
  6. スナップショット を更新・保存します。

対象ページそのものを変更した場合は、対象ページ:選定対象ページ:確定 からやり直してください。