アクセシビリティ検査スイート利用マニュアル
このディレクトリは、アクセシビリティ検査スイート一式を利用する人向けのマニュアルです。
アクセシビリティ検査スイートは次の3つで構成されます。
| 名称 | 役割 |
|---|---|
| ライセンス認証 | アクセシビリティ検査記録簿 / アクセシビリティ検査員 共通のライセンス認証 |
| アクセシビリティ検査記録簿 | アクセシビリティ試験の方針、対象ページ、試験結果、公開用Markdownを記録する管理画面 |
| アクセシビリティ検査員 | ログイン中の公開ページ上で動作するアクセシビリティ検査パネル |
読む順番
初めて利用する場合は、次の順番で読んでください。
このマニュアルの前提
- a-blog cms の管理画面にログインできる
- 拡張アプリを設置・有効化できる権限がある
- ライセンスキーを発行元から受け取っている、または購入予定である
- アクセシビリティ検査記録簿の試験記録は原則として親ブログで行う
- アクセシビリティ検査員はログイン中の公開ページで使う。管理画面では検査パネルは表示されない
画面名の表記
管理画面のURLは環境によって bid が変わります。本文では画面名を中心に説明し、必要な場合だけURL例を載せます。
| 画面 | URL例 |
|---|---|
| ライセンス認証 | /bid/1/admin/app_mszm_a11ysuite_license/ |
| アクセシビリティ検査記録簿 | /bid/1/admin/app_mszm_a11yflow_index/ |
| アクセシビリティ検査員設定 | /bid/1/admin/app_mszm_a11yinspector_index/ |
作業全体の流れ
購入・ライセンス発行
↓
ライセンス認証で認証
↓
アクセシビリティ検査記録簿で試験方針と対象ページを決める
↓
アクセシビリティ検査員で公開ページを検査する
↓
アクセシビリティ検査記録簿に結果を記録する
↓
試験結果 Markdown とスナップショットを保存する
用語
| 用語 | 意味 |
|---|---|
| ライセンスキー | 発行元から受け取る認証用の文字列。利用者はこれをライセンス認証に入力する |
| 対象ドメイン | ライセンスで利用を許可するドメイン。例: example.com |
| 複数サイト可ライセンス | 1つのライセンスキーで複数ドメインを登録できるライセンス |
| 試験対象ページ | アクセシビリティ検査記録簿で試験対象として確定したページ |
| 達成基準 | WCAG / JIS X 8341-3 の各確認項目。例: 1.1.1 非テキストコンテンツ |
| 共通項目 | サイト全体に共通して判断できる達成基準。ページ別では編集不可になる |
| スナップショット | 試験完了時点の記録をJSONとして固定保存したもの |