Skip to content

Commit

Permalink
Merge pull request #232 from waic/apply-markdownlint
Browse files Browse the repository at this point in the history
markdownlintの自動フォーマットを反映
  • Loading branch information
nishimotz authored Jul 3, 2024
2 parents 1c3f2a2 + c3b2932 commit 62f67d5
Show file tree
Hide file tree
Showing 113 changed files with 2,037 additions and 772 deletions.
22 changes: 11 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@

# AS 情報を作成するためのテスト

このリポジトリは、[ウェブアクセシビリティ基盤委員会 実装作業部会 (WG2) ](https://waic.jp/committee/wg2/)が管理しています。
このリポジトリは、[ウェブアクセシビリティ基盤委員会 実装作業部会 (WG2)](https://waic.jp/committee/wg2/)が管理しています。

JIS X 8341-3 や WCAG2.0 における「アクセシビリティサポーテッド」に関する情報(AS情報)を作成するために必要となるテストケース・テストコードの作成を行うリポジトリです。

## 主要なディレクトリー構成

GitHub 上でのディレクトリ構成は以下の通りです。

- as_test/
- as_test/WAIC-TEST/ # HTML や CSS などのウェブ技術に、ブラウザや支援技術がどの程度対応しているかを確認するためのテストケース。テストの目的、テスト手順、期待される結果、テスト実施時の注意点などを記載しています。
- as_test/WAIC-TEST/HTML/ # HTML への対応状況を確認するためのテストケース
- as_test/WAIC-CODE/ # それぞれのテストケースで使用する HTML や CSS などのテスト。
- as_test/notification/ # テストケース・テストコードに関する注意事項、用語集など
- as_test/
- as_test/WAIC-TEST/ # HTML や CSS などのウェブ技術に、ブラウザや支援技術がどの程度対応しているかを確認するためのテストケース。テストの目的、テスト手順、期待される結果、テスト実施時の注意点などを記載しています。
- as_test/WAIC-TEST/HTML/ # HTML への対応状況を確認するためのテストケース
- as_test/WAIC-CODE/ # それぞれのテストケースで使用する HTML や CSS などのテスト。
- as_test/notification/ # テストケース・テストコードに関する注意事項、用語集など

## テストケース・テストコードに対するコメントや修正提案の送信方法

Expand All @@ -29,8 +29,8 @@ GitHub 上でのディレクトリ構成は以下の通りです。

GitHubでの運用は以下のように進めることを考えています。

- master ブランチがリリース可能な最新の状態となるようにする (GitHub Pages でも master の内容が見えるようにする)
- 作業を開始する時には作業用ブランチを作成し、そのブランチで作業する。ブランチの名前は作業の内容に応じたものとする
- 作業中は適宜ブランチを push する
- 作業が終わったところでプルリクエストを出す。その際、作業者以外の人がレビューする。レビュアーを作業者が指名することもできる。
- 作業内容に問題ないことが確認出来たら master ブランチにマージする(ブランチは自動で削除されます)
- master ブランチがリリース可能な最新の状態となるようにする (GitHub Pages でも master の内容が見えるようにする)
- 作業を開始する時には作業用ブランチを作成し、そのブランチで作業する。ブランチの名前は作業の内容に応じたものとする
- 作業中は適宜ブランチを push する
- 作業が終わったところでプルリクエストを出す。その際、作業者以外の人がレビューする。レビュアーを作業者が指名することもできる。
- 作業内容に問題ないことが確認出来たら master ブランチにマージする(ブランチは自動で削除されます)
19 changes: 15 additions & 4 deletions WAIC-TEST/HTML/WAIC-TEST-0001-01.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,60 @@


# テスト ID

WAIC-TEST-0001-01

# テストのタイトル

同じリンクの中に入れた画像 (代替テキストなし) とテキスト (1. 画像 2. テキスト)

# テストの目的

画像 (代替テキストなし) とテキストを 1. 画像 2. テキスト の順で同じリンクの中に入れた場合、代替テキストやコンテンツと誤解される表示・読み上げがないかの確認

# テストの対象となる達成基準 (複数)

1.1.1, 2.4.4, 2.4.9

# 関連する達成方法 (複数)

H2, H30

# テストコード (テストファイルへのリンク)

[WAIC-CODE-0001-01](https://waic.github.io/as_test/WAIC-CODE/WAIC-CODE-0001-01.html)

# テストコードのソース (抜粋)

```html
<div>
<a href="http://waic.jp/"><img src="img/H2-1.gif" alt="">ウェブアクセシビリティ基盤委員会公開サイト</a>
</div>

```

# テスト手順 (視覚閲覧環境)

表示 : ブラウザの設定を変更して画像非表示にし、表示内容を確認

# 期待される結果 (視覚閲覧環境)

代替テキストや、コンテンツと誤解されるようなファイル名や URL などは表示されず、リンクテキスト “ウェブアクセシビリティ基盤委員会公開サイト” のみが表示される

# テスト実施時の注意点 (視覚閲覧環境)

“画像” と表示されたり、画像のプレースホルダの枠が表示されたりする場合は OK と判断

# テスト手順 (音声閲覧環境)

リンクを読み上げ、内容を確認

# 期待される結果 (音声閲覧環境)

アイコン画像の代替テキストは何も読み上げられず、リンクテキスト “ウェブアクセシビリティ基盤委員会公開サイト” のみが読み上げられる

# テスト実施時の注意点 (音声閲覧環境)

代替テキストなし (alt="") の画像を “画像” と読み上げるモードがある場合も OK と判断するが、テキストモードや全文読みモードなどで読み上げられる場合は NG と判断

# 関連する要素や属性
a 要素 , img 要素 , alt 属性


a 要素 , img 要素 , alt 属性
19 changes: 15 additions & 4 deletions WAIC-TEST/HTML/WAIC-TEST-0001-02.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,60 @@


# テスト ID

WAIC-TEST-0001-02

# テストのタイトル

同じリンクの中に入れた画像 (代替テキストなし) とテキスト (1. テキスト 2. 画像)

# テストの目的

画像 (代替テキストなし) とテキストを 1. テキスト 2. 画像 の順で同じリンクの中に入れた場合、代替テキストやコンテンツと誤解される表示・読み上げがないかの確認

# テストの対象となる達成基準 (複数)

1.1.1, 2.4.4, 2.4.9

# 関連する達成方法 (複数)

H2, H30

# テストコード (テストファイルへのリンク)

[WAIC-CODE-0001-02](https://waic.github.io/as_test/WAIC-CODE/WAIC-CODE-0001-02.html)

# テストコードのソース (抜粋)

```html
<div>
<a href="http://waic.jp/">ウェブアクセシビリティ基盤委員会公開サイト<img src="img/H2-1.gif" alt=""></a>
</div>

```

# テスト手順 (視覚閲覧環境)

表示 : ブラウザの設定を変更して画像非表示にし、表示内容を確認

# 期待される結果 (視覚閲覧環境)

代替テキストや、コンテンツと誤解されるようなファイル名や URL などは表示されず、リンクテキスト “ウェブアクセシビリティ基盤委員会公開サイト” のみが表示される

# テスト実施時の注意点 (視覚閲覧環境)

“画像” と表示されたり、画像のプレースホルダの枠が表示されたりする場合は OK と判断

# テスト手順 (音声閲覧環境)

リンクを読み上げ、内容を確認

# 期待される結果 (音声閲覧環境)

アイコン画像の代替テキストは何も読み上げられず、リンクテキスト “ウェブアクセシビリティ基盤委員会公開サイト” のみが読み上げられる

# テスト実施時の注意点 (音声閲覧環境)

代替テキストなし (alt="") の画像を “画像”、“イメージ” など画像であることを読み上げるモードがある場合も OK と判断するが、テキストモードや全文読みモードなどで読み上げられる場合は NG と判断

# 関連する要素や属性
a 要素 , img 要素 , alt 属性


a 要素 , img 要素 , alt 属性
19 changes: 15 additions & 4 deletions WAIC-TEST/HTML/WAIC-TEST-0001-03.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,60 @@


# テスト ID

WAIC-TEST-0001-03

# テストのタイトル

同じ段落の中に入れた画像 (代替テキストなし) とテキスト

# テストの目的

画像 (代替テキストなし) とテキストを同じ段落の中に入れた場合、代替テキストやコンテンツと誤解される表示・読み上げがないかの確認

# テストの対象となる達成基準 (複数)

1.1.1

# 関連する達成方法 (複数)

H67

# テストコード (テストファイルへのリンク)

[WAIC-CODE-0001-03](https://waic.github.io/as_test/WAIC-CODE/WAIC-CODE-0001-03.html)

# テストコードのソース (抜粋)

```html
<div>
<p><img src="img/H2-1.gif" alt="">ウェブアクセシビリティ基盤委員会公開サイト</p>
</div>

```

# テスト手順 (視覚閲覧環境)

表示 : ブラウザの設定を変更して画像非表示にし、表示内容を確認

# 期待される結果 (視覚閲覧環境)

代替テキストや、コンテンツと誤解されるようなファイル名や URL などは表示されず、テキスト “ウェブアクセシビリティ基盤委員会公開サイト” のみが表示される

# テスト実施時の注意点 (視覚閲覧環境)

“画像” と表示されたり、画像のプレースホルダの枠が表示されたりする場合は OK と判断

# テスト手順 (音声閲覧環境)

段落を読み上げ、内容を確認

# 期待される結果 (音声閲覧環境)

アイコン画像の代替テキストは何も読み上げられず、テキスト “ウェブアクセシビリティ基盤委員会公開サイト” のみが読み上げられる

# テスト実施時の注意点 (音声閲覧環境)

代替テキストなし (alt="") の画像を “画像”、“イメージ” など画像であることを読み上げるモードがある場合も OK と判断するが、テキストモードや全文読みモードなどで読み上げられる場合は NG と判断

# 関連する要素や属性
img 要素 , alt 属性


img 要素 , alt 属性
18 changes: 14 additions & 4 deletions WAIC-TEST/HTML/WAIC-TEST-0002-01.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,29 @@


# テスト ID

WAIC-TEST-0002-01

# テストのタイトル

同じリンクの中に入れた画像 (代替テキストあり) とテキスト (1. 画像 2. テキスト)

# テストの目的

画像 (代替テキストあり) とテキストを 1. 画像 2. テキスト の順で同じリンクの中に入れた場合、代替テキストとリンクテキストが表示・読み上げされるかの確認

# テストの対象となる達成基準 (複数)

1.1.1, 2.4.4, 2.4.9

# 関連する達成方法 (複数)

H2

# テストコード (テストファイルへのリンク)

[WAIC-CODE-0002-01](https://waic.github.io/as_test/WAIC-CODE/WAIC-CODE-0002-01.html)

# テストコードのソース (抜粋)

```html
<div>
<a href="http://waic.jp/">
Expand All @@ -28,19 +33,25 @@ H2
</div>

```

# テスト手順 (視覚閲覧環境)

表示 : ブラウザの設定を変更して画像非表示にし、表示内容を確認

# 期待される結果 (視覚閲覧環境)

アイコン画像の代わりに、代替テキスト “ウェブアクセシビリティ基盤委員会” が表示される

# テスト実施時の注意点 (視覚閲覧環境)

なし

# テスト手順 (音声閲覧環境)

リンクを読み上げ、内容を確認

# 期待される結果 (音声閲覧環境)

アイコン画像の代替テキストとリンクテキストが続けて “ウェブアクセシビリティ基盤委員会 公式サイト” と読み上げられる

# テスト実施時の注意点 (音声閲覧環境)
Expand All @@ -49,6 +60,5 @@ H2
- リンクが 2 つに分かれていると誤解するような読み上げはNGと判断

# 関連する要素や属性
a 要素 , img 要素 , alt 属性


a 要素 , img 要素 , alt 属性
19 changes: 15 additions & 4 deletions WAIC-TEST/HTML/WAIC-TEST-0002-02.md
Original file line number Diff line number Diff line change
@@ -1,50 +1,61 @@


# テスト ID

WAIC-TEST-0002-02

# テストのタイトル

同じリンクの中に入れた画像 (代替テキストあり) とテキスト (1. テキスト 2. 画像)

# テストの目的

画像 (代替テキストあり) とテキストを 1. テキスト 2. 画像 の順で同じリンクの中に入れた場合、代替テキストとリンクテキストが表示・読み上げされるかの確認

# テストの対象となる達成基準 (複数)

1.1.1, 2.4.4, 2.4.9

# 関連する達成方法 (複数)

H30

# テストコード (テストファイルへのリンク)

[WAIC-CODE-0002-02](https://waic.github.io/as_test/WAIC-CODE/WAIC-CODE-0002-02.html)

# テストコードのソース (抜粋)

```html
<div>
<a href="./inc/pdf/WAIC-CODE-0002-02-ref1.pdf">施設ご利用の手引き<img src="img/WAIC-CODE-0002-02.gif" alt="PDFファイル" width="50" height="26"></a>
</div>

```

# テスト手順 (視覚閲覧環境)

表示 : ブラウザの設定を変更して画像非表示にし、表示内容を確認

# 期待される結果 (視覚閲覧環境)

リンクテキスト “施設ご利用の手引き” に続き、アイコン画像の代替テキスト “PDF ファイル” が表示される

# テスト実施時の注意点 (視覚閲覧環境)

なし

# テスト手順 (音声閲覧環境)

リンクを読み上げ、内容を確認

# 期待される結果 (音声閲覧環境)

リンクテキストとアイコン画像の代替テキストが続けて “施設ご利用の手引き PDFファイル” と読み上げられる

# テスト実施時の注意点 (音声閲覧環境)

- 代替テキストの内容に加えて “画像”、“イメージ” など画像であることを読み上げるモードがある場合も OK と判断
- リンクが 2 つに分かれていると誤解するような読み上げはNGと判断

# 関連する要素や属性
a 要素 , img 要素 , alt 属性


a 要素 , img 要素 , alt 属性
Loading

0 comments on commit 62f67d5

Please sign in to comment.