diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index c36d550b..53a378a0 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -153,6 +153,11 @@ jobs: aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} aws-region: ap-northeast-1 + - name: install ja_JP.UTF-8 locale + run: | + sudo locale-gen ja_JP.UTF-8 + sudo update-locale LANG=ja_JP.UTF-8 + - name: Install the Latest pip run: python -m pip install --upgrade pip diff --git a/data/yaml/faq/p0006.yaml b/data/yaml/faq/p0006.yaml new file mode 100644 index 00000000..f8482600 --- /dev/null +++ b/data/yaml/faq/p0006.yaml @@ -0,0 +1,45 @@ +id: p0006 +sortKey: 70010 +updated: '2024-05-07' +tags: +- screen-reader +title: + ja: スラッシュ（/）を含む数字はどのように読み上げられるべきか + en: How Should Numbers Containing a Slash (/) Be Read Aloud? +problem: + ja: |- + 例えば "11/12" という数字について、11月12日なのか、全12ページ中の11ページ目なのか、12分の11なのかが分かるようにスクリーン・リーダーが読み上げるようにしたい。 + en: |- + For instance, with the number "11/12", it should be clear from the screen reader's pronunciation whether it denotes November 12th, page 11 of 12, or 11 out of 12. +solution: + ja: |- + * 「11スラッシュ12」と読み上げられれば、対処は不要 + * 想定している環境でそれ以外の読み上げられ方をする場合には、何らかの対処を検討する + en: |- + * If pronounced "11 slash 12", no further action is required. + * If it is pronounced differently in the intended environment, consider implementing a remedy. +explanation: + ja: |- + 表示通り、「11スラッシュ12」と読み上げられれば、それがその文脈において何を意味するかはユーザーが判断できるはずですので、特に対処の必要はありません。 + もし表示通りに読み上げられても判断することが難しい可能性があると感じる場合、それは画面表示を見ているユーザーにとっても判断が難しい可能性がありますから、そもそもそのような表記が妥当なのかを検討する必要があるでしょう。 + + ただし、スクリーン・リーダーによっては、「11月12日」や「12分の11」などと読み上げるものもあります。 + 主に想定する環境においてこのような読み上げがされる場合、ユーザーが混乱する可能性があるため、何らかの対処を検討することが望ましいでしょう。 + + 以下に対処方法の例をいくつか示します。 + + * 「11 / 12」のようにスペースを入れることで、「11スラッシュ12」と読み上げられるようにする + * 「11月12日」など、読み上げられるべき形で表記する。この際画面に表示される文字列と読み上げられる文字列はなるべく一致させる。 + en: |- + If pronounced exactly as "11 slash 12", users should be able to discern its significance in the context, thus requiring no specific action. + However, if it remains challenging to interpret even when read correctly, it might also be difficult for those viewing the screen to understand, necessitating a reevaluation of the notation used. + + Note that some screen readers may read it aloud as "November 12th" or "eleven twelfths". + If this occurs in your primary environments, it could confuse users, prompting the need for a corrective measure. + + Below are some strategies to address this: + + * Add spaces around the slash in "11 / 12" to ensure it is read as "11 slash 12". + * Display it in a format conducive to the intended reading, like "November 12th". Aim to align the displayed text with the spoken text as closely as possible. +faqs: +- p0001 diff --git a/en/source/checks/checksheet.rst b/en/source/checks/checksheet.rst index eff7f6ae..686d0ded 100644 --- a/en/source/checks/checksheet.rst +++ b/en/source/checks/checksheet.rst @@ -1,370 +1,49 @@ .. _checks-checksheet: -#################################### -チェック実施用Googleスプレッドシート -#################################### +######################################## +Google Spreadsheet for Performing Checks +######################################## -各チェック内容ごとの情報をまとめたGoogleスプレッドシートを公開しています。 +A Google Spreadsheet that contains information for each check item is available. -- `アクセシビリティー・チェック・リスト一般公開用 `__ +- `Accessibility Check List for General Publication `__ -Google Drive上でこのスプレッドシートのコピーを作成してご利用ください。 +Note that the file includes both the Japanese and the English sheets. + +Please create a copy of this spreadsheet on Google Drive for your use. .. _checksheet-semver: -************************************************************ -アクセシビリティー・チェック・リストのバージョン番号について -************************************************************ +******************************************************** +About the Version Number of the Accessibility Check List +******************************************************** -アクセシビリティー・チェック・リストには便宜上バージョン番号を記載しています。 -本稿執筆時点の最新版では、一枚目のシートのセルA10に記載しています。 +For convenience, version numbers are provided for the accessibility check list. +As of the time of writing this document, the version is noted in cell A10 of the first sheet. -V3.0.0以降、バージョン番号は、メジャー・バージョン番号、マイナー・バージョン番号、リビジョン番号の3つの数字をピリオド（.）で区切って記しています。 -例えば、バージョン番号が3.0.1の場合、メジャー・バージョン番号が3、マイナー・バージョン番号が0、リビジョン番号が1です。 +Starting from V3.0.0, version numbers consist of three digits separated by periods (.): major version number, minor version number, and revision number. +For example, if the version number is 3.0.1, the major version number is 3, the minor version number is 0, and the revision number is 1. -それぞれの番号は、以下に示す方針で更新しています。 +Each number is updated according to the following guidelines: -メジャー・バージョン - チェック・リストの構成の変更など、大幅な変更を伴う場合 -マイナー・バージョン - チェック内容の追加、削除や、意図の変更を伴う既存のチェック内容の変更がある場合 -リビジョン - 誤字修正や意図の変更を伴わない文言の変更など、チェックの結果に影響を及ぼさない変更のみの場合 +Major Version + In case of significant changes, such as changes in the structure of the check list. +Minor Version + In case of additions, deletions, or changes in the intent of existing check items. +Revision + In case of changes that do not affect the results of the check, such as typo corrections or changes in wording without changes in intent. .. _checksheet-history: -******************************************** -アクセシビリティー・チェック・リスト更新履歴 -******************************************** - -V4.3.7 (2024年2月15日) -====================== - -* プロダクト：Web以外のチェックシートの英語版を追加 -* 一部、意図が明確になるように文言を修正 -* 誤字修正 - -V4.3.6 (2024年2月13日) -====================== - -* :ref:`check-0361` の文言を変更し、タッチUIにも言及 - -V4.3.5 (2024年2月6日) -===================== - -* :ref:`check-0361` の文言変更 -* 誤字修正 - -V4.3.4 (2024年1月15日) -====================== - -* 全体的に「ホバー」を「マウスオーバー」に変更 -* ガイドライン項目のタイトルを英訳し、英語版チェックシートに反映 - -V4.3.3 (2023年12月11日) -======================= - -* 誤字修正 - -V4.3.2 (2023年11月27日) -======================= - -* macOS VoiceOverによるチェック方法の例を追加： :ref:`check-0411` 、 :ref:`check-0413` 、 :ref:`check-0441` 、 :ref:`check-0471` 、 :ref:`check-0531` 、 :ref:`check-0561` 、 :ref:`check-0681` 、 :ref:`check-0711` 、 :ref:`check-0801` 、 :ref:`check-0861` 、 :ref:`check-0951` - -V4.3.1 (2023年10月13日) -======================= - -* 動的コンテンツにおける「スクロール」を「自動スクロール」に文言変更： :ref:`check-1201` 、 :ref:`check-1221` - -V4.3.0 (2023年9月26日) -====================== - -* チェックID：0991を :ref:`check-0961` に統合 -* チェックID：1151を :ref:`check-1321` に統合 - -V4.2.0 (2023年8月8日) -===================== - -* フォームのラベルに関するチェックについて、重篤度を[MAJOR]に変更: :ref:`check-0931` 、　:ref:`check-0941` 、　:ref:`check-0951` -* フォーム: :ref:`gl-form-keyboard-operable` の追加に伴って、対応するチェック内容を追加: :ref:`check-0956` 、　:ref:`check-0957` -* :ref:`check-0441` で、画像を説明するテキストの内容の適切さについても確認する必要があることを明記 -* axe DevToolsによるチェック方法の例を追加: :ref:`check-0411` -* axe DevToolsによるチェック方法の例を更新: :ref:`check-0951` - -V4.1.0 (2023年7月20日) -====================== - -* コントラスト比関連のガイドラインでの基準変更に伴う変更： :ref:`check-0001` 、 :ref:`check-0002` 、 :ref:`check-0021` - - - コントラスト比要件が3:1以上の場合の文字サイズについて、ピクセル単位での記述を修正 - - [SHOULD]の要件を削除 - -* コントラスト比関連のガイドラインについて、モバイル対象のものを新設したことに伴い、 :ref:`check-0002` の対象プラットフォームをWebのみとし、 :ref:`check-0003` を追加 - -V4.0.0 (2023年6月16日) -====================== - -* 対象が「プロダクト」のシートについて、チェック手順の例も合わせて掲載するように構成を変更 -* 対象が「プロダクト」のチェック内容について、全体的に文言の見直しを実施（チェック結果に影響しない変更のみ） - -V3.5.6 (2023年3月20日) -====================== - -* :ref:`check-0562` の誤字修正とマークアップの修正 - -V3.5.5 (2023年3月6日) -===================== - -* :ref:`check-0032` の意図が明確になるように文言変更。 -* :ref:`check-0922` - - - 文言を一部変更 - - 英訳を追加 - - -V3.5.4 (2023年2月20日) -====================== - -* 誤字修正 -* 一部マークアップの修正 - -V3.5.3 (2023年1月27日) -====================== - -* :ref:`check-0561` の意図が明確になるように文言変更。 -* :ref:`check-0771` の重篤度を[NORMAL]に変更 -* :ref:`check-0922` について、NVDAを用いたチェック実施方法の例を追加 -* プロダクト：Webのチェックシートの英語版を追加 - -V3.5.2 (2022年10月11日) -======================= - -* Ver. 202209.0での :ref:`gl-text-customize` の修正に合わせて、 :ref:`check-0891` を修正 -* テキストの拡大に関連するガイドラインの文言修正に伴う修正： :ref:`check-0321` 、 :ref:`check-0322` 、 :ref:`check-0323` 、 :ref:`check-0324` -* :ref:`check-0201` の意図を明確にするための文言修正と、チェック方法の例の改善 -* その他、意図を明確にするための文言の修正： :ref:`check-0171` 、 :ref:`check-0531` 、 :ref:`check-1251` - -V3.5.1 (2022年9月22日) -====================== - -* :ref:`check-0621` の意図が明確になるように文言修正 - -V3.5.0 (2022年9月6日) -===================== - -* 見出し関連のチェックの見直し - - - :ref:`check-0543` を追加 - - :ref:`check-0551` にAndroidにおける見出しの実装方法例を追加 - -* 手話に関連するチェックの重篤度を[MINOR]に変更： :ref:`check-1601` 、 :ref:`check-1621` -* :ref:`check-0951` のaxe DevToolsによるチェック方法に加筆 -* モバイル・アプリケーションの観点からのガイドライン見直しに伴う変更 - - - :ref:`check-0153` を追加 - - :ref:`check-0326` を追加 - - :ref:`check-0331` の文言を見直し、対象プラットフォームからモバイルを削除 - - :ref:`check-0332` の文言を見直し、対象プラットフォームからモバイルを削除 - - :ref:`check-0333` を追加 - - :ref:`check-0334` を追加 - - :ref:`check-0351` の文言を見直し、対象プラットフォームからモバイルを削除 - - :ref:`check-0352` の文言を見直し、対象プラットフォームからモバイルを削除 - - :ref:`check-0361` の文言を見直し、対象プラットフォームからモバイルを削除 - - :ref:`check-0362` を追加 - - :ref:`check-0371` の文言を見直し、対象プラットフォームからWebを削除 - - :ref:`check-0542` の対象プラットフォームからモバイルを削除 - - :ref:`check-0554` を追加 - - :ref:`check-0586` の文言の見直し - - :ref:`check-0621` の対象プラットフォームからモバイルを削除 - - :ref:`check-0631` の対象プラットフォームからモバイルを削除 - - :ref:`check-0851` の対象プラットフォームからモバイルを削除 - - :ref:`check-0912` を追加 - - :ref:`check-0921` の対象プラットフォームからモバイルを削除 - - :ref:`check-0922` を追加 - - -V3.4.0 (2022年3月29日) -====================== - -* モーダル・ダイアログに関連するチェックの見直し - - - :ref:`check-1291` 、 :ref:`check-1311` からモーダル・ダイアログに関する記述を削除 - - 新たに :ref:`check-1292` 、 :ref:`check-1312` 、 :ref:`check-1313` を追加 - -* :ref:`check-0081` の意図が明確になるように文言修正 -* :ref:`check-0811` に例外があることを明示。 -* :ref:`check-0413` のiOS VoiceOverとAndroid TalkBackによる確認方法の文言修正と、NVDAによる確認方法の追加 -* :ref:`check-0621` に、axe-DevToolsによる確認方法を追加 - -V3.3.0 (2022年2月18日) -====================== - -* :ref:`check-0553` を追加 - -V3.2.1 (2022年1月20日) -====================== - -* :ref:`check-0682` について、axe DevToolsを用いたチェック方法を追加 - -V3.2.0 (2022年1月11日) -====================== - -* :ref:`check-0682` を追加 -* 対象がデザインのチェック内容について、全般的に文言見直し - - -V3.1.0 (2022年1月4日) -===================== - -* クリック/タッチのターゲット・サイズに関するチェックの変更 - - - アイコンに関するものとフォーム・コントロールに関するものを分離： :ref:`check-0331` 、 :ref:`check-0351` を修正し、 :ref:`check-0332` 、 :ref:`check-0352` を追加 - - デザイン時のチェックで、クリック/タッチを受け付ける領域が設計資料に明示されていることを確認する必要があることを明記： :ref:`check-0331` 、 :ref:`check-0332` - - -V3.0.2 (2021年11月19日) -======================= - -* ガイドライン Ver. 202111.0 の変更を反映する調整 - -V3.0.1 (2021年10月11日) -======================= - -* 一時削除していた社内デザイン・システムVibesのコントラスト表のリンクを再掲 -* 誤字修正 -* チェックリストから更新履歴を削除して、このページへのリンクを掲載 - -V3.0.0 (2021年10月7日) -====================== - -* モバイル・アプリケーションを対象にしたチェックを追加し、全体的に見直しを実施 - -V2.2 (2021年7月8日) -=================== - -* Vibesのコントラスト表へのリンクを新ブランディング対応後のものに更新 - -V2.1 (2021年7月6日) -=================== - -* 文言修正： :ref:`check-0201` - -V2.0 (2021年5月24日) -==================== - -* QA時の判断基準として、「重篤度」を追加。各重篤度の定義は以下の通り： - - - [CRITICAL]: 操作不能になる人がいる - - [MAJOR]: 操作/情報取得が著しく難しくなる人がいる - - [NORMAL]: 不便を感じる人が少なからずいる - - [MINOR]: 問題はあるが影響は小さい - -V1.11 (2021年3月23日) -===================== - -* コントラストに関するチェックについて、テキスト情報とそれ以外に分離し、対象がプロダクトの場合はテキストのみを対象とするように変更 - - - チェックID：0001を :ref:`check-0001` と :ref:`check-0002` に分離 - - :ref:`check-0021` を変更 - -V1.10 (2021年2月25日) -===================== - -* 見出しとテーブルに関するチェックを追加： - - - :ref:`check-0561` - - :ref:`check-0562` - -* :ref:`check-0561` と内容が重なるチェックID：0741を削除 - -V1.9.1 (2021年2月10日) -====================== - -* 文言変更： :ref:`check-0441` - -V1.9 (2021年1月28日) -==================== - -* ホバーに関するガイドラインの分割に伴う変更 - - - :ref:`check-0091` と :ref:`check-0111` を変更 - - :ref:`check-0092` と :ref:`check-0112` を新設 - -V1.8.2 (2021年1月26日) -====================== - -* 文言変更： - - - :ref:`check-0322` - - :ref:`check-1171` - - :ref:`check-1291` - - :ref:`check-1311` - -V1.8.1 (2020年11月27日) -======================= - -* 具体的な数値を名気する形に文言変更： :ref:`check-0331` 、 :ref:`check-0351` - -V1.8 (2020年11月26日) -===================== - -* ガイドラインの優先度変更を反映： :ref:`check-0141` （[SHOULD]→[MUST]） - -V1.7 (2020年11月25日) -===================== - -* 音声解説に関するガイドライン（[SHOULD]）の追加に伴い、チェックを追加： :ref:`check-1562` -* 文言変更： :ref:`check-0681` - -V1.6 (2020年11月9日) -==================== - -* 画像化されたテキストに関するガイドラインの見直しに伴い、優先度と対応するWCAG SCを変更： :ref:`check-0481` 、 :ref:`check-0501` - -V1.5 (2020年11月6日) -==================== - -* 対象が「デザイン」の一部項目の文言変更（意図に変更無し）： - - - :ref:`check-0091` - - :ref:`check-0151` - - :ref:`check-0152` - - :ref:`check-0211` - - :ref:`check-0361` - - :ref:`check-0481` - - :ref:`check-1051` - -V1.4.1 (2020年10月28日) -======================= - -* ツール列のリンクを修正 - -V1.4 (2020年10月23日) -===================== - -* ツール列に、ガイドラインのチェック実施方法の例へのリンクを掲載 -* 文言修正： :ref:`check-0921` -* ページ全体の言語指定に関する、プロダクト対象のチェックを追加： :ref:`check-0621` - -V1.3 (2020年9月28日) -==================== - -* 拡大表示関連のガイドライン見直しに伴う変更 - - - 追加： :ref:`check-0311` 、 :ref:`check-0323` 、 :ref:`check-0324` - - 文言変更： :ref:`check-0321` 、 :ref:`check-0322` - -V1.2 (2020年8月28日) -==================== - -* 対象コンテンツの列を追加し、フィルター設定ダイアログを追加 +*************************************** +Accessibility Check List Update History +*************************************** -V1.1 -==== +Here, we list updates related to the English translation since the introduction of V4.3.7, when we began providing translations for all sheets. +For the changes to the original Japanese version, please refer to the `Japanese version of this page `__. -* IDの整理 +V4.3.7 (February 15, 2024) +========================== -V1.0 -==== +* Added English translations for all sheets. -初版 diff --git a/en/source/explanations/check-contrast.rst b/en/source/explanations/check-contrast.rst index 345b7480..7912d264 100644 --- a/en/source/explanations/check-contrast.rst +++ b/en/source/explanations/check-contrast.rst @@ -1,61 +1,107 @@ .. _exp-check-contrast: -############################ -コントラスト比のチェック方法 -############################ +################################## +Method for Checking Contrast Ratio +################################## -ロービジョン者でもコンテンツを知覚できるよう、テキストやUIコンポーネントにはそれぞれコントラスト比の基準を満たす色が使われることが求められます。 +In both Web and mobile applications, it is crucial to use color combinations that meet the contrast ratio criteria for text and UI components to ensure that content is perceivable by people with low vision. -実際のWebページから色のコントラスト比が不足している場所を発見するには `axe DevTools `__ のようなチェックツールを使用し、 -具体的な色同士のコントラスト比の計算には `WebAIM: Contrast Checker `__ のような計算ツールを使用します。 +To identify areas on a Web page where the color contrast ratio is insufficient, it is recommended to use checking tools such as `axe DevTools`_. +If check tools as such are not available, such as when checking mobile application screens, using tools that calculate the contrast ratio between specific colors, such as `WebAIM: Contrast Checker`_, in combination with a color picker, would be beneficial. -**************************************** -アクセシビリティー・チェックツールの使用 -**************************************** +******************************* +Using Accessibility Check Tools +******************************* -`axe DevTools `__ を使用すると、Webページ全体から（コントラスト比以外にも）アクセシビリティー上の問題のある場所を発見することができます。 +In Google Chrome, you can check for accessibility issues, including color contrast ratio problems, using the Lighthouse tab in the developer tools. -Google Chromeの場合、開発者ツールの Audits タブに Lighthouse が搭載されていますが、これで採点できるもののうち、 Accessbility については axe DevToolsが使用されています。 -また、 `axe DevToolsのGoogle Chrome 拡張 `__ を使用すると、結果を日本語で読むこともできます。 +Additionally, with `axe DevTools`_, you can identify areas with accessibility issues, including contrast ratio problems, across the entire Web page. +axe DevTools is available as a `Google Chrome extension`_ and a `Mozilla Firefox add-on`_. -コントラスト比の自動判定ができない場合 -====================================== +*********************************************************** +When Automatic Contrast Ratio Detection Cannot Be Performed +*********************************************************** -画像の中の文字など、これらのチェック・ツールではコントラスト比を正しく判定できない場合があります。 +These tools may not provide accurate contrast ratio assessments in cases such as for text within images. -axe DevToolsのGoogle Chrome拡張の場合、コントラスト比の判定ができない場合も「要素には十分な色のコントラストがなければなりません」のような、コントラスト比が不充分な場合と同じメッセージが表示されます。 -しかし自動判定ができない場合は、詳細パネルに「This potential issue needs your review... コントラスト比を判定できません」といったメッセージが表示されます。 +For the axe DevTools Chrome extension, if the contrast ratio cannot be determined, the message "Elements must have sufficient color contrast" will be displayed, just as when the contrast ratio is insufficient. +However, if automatic detection fails, the detailed panel will display a message such as "This potential issue needs your review... Cannot determine the contrast ratio." -このような場合は、当該箇所のカラー・コードを調べて、以下に示すツールを使ってコントラスト比を確認します。 +Additionally, axe DevTools can only be used for checking web pages and cannot be used for checking screens of mobile applications. +In such cases, it is necessary to examine the color codes of the specific areas and manually check the contrast ratio. -******************************** -コントラスト比の計算ツールの使用 -******************************** +Checking Screens of Mobile Applications +======================================= -コントラスト比の計算式は非常に複雑であるため、 `WebAIM: Contrast Checker `__ のような計算ツールを使用することが一般的です。 -`contrast.app `__ のように、インストールして常駐させるタイプのチェッカーも存在します。 +The followings are a few examples of how you might conduct checks on screens of mobile applications. -このようなコントラスト比計算ツールを使用する場合は以下の点に注意が必要です。 +* Take screenshots and check the images on a PC. +* Share the screen using online meeting tools such as Google Meet and check the shared screen on a PC. + Exercise caution when using this method, as some online meeting tools may apply color correction to the shared screen. -* コントラスト比の計算ツールによって小数点以下の丸め方に差異があり、計算結果がバラつくことがある。 +Examining Color Codes +===================== - - 計算結果は目安として、コントラスト比に余裕のある色を選ぶのが望ましい。 +Using a tool called a color picker, you can examine the color codes used in specific areas where contrast ratio checks are required. -* カラーピッカーを使用する場合、macOSではディスプレイのカラープロファイルの影響を受けることがあるため、これを防ぐ必要がある。 +Although WebAIM: Contrast Checker described below provides a color picker, there are also tools available for Windows and macOS. +Here are some popular ones: - - `macOSのカラープロファイル設定 `__ で、「このディスプレイのプロファイルのみを表示」のチェックを外してから ``SRGB IEC61966-2.1`` を選択。 - - SketchではPreferences➝General➝Color Profileで「SRGB IEC61966-2.1」を選択。 +Windows +------- - 上記はデフォルト設定なので、既存のドキュメントのカラープロファイルは異なったままになっている可能性があります。ファイルのカラープロファイルを変えたい場合は :menuselection:`File --> Document Settings` から変更します。 +Color picker is provided as one of the features of Microsoft PowerToys. - - Adobe XDはOSの設定を引き継ぐので、カラープロファイルの設定を変更した場合は再起動。 +Microsoft PowerToys can be obtained from the Microsoft Store or GitHub: -**** -参考 -**** +* `Microsoft PowerToys (Microsoft Store)`_ +* `Microsoft PowerToys (GitHub)`_ + +Reference: `Microsoft PowerToys: Utilities to customize Windows`_ + +macOS +----- + +macOS comes with a built-in color picker called Digital Color Meter. + +Reference: `Digital Color Meter User Guide for Mac`_ + +When using the color picker on macOS, it may be influenced by the display's color profile. +To prevent this, deselect the "Show profiles for this display only" checkbox in macOS's color profile settings, then choose "SRGB IEC61966-2.1". + +Reference: `Change your Mac display’s color profile`_ + +In Figma, you can check the color profile applied to each file by selecting "File color profile" from the menu located at the top of the screen next to the file name. +If it's set to "sRGB" or "Same as preferred profile (sRGB)," there's no issue. + +Additionally, you can ensure that sRGB is selected for new file creation by changing it in Figma's preferences menu under ":menuselection:`Preferences --> Color profile...`" available from the menu icon in the top left corner of the Figma interface. + +Contrast Ratio Calculation Tools +================================ + +Because the formula for calculating contrast ratio is complex, it is common to use calculation tools such as `WebAIM: Contrast Checker`_. +There are also checker tools that can be installed and run persistently, such as `contrast.app`_. + +Note that there may be discrepancies in the rounding of decimal places among contrast ratio calculation tools, resulting in varied calculation results. +It's advisable to consider the results as approximate and opt for colors that provide a margin of contrast. + +********** +References +********** * :ref:`exp-contrast` * |Vibes Color Contrast| .. include:: /inc/info2gl/exp-check-contrast.rst + +.. _axe DevTools: https://www.deque.com/axe/ +.. _WebAIM\: Contrast Checker: https://webaim.org/resources/contrastchecker/ +.. _Google Chrome extension: https://chrome.google.com/webstore/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd +.. _Mozilla Firefox add-on: https://addons.mozilla.org/firefox/addon/axe-devtools/ +.. _contrast.app: https://usecontrast.com/ +.. _Change your Mac display’s color profile: https://support.apple.com/en-us/guide/mac-help/mchlf3ddc60d/mac +.. _Digital Color Meter User Guide for Mac: https://support.apple.com/en-us/guide/digital-color-meter/welcome/mac +.. _Microsoft PowerToys (Microsoft Store): https://apps.microsoft.com/detail/xp89dcgq3k6vld +.. _Microsoft PowerToys (GitHub): https://github.com/microsoft/PowerToys +.. _Microsoft PowerToys\: Utilities to customize Windows: https://learn.microsoft.com/en-us/windows/powertoys/ diff --git a/en/source/explanations/contrast.rst b/en/source/explanations/contrast.rst index 1f5f8d64..4c59f632 100644 --- a/en/source/explanations/contrast.rst +++ b/en/source/explanations/contrast.rst @@ -1,23 +1,23 @@ .. _exp-contrast: -########################## -コントラスト比確保の重要性 -########################## +############################ +Importance of Contrast Ratio +############################ -テキストや画像の表示色と背景色のコントラスト比が極端に低い状態は、視覚的にWebを利用している大半のユーザーにとって、そのコンテンツの利用を困難なものにします。 -ロービジョンのユーザーの中には、低いコントラスト比の影響をより強く受けるユーザーがいます。 +When the contrast ratio between the foreground color and the background color of text and images is extremely low, it makes the content difficult to use for the majority of users who access the Web visually. +Among users with low vision, some are particularly affected by low contrast ratios. -当ガイドラインでは、視覚的に提示される情報について、一定のコントラスト比を確保することを求めています。 -当ガイドラインで示している基準は、WCAG 2.1のレベルAAの達成基準で示されているものですが、当ガイドラインではレベルAに相当するものとしており、必ず順守する必要があります。 +In our guidelines, we require a certain level of contrast ratio for visually presented information. +The criteria we specify adhere to the success criteria of WCAG 2.1 at Level AA, although in our guidelines, we consider them as success criteria corresponding to Level A, and compliance is mandatory. -対象となるのは、テキストと画像の両方で、画像にはアイコンや画像化されたテキストも含まれます。 -テキストの場合、文字のサイズや書体によって基準が異なります。 +This applies to both text and images, including icons and images of text. +For text, the criteria vary depending on factors such as font size and typeface. -画像の場合、隣接領域とのコントラスト比も確保する必要があります。 +For images, it is also necessary to ensure a sufficient contrast ratio with adjacent areas. -**** -参考 -**** +********** +References +********** * :ref:`exp-check-contrast` * |Vibes Color Contrast| diff --git a/en/source/index.rst b/en/source/index.rst index 5b012624..ead7c441 100644 --- a/en/source/index.rst +++ b/en/source/index.rst @@ -2,7 +2,11 @@ freee Accessibility Guidelines ############################## -**This document is a work in progress and will be updated as needed to include additional reference information and to enhance its clarity and expression.** +**This document is a work in progress and will be updated as needed to include additional supplementary information and to enhance its clarity and expression.** + +This is an English translation of the freee Accessibility Guidelines. The original Japanese version is the authoritative version. In the event of any discrepancy between the English and Japanese versions, the Japanese version shall prevail. + +This translation is based on the following version of the freee Accessibility Guidelines: Release: |release| diff --git a/en/source/intro/ChangeLog/2020/202004.0.rst b/en/source/intro/ChangeLog/2020/202004.0.rst deleted file mode 100644 index c29591bb..00000000 --- a/en/source/intro/ChangeLog/2020/202004.0.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ver-202004-0: - -********************************************************************************************* -`Ver. 202004.0 (2020年4月30日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインを一般公開しました `_ - -* 初版公開 - diff --git a/en/source/intro/ChangeLog/2020/202005.0.rst b/en/source/intro/ChangeLog/2020/202005.0.rst deleted file mode 100644 index 62674d89..00000000 --- a/en/source/intro/ChangeLog/2020/202005.0.rst +++ /dev/null @@ -1,36 +0,0 @@ -.. _ver-202005-0: - -********************************************************************************************************************************* -`Ver. 202005.0 (2020年5月21日、Global Accessibility Awareness Day) `_ -********************************************************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202005.0を公開しました `_ - -* 一部文言を修正 -* 色に関するガイドラインについて、色弱者に加えて視覚障害者のアクセスに影響することを「意図」に明記 -* 参考情報の追加: - - - :ref:`exp-dynamic-content-auto-updated` - - :ref:`exp-form-labeling` - - :ref:`exp-color-only` - - :ref:`exp-form-dynamic-content` - - :ref:`exp-form-errors` - - :ref:`exp-target-size` - - :ref:`exp-iot-usage` - - :ref:`exp-iot-text-alternative` - - :ref:`exp-contrast` - - :ref:`exp-text-custom-css` - - :ref:`exp-keyboard-notrap` - - :ref:`exp-input-device-various` - - :ref:`exp-multimedia-perceivable` - - :ref:`exp-multimedia-autoplay` - - :ref:`exp-multimedia-content-access` - - :ref:`exp-tab-order-check` - -* 参考情報の更新: - - - :ref:`exp-markup-component` : AccessibleNameとroleについて加筆 - -* 誤字修正 -* CSSなど修正 - diff --git a/en/source/intro/ChangeLog/2020/202005.1.rst b/en/source/intro/ChangeLog/2020/202005.1.rst deleted file mode 100644 index effb6642..00000000 --- a/en/source/intro/ChangeLog/2020/202005.1.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. _ver-202005-1: - -********************************************************************************************* -`Ver. 202005.1 (2020年5月26日) `_ -********************************************************************************************* - -* `日本翻訳連盟 `_ が公開している `JTF日本語標準スタイルガイド(翻訳用） `_ に基づき表記揺れなど修正 -* 誤字修正 - diff --git a/en/source/intro/ChangeLog/2020/202006.0.rst b/en/source/intro/ChangeLog/2020/202006.0.rst deleted file mode 100644 index 9de68dba..00000000 --- a/en/source/intro/ChangeLog/2020/202006.0.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _ver-202006-0: - -********************************************************************************************* -`Ver. 202006.0 (2020年6月18日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202006.0を公開しました `_ - -* ガイドライン部分の文書構造を見直し -* :ref:`category-input-device` に関するガイドラインの構成を一部変更（内容に変更無し） -* コントラスト関連のガイドラインで、文字サイズの表記をpxとptを併記するように変更 -* :ref:`category-dynamic-content` に関するガイドラインにガイドラインを1項目追加： :ref:`[MUST]支援技術への適切な情報提供の維持 ` -* その他内容の変更を伴わないガイドライン文言の変更 -* 「チェック内容」と「チェック対象」を対にして表記するように変更 -* チェック内容の追加と文言変更 -* 「意図」について、一部内容の変更を伴わない文言変更と追記 - - diff --git a/en/source/intro/ChangeLog/2020/202007.0.rst b/en/source/intro/ChangeLog/2020/202007.0.rst deleted file mode 100644 index e0643dca..00000000 --- a/en/source/intro/ChangeLog/2020/202007.0.rst +++ /dev/null @@ -1,67 +0,0 @@ -.. _ver-202007-0: - -********************************************************************************************* -`Ver. 202007.0 (2020年7月10日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202007.0を公開しました `_ - -* 参考情報追加： :ref:`exp-screen-reader-check` -* 参考情報更新 - - - :ref:`exp-input-device-various`： :ref:`[MUST]ダウン・イベントをトリガーにしない` に関する説明で、クリック・イベントについての記述を追加 - -* 動的コンテンツの :ref:`[MUST]点滅、スクロールを伴うコンテンツ ` から「動きを伴うコンテンツ」の記述を削除し、音声・映像コンテンツにアニメーションや動画を対象とした新ガイドラインを追加： :ref:`[MUST]動きを伴うコンテンツ ` -* リンクのターゲット・サイズに関するガイドラインについて、テキスト・リンクについてはWCAGで例外とされているので、アイコンの場合の基準のみ記し、アイコンのカテゴリーに移動： :ref:`[SHOULD]十分な大きさのクリック/タッチのターゲット ` -* フォームのターゲット・サイズに関するガイドラインについて、アイコンと同じ基準を明記： :ref:`[SHOULD]十分な大きさのクリック/タッチのターゲット ` -* 入力ディバイスのガイドライン2項目をマージ： :ref:`[MUST]特定の入力ディバイスを前提としない ` - - マージ対象ガイドライン： - - [MUST] 入力ディバイスのサポート - OSがサポートしている入力ディバイスの使用を妨げない。 - [MUST] ユーザーの動きだけをトリガーにしない - 加速度センサー、モーション・キャプチャーなどを活用した、ユーザーの動きをトリガーにする機能は、他のインターフェースによっても実行できるようにする。 - -* ガイドラインの文言を一部変更（下表参照） - -.. list-table:: Ver. 202007.0でのガイドライン文言変更箇所 - :header-rows: 1 - - * - 該当箇所 - - 変更前 - - 変更後 - - 補足 - * - ページ全体： :ref:`[SHOULD]適切なセクション分けと見出しの付与 ` - - ``h?`` 要素を使って適切に見出しを付ける。 - - コンテンツを適切にセクション分けし、 ``h?`` 要素を使って見出しを付ける。 - - 意図が明確になるように同ガイドラインの見出しも変更しています。 - * - 入力ディバイス： :ref:`[MUST]ダウン・イベントをトリガーにしない ` - - 操作の実行、完了のトリガーにはダウン・イベントを使わず、アップ・イベントを使う。 - - クリックやタップで実行される機能の実行、完了のトリガーには、ダウン・イベントを使わず、アップ・イベントやクリック・イベントを使い、誤った操作を中断できるようにする。 - - 意図の項にも追記して、ドラッグ&ドロップがこのガイドラインに抵触しないことを明示しています。 - * - テキスト： :ref:`[MUST]適切な文言の見出し ` - - 主題又は目的を説明する見出しおよびラベルを付ける。 - - 主題又は目的を説明する見出しを付ける。 - - 「ラベル」はフォーム・コントロールと画像の説明を意図したものでしたが、これらはそれぞれ別カテゴリーでカバーされているため削除しました。併せて見出しも変更しています。 - * - テキスト： :ref:`[MUST]複数の視覚的要素を用いた表現 ` - - 文字色に何らかの意味を持たせている場合、書体など他の視覚的な要素も併せて用い、色が判別できなくてもその意味を理解できるようにする。 - - 強調、引用など、何らかの意図を文字色を変えることによって表現している場合、書体など他の視覚的な要素も併せて用い、色が判別できなくてもその意味を理解できるようにする。 - - ガイドラインの意図を考慮して、掲載セクションを変更しています。 - * - 音声・映像コンテンツ： :ref:`[MUST]書き起こしテキストの提供 ` - - テキストの代替情報ではない音声・映像コンテンツにおいて、映像がなく音声のみの収録済みコンテンツの場合は、書き起こしテキストを提供する。 - - テキストの代替情報ではない、映像がなく音声のみの収録済みコンテンツの場合は、書き起こしテキストを提供する。 - - - * - 動的コンテンツ： :ref:`[MUST]点滅、スクロールを伴うコンテンツ ` - - 自動的に開始し5秒以上継続する、点滅、スクロールまたは動きを伴うコンテンツを作らない。そのようなコンテンツを作る場合は、ユーザーが一時停止、停止、非表示にすることができるようにする。 - - 同じページ上に、自動的に開始し5秒以上継続する、点滅やスクロールを伴うコンテンツと、他のコンテンツを一緒に配置しない。そのようなコンテンツを作る場合は、ユーザーが一時停止、停止、または非表示にすることができるようにする。 - - - * - 動的コンテンツ： :ref:`[MUST]自動更新されるコンテンツ ` - - 自動的に内容が更新されるコンテンツを作らない。そのようなコンテンツを作る場合は、ユーザーが一時停止、停止、非表示にすることができるか、更新頻度を調整できるようにする。 - - 予め設定された間隔で自動的に内容が更新されたり非表示になったりするコンテンツを作らない。そのようなコンテンツを作る場合は、ユーザーが一時停止、停止、非表示にすることができるか、更新頻度を調整できるようにする。 - - - * - フォーム： :ref:`[SHOULD]誤操作の防止 ` - - 誤った操作が確定することでユーザーに不利益が生じる可能性がある機能については、取り消し、送信前の確認・修正、または送信時のエラー・チェックと修正を可能にする。 - - 法的行為、経済的取引、データの変更や削除を生じる機能については、取り消し、送信前の確認・修正、または送信時のエラー・チェックと修正を可能にする。 - - - diff --git a/en/source/intro/ChangeLog/2020/202008.0.rst b/en/source/intro/ChangeLog/2020/202008.0.rst deleted file mode 100644 index 493b8286..00000000 --- a/en/source/intro/ChangeLog/2020/202008.0.rst +++ /dev/null @@ -1,19 +0,0 @@ -.. _ver-202008-0: - -********************************************************************************************* -`Ver. 202008.0 (2020年8月21日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202008.0を公開しました `_ - -* チェック内容の見直し - - - チェック対象を「デザイン」、「コード」、「プロダクト」に変更 - - 全ガイドラインに対するチェック内容の見直しと整理 - - すべてのチェック内容をまとめた章を追加： :ref:`check-index` - -* 参考情報更新 - - - クリック/タッチ・ターゲットのサイズの確認方法についての記述を追加： :ref:`exp-target-size` - -* 誤字修正 diff --git a/en/source/intro/ChangeLog/2020/202009.0.rst b/en/source/intro/ChangeLog/2020/202009.0.rst deleted file mode 100644 index 1f808ae2..00000000 --- a/en/source/intro/ChangeLog/2020/202009.0.rst +++ /dev/null @@ -1,33 +0,0 @@ -.. _ver-202009-0: - -********************************************************************************************* -`Ver. 202009.0 (2020年9月29日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202009.0を公開しました `_ - -* テキストの拡大表示に関連するガイドライン、チェック内容、参考情報を更新 - - - 意図をより明確にするために、「200パーセントの拡大表示」を3ガイドラインに分割 - - 変更前 - * 200パーセントの拡大表示：[MUST]コンテンツや機能を損なうことなくブラウザーのズーム機能で200パーセントまで拡大できるようにする。 - 変更後 - * :ref:`[MUST]ズーム機能を用いた200パーセントの拡大表示 ` - * :ref:`[MUST]文字サイズ変更機能の使用 ` - * [SHOULD]文字サイズ変更機能による200パーセントの拡大表示 - - - 意図を明確にするために :ref:`[SHOULD]400パーセントの拡大表示 ` の文言を変更 - - 関連するチェック内容の変更と追加 - - - 変更： :ref:`check-0321` 、 :ref:`check-0322` - - 追加： :ref:`check-0311` 、 :ref:`check-0323` 、 :ref:`check-0324` - - - 関連する参考情報の更新： :ref:`exp-magnification` - -* その他参考情報の更新 - - - :ref:`exp-color-only` にカラー・ユニバーサル・デザインに関する記述を追加 - - :ref:`exp-screen-reader-check` にNVDAのスピーチビューアーに関する説明を追加 - -* 誤字修正 diff --git a/en/source/intro/ChangeLog/2020/202010.0.rst b/en/source/intro/ChangeLog/2020/202010.0.rst deleted file mode 100644 index edfceb77..00000000 --- a/en/source/intro/ChangeLog/2020/202010.0.rst +++ /dev/null @@ -1,35 +0,0 @@ -.. _ver-202010-0: - -********************************************************************************************** -`Ver. 202010.0 (2020年10月27日) `_ -********************************************************************************************** - -参考： `freeeアクセシビリティー・ガイドラインVer. 202010.0を公開しました `_ - -**注意** ：以下のチェック実施方法の例の追加に伴い、チェック内容の全項目一覧のURLが変更されています： - -旧： \https://a11y-guidelines.freee.co.jp/checks/index.html - -新： https://a11y-guidelines.freee.co.jp/checks/checklist.html - -* チェック内容の追加 - - - :ref:`check-0621` - -* いくつかのチェック内容について、チェックの実施方法を例として追加 - - - :ref:`check-example-nvda` - - :ref:`check-example-axe` - -* 参考情報の追加 - - - :ref:`exp-axe` - - :ref:`exp-link-text` - -* 参考情報の更新 - - - ARIAライブ・リージョンの実装例と実装時の注意点を追加： :ref:`exp-dynamic-content-status` - - ``lang`` 属性に関する具体的な説明を追加： :ref:`exp-text-lang` - - ナビゲーションの一貫性について加筆： :ref:`exp-page-navigation` - -* 誤字修正 diff --git a/en/source/intro/ChangeLog/2020/202011.0.rst b/en/source/intro/ChangeLog/2020/202011.0.rst deleted file mode 100644 index eaa0322f..00000000 --- a/en/source/intro/ChangeLog/2020/202011.0.rst +++ /dev/null @@ -1,25 +0,0 @@ -.. _ver-202011-0: - -********************************************************************************************** -`Ver. 202011.0 (2020年11月27日) `_ -********************************************************************************************** - -参考： `freeeアクセシビリティー・ガイドラインVer. 202011.0を公開しました `_ - -**注意** ：新たに追加されたガイドラインと、優先度が変更されたガイドラインがあります。 - -* WCAG 2.1の各達成基準と当ガイドラインの対応表を追加： `当ガイドラインの優先度とWCAG 2.1の適合レベル `_ -* WCAG 2.1の各達成基準の適合レベルと、当ガイドラインの優先度の関係に関する情報を追加： :ref:`info-priority-diff` -* 画像化されたテキストに関するガイドラインの見直し： :ref:`[SHOULD]画像化されたテキストを使用しない ` - - - 変更前：画像化されたテキストを用いていない、または用いられている画像化されたテキストがコントラスト比と代替情報に関するガイドラインを満たしている場合に[MUST]の条件を満たす - - 変更後：画像化されたテキストが用いられていない場合は[SHOULD]の条件を満たし、用いられている画像化されたテキストがコントラスト比と代替情報に関するガイドラインを満たしている場合は[MUST]の条件を満たす - -* テキストの代替の音声・映像コンテンツの音声解説に関するガイドラインを追加： :ref:`[SHOULD]音声解説の提供 ` - - - 対応するチェック内容を追加： :ref:`check-1562` - -* 入力ディバイス： :ref:`[MUST]ショートカット・キーを提供する場合 ` の優先度を[SHOULD]から[MUST]に変更 -* ARIAランドマークに関する用語の見直しと統一（内容に変更無し） -* 一部チェック内容について、文言の見直し（内容に変更無し） -* 誤字修正 diff --git a/en/source/intro/ChangeLog/2021/202101.0.rst b/en/source/intro/ChangeLog/2021/202101.0.rst deleted file mode 100644 index 76c041ef..00000000 --- a/en/source/intro/ChangeLog/2021/202101.0.rst +++ /dev/null @@ -1,13 +0,0 @@ -.. _ver-202101-0: - -******************************************************************************************** -`Ver. 202101.0 (2021年1月5日) `_ -******************************************************************************************** - -参考： `freeeアクセシビリティー・ガイドラインVer. 202101.0を公開しました `_ - -* 参考情報更新 - - - :ref:`exp-tab-order-check` に、キーボードのみを用いた操作が可能であることを確認する方法として、マウス・ポインターを非表示にする方法を追加 - -* 誤字修正 diff --git a/en/source/intro/ChangeLog/2021/202101.1.rst b/en/source/intro/ChangeLog/2021/202101.1.rst deleted file mode 100644 index dc78d49b..00000000 --- a/en/source/intro/ChangeLog/2021/202101.1.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _ver-202101-1: - -********************************************************************************************* -`Ver. 202101.1 (2021年1月20日) `_ -********************************************************************************************* - -* 参考情報更新 - - - :ref:`exp-text-custom-css` に掲載しているCSSおよびブックマークレットの修正 - -* 誤字修正 diff --git a/en/source/intro/ChangeLog/2021/202102.0.rst b/en/source/intro/ChangeLog/2021/202102.0.rst deleted file mode 100644 index 546f3f19..00000000 --- a/en/source/intro/ChangeLog/2021/202102.0.rst +++ /dev/null @@ -1,46 +0,0 @@ -.. _ver-202102-0: - -******************************************************************************************** -`Ver. 202102.0 (2021年2月2日) `_ -******************************************************************************************** - -参考： `freeeアクセシビリティー・ガイドラインVer. 202102.0を公開しました `_ - -**注意** ：分割されて一部優先度が変更されたガイドラインがあります。 - -* ホバーで表示されるコンテンツに関するガイドラインの見直し - - - 変更前：[SHOULD]ホバーで表示されるコンテンツ - - [SHOULD]ホバーで表示されるコンテンツについて、以下のすべてを満たす。 - - - ポインターを移動させることなく、ホバーで表示されたコンテンツを非表示にできる。（Escキーで消える、など） - - ポインターを、ホバーで表示されたコンテンツ上に移動しても、コンテンツが消えない。 - - ポインターを、ホバーで表示されたコンテンツ上に移動しても、コンテンツが消えない。 - - - 変更後：以下の2ガイドラインに分割 - - - :ref:`[MUST]ホバーで表示されるコンテンツの拡大 ` - - [MUST]ホバーで表示されるコンテンツについて、ポインターをホバーで表示されたコンテンツ上に移動しても、コンテンツが消えないようにすることで、そのコンテンツを拡大表示して利用することを可能にする。 - - - :ref:`[SHOULD]ホバーで表示されるコンテンツの非表示 ` - - [SHOULD]ホバーで表示されるコンテンツについて、以下のすべてを満たす。 - - - ポインターを移動させることなく、ホバーで表示されたコンテンツを非表示にできる。（Escキーで消える、など） - - ホバー状態ではなくなった場合、ユーザーが非表示にする操作を行った場合、内容が無効になった場合にのみ、ホバーで表示されたコンテンツを非表示にする。 - -* ホバーで表示されるコンテンツに関するガイドラインの変更に伴うチェック内容の変更 - - - 変更： :ref:`check-0091` 、 :ref:`check-0111` - - 追加： :ref:`check-0092` 、 :ref:`check-0112` - -* 意図の変更を伴わないチェック内容の文言変更 - - - :ref:`check-0322` - - :ref:`check-1171` - - :ref:`check-1291` - - :ref:`check-1311` - -* 誤字修正 diff --git a/en/source/intro/ChangeLog/2021/202103.0.rst b/en/source/intro/ChangeLog/2021/202103.0.rst deleted file mode 100644 index 672f5215..00000000 --- a/en/source/intro/ChangeLog/2021/202103.0.rst +++ /dev/null @@ -1,13 +0,0 @@ -.. _ver-202103-0: - -******************************************************************************************** -`Ver. 202103.0 (2021年3月1日) `_ -******************************************************************************************** - -* :ref:`[MUST]文書構造を適切にマークアップする ` に関連するチェック内容とそのチェック実施方法例を追加 - - * :ref:`check-0561` - * :ref:`check-0562` - -* 上記、チェックID: 0561と内容が重複するチェックID: 0741を削除 -* 意図の変更を伴わないチェック内容の文言変更： :ref:`check-0441` diff --git a/en/source/intro/ChangeLog/2021/202104.0.rst b/en/source/intro/ChangeLog/2021/202104.0.rst deleted file mode 100644 index 37d91c0f..00000000 --- a/en/source/intro/ChangeLog/2021/202104.0.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _ver-202104-0: - -******************************************************************************************** -`Ver. 202104.0 (2021年4月1日) `_ -******************************************************************************************** - -参考： `freeeアクセシビリティー・ガイドラインVer. 202104.0を公開しました `_ - -* axeがaxe DevToolsに改名されたことなどに対応して、表記や画面キャプチャーを更新 -* axe DevToolsのルールと当ガイドラインの対応情報を追加： :ref:`info-axe-rules` -* チェック内容をまとめたGoogleスプレッドシートに関する情報を追加： :ref:`checks-checksheet` -* コントラスト関連のチェックについて、テキスト情報とそれ以外のものを分離 -* コントラスト関連のガイドライン、参考情報、チェック内容の箇所に、社内デザイン・システムVibesのカラー・コントラスト表へのリンクを追加 - diff --git a/en/source/intro/ChangeLog/2021/202105.0.rst b/en/source/intro/ChangeLog/2021/202105.0.rst deleted file mode 100644 index f6ee55bf..00000000 --- a/en/source/intro/ChangeLog/2021/202105.0.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _ver-202105-0: - -******************************************************************************************** -`Ver. 202105.0 (2021年5月6日) `_ -******************************************************************************************** - -参考： `freeeアクセシビリティー・ガイドラインVer. 202105.0を公開しました `_ - -* 表示中のWebページをグレースケール表示にするブックマークレットを追加： :ref:`exp-grayscale` -* 誤字修正 - diff --git a/en/source/intro/ChangeLog/2021/202106.0.rst b/en/source/intro/ChangeLog/2021/202106.0.rst deleted file mode 100644 index 56b95dc1..00000000 --- a/en/source/intro/ChangeLog/2021/202106.0.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ver-202106-0: - -******************************************************************************************** -`Ver. 202106.0 (2021年6月1日) `_ -******************************************************************************************** - -* コントラスト比のチェック方法について加筆： :ref:`exp-check-contrast` -* NVDAチートシートの更新に合わせて、掲載している画像などを変更： :ref:`exp-screen-reader-check` -* :ref:`info-axe-rules` を最新のaxe-coreのソースに基づいた内容に更新 - diff --git a/en/source/intro/ChangeLog/2021/202107.0.rst b/en/source/intro/ChangeLog/2021/202107.0.rst deleted file mode 100644 index 82661c63..00000000 --- a/en/source/intro/ChangeLog/2021/202107.0.rst +++ /dev/null @@ -1,21 +0,0 @@ -.. _ver-202107-0: - -********************************************************************************************* -`Ver. 202107.0 (2021年7月12日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202107.0を公開しました `_ - -* ガイドラインの文言変更 - - - 入力ディバイス： :ref:`[MUST]キーボード・トラップの回避 ` - - ページ全体： :ref:`[MUST]画面方向を固定しない ` - -* チェック内容の文言変更： :ref:`check-0201` -* :ref:`info-axe-rules` を最新のaxe-coreのソースに基づいた内容に更新 -* freee株式会社のコーポレート・アイデンティティーの変更に対応 - - - ページ内のロゴを新しいものに変更 - - OGP用の画像を差し替え - - 社内デザイン・システムVibesのコントラスト比の表のURLを差し替え - diff --git a/en/source/intro/ChangeLog/2021/202110.0.rst b/en/source/intro/ChangeLog/2021/202110.0.rst deleted file mode 100644 index 2d8924af..00000000 --- a/en/source/intro/ChangeLog/2021/202110.0.rst +++ /dev/null @@ -1,25 +0,0 @@ -.. _ver-202110-0: - -********************************************************************************************* -`Ver. 202110.0 (2021年10月8日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202110.0を公開しました `_ - -* ガイドラインおよびチェック内容について、YAMLで記述して管理するように変更 -* チェック内容について、モバイル・アプリケーションについても適用できるように追加、修正 -* iOSに関する情報を追加 - - - iOS VoiceOverに関する情報： :ref:`exp-screen-reader-check-ios-voiceover` - - 拡大表示の方法： :ref:`exp-magnification` - - グレイスケール表示の方法： :ref:`exp-grayscale` - -* 各ガイドラインの構成を見直し（ガイドラインの内容には変更無し） -* 各チェック内容の構成の見直し - - - 重篤度の追加 - - 対象プラットフォームの追加 - -* ガイドラインおよびチェック内容の構成の見直しを反映する形で、当ガイドラインに関する説明を更新： :ref:`intro-intro` -* 当ガイドラインの活用方法に関する説明を追加： :ref:`intro-usage` -* :ref:`info-axe-rules` を最新のaxe-coreのソースに基づいた内容に更新 diff --git a/en/source/intro/ChangeLog/2021/202110.1.rst b/en/source/intro/ChangeLog/2021/202110.1.rst deleted file mode 100644 index 854f8632..00000000 --- a/en/source/intro/ChangeLog/2021/202110.1.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ver-202110-1: - -********************************************************************************************** -`Ver. 202110.1 (2021年10月11日) `_ -********************************************************************************************** - -* チェックリストに関する記述を現状に合わせて修正： :ref:`checks-checksheet` -* チェックリストの変更履歴を追加： :ref:`checksheet-history` -* 誤字修正 - diff --git a/en/source/intro/ChangeLog/2021/202110.2.rst b/en/source/intro/ChangeLog/2021/202110.2.rst deleted file mode 100644 index 981d71cd..00000000 --- a/en/source/intro/ChangeLog/2021/202110.2.rst +++ /dev/null @@ -1,8 +0,0 @@ -.. _ver-202110-2: - -********************************************************************************************** -`Ver. 202110.2 (2021年10月18日) `_ -********************************************************************************************** - -* :ref:`intro-contributing` を追加 - diff --git a/en/source/intro/ChangeLog/2021/202111.0.rst b/en/source/intro/ChangeLog/2021/202111.0.rst deleted file mode 100644 index 624fd5ee..00000000 --- a/en/source/intro/ChangeLog/2021/202111.0.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _ver-202111-0: - -********************************************************************************************** -`Ver. 202111.0 (2021年11月19日) `_ -********************************************************************************************** - -* :ref:`category-images-of-text` 中のガイドライン、「隣接領域とのコントラスト比の確保」を削除 -* Android TalkBackに関する情報を追加： :ref:`exp-screen-reader-check-android-talkback` -* これらの変更を反映する形でチェック内容を更新 -* ガイドラインの各カテゴリー・ページにページ内目次を追加 - diff --git a/en/source/intro/ChangeLog/2021/202112.0.rst b/en/source/intro/ChangeLog/2021/202112.0.rst deleted file mode 100644 index b0398be7..00000000 --- a/en/source/intro/ChangeLog/2021/202112.0.rst +++ /dev/null @@ -1,12 +0,0 @@ -.. _ver-202112-0: - -********************************************************************************************* -`Ver. 202112.0 (2021年12月3日) `_ -********************************************************************************************* - -* Androidでグレースケール表示をする方法を追加： :ref:`exp-grayscale` -* Androidで拡大表示をする方法を追加： :ref:`exp-magnification` -* 誤字修正 -* YAMLファイルの処理の改善 - - diff --git a/en/source/intro/ChangeLog/2022/202201.0.rst b/en/source/intro/ChangeLog/2022/202201.0.rst deleted file mode 100644 index 605ce841..00000000 --- a/en/source/intro/ChangeLog/2022/202201.0.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _ver-202201-0: - -********************************************************************************************* -`Ver. 202201.0 (2022年1月11日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202201.0を公開しました `_ - -* クリック/タッチのターゲット・サイズ関連の変更 - - - テキスト中のリンクは対象外であることが明確になるように文言を変更： アイコン： :ref:`[SHOULD]十分な大きさのクリック/タッチのターゲット ` - - ブラウザーのデフォルトから見た目を変更していないフォーム・コントロールは対象外であることが明確になるように文言を変更： フォーム： :ref:`[SHOULD]十分な大きさのクリック/タッチのターゲット ` 、 :ref:`exp-target-size` - - チェック内容を、アイコンに対するものとフォーム・コントロールに対するものに分離： - - - 修正： :ref:`check-0331` 、 :ref:`check-0351` - - 追加： :ref:`check-0332` 、 :ref:`check-0352` - - - 対象がデザインのチェック内容に、ターゲット領域が明示されている必要があることを明記： :ref:`check-0331` 、 :ref:`check-0332` - -* ARIAランドマーク関連の変更 - - - ARIAランドマークに関する確認方法を参考情報に追加： :ref:`exp-page-structure` - - ARIAランドマークに関するチェックを追加： :ref:`check-0682` - -* 対象がデザインのチェック内容について、全般的に文言を見直し -* Googleスプレッドシートにまとめて公開しているアクセシビリティー・チェック・リストのバージョン番号に関する説明を追加： :ref:`checksheet-semver` diff --git a/en/source/intro/ChangeLog/2022/202201.1.rst b/en/source/intro/ChangeLog/2022/202201.1.rst deleted file mode 100644 index 98ebd436..00000000 --- a/en/source/intro/ChangeLog/2022/202201.1.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. _ver-202201-1: - -********************************************************************************************* -`Ver. 202201.1 (2022年1月20日) `_ -********************************************************************************************* - -* ARIAランドマークに関するMDNの開設記事へのリンクを追加： :ref:`exp-page-structure` -* axe DevToolsを使ったARIAランドマークに関するチェックの実施方法を追加： :ref:`check-0682` - diff --git a/en/source/intro/ChangeLog/2022/202202.0.rst b/en/source/intro/ChangeLog/2022/202202.0.rst deleted file mode 100644 index 11db5c6f..00000000 --- a/en/source/intro/ChangeLog/2022/202202.0.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. _ver-202202-0: - -********************************************************************************************* -`Ver. 202202.0 (2022年2月18日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202202.0を公開しました `_ - -* 「マークアップ全般」カテゴリーを「マークアップと実装」に改名し、全体的に見直し - - - :ref:`[MUST]文書構造を適切にマークアップする ` について、スタティックなコンテンツを対象としていることが明確になるように文言を変更 - - :ref:`[MUST]対話的なUIコンポーネントの実装 ` と :ref:`check-0553` を追加 - - :ref:`[MUST]コンポーネントをアクセシブルにする ` の文言を変更 - - 関連して参考情報に加筆： :ref:`exp-markup-component` - -* ガイドラインおよびチェック内容のYAMLのスキーマ定義を、JSON Schemaで記述して追加 - diff --git a/en/source/intro/ChangeLog/2022/202203.0.rst b/en/source/intro/ChangeLog/2022/202203.0.rst deleted file mode 100644 index 52ef19a1..00000000 --- a/en/source/intro/ChangeLog/2022/202203.0.rst +++ /dev/null @@ -1,27 +0,0 @@ -.. _ver-202203-0: - -********************************************************************************************* -`Ver. 202203.0 (2022年3月29日) `_ -********************************************************************************************* - -* 動的コンテンツ： :ref:`[MUST]適切なDOMツリーを維持する ` の見直し - - - モバイル・アプリケーションへの適用を前提に、タイトルを「支援技術への適切な情報提供の維持」に変更し、文言を見直し - - WCAG 2.1の達成基準1.3.2に加えて、達成基準1.3.1との関連付けも追加 - -* モーダル・ダイアログに関連するチェック内容の見直し - - - :ref:`check-1291` 、 :ref:`check-1311` からモーダル・ダイアログに関する記述を削除 - - 新たに :ref:`check-1292` 、 :ref:`check-1312` 、 :ref:`check-1313` を追加 - -* チェック内容の文言見直し - - - :ref:`check-0811` に例外があることを明示。 - - :ref:`check-0081` の意図が明確になるように文言修正 - -* チェック内容の確認方法の例の見直し - - - :ref:`check-0413` のiOS VoiceOverとAndroid TalkBackによる確認方法の文言修正と、NVDAによる確認方法の追加 - - :ref:`check-0621` に、axe-DevToolsによる確認方法を追加 - -* :ref:`info-axe-rules` を最新のaxe-coreのソースに基づいた内容に更新 diff --git a/en/source/intro/ChangeLog/2022/202205.0.rst b/en/source/intro/ChangeLog/2022/202205.0.rst deleted file mode 100644 index fe358821..00000000 --- a/en/source/intro/ChangeLog/2022/202205.0.rst +++ /dev/null @@ -1,8 +0,0 @@ -.. _ver-202205-0: - -********************************************************************************************* -`Ver. 202205.0 (2022年5月10日) `_ -********************************************************************************************* - -* 誤字修正 - diff --git a/en/source/intro/ChangeLog/2022/202209.0.rst b/en/source/intro/ChangeLog/2022/202209.0.rst deleted file mode 100644 index 8bd34084..00000000 --- a/en/source/intro/ChangeLog/2022/202209.0.rst +++ /dev/null @@ -1,35 +0,0 @@ -.. _ver-202209-0: - -******************************************************************************************** -`Ver. 202209.0 (2022年9月6日) `_ -******************************************************************************************** - -参考： `freeeアクセシビリティー・ガイドラインVer. 202209.0を公開しました `_ - -* 各ガイドラインに「対象プラットフォーム」欄を追加 -* ガイドラインの優先度の記述箇所を変更 -* チェック内容の更新情報を分離して :ref:`checksheet-history` として掲載するように変更 -* テキスト： :ref:`gl-text-customize` の記述をWCAGが示す条件と一致するように変更し、関連する参考情報（ :ref:`exp-text-custom-css` ）に掲載しているブックマークレットを修正 -* モバイル・アプリケーションの観点からガイドラインとチェック内容を全体的に見直し - - - 意図の変更を伴わない文言変更： - - - マークアップと実装： :ref:`gl-markup-semantics` （タイトルのみ） - - ページ全体： :ref:`gl-page-headings` - - 入力ディバイス： :ref:`gl-input-device-focus` - - 入力ディバイス： :ref:`gl-input-device-use-up-event` - - 入力ディバイス： :ref:`gl-input-device-independent` - - アイコン： :ref:`gl-icon-target-size` - - フォーム： :ref:`gl-form-target-size` - - 動的コンテンツ： :ref:`gl-dynamic-content-status` - - - 追加： - - - 入力ディバイス： :ref:`gl-input-device-support-mobile-assistive-tech` - - テキスト： :ref:`gl-text-component-lang` - - テキスト： :ref:`gl-text-mobile-enlarge-settings` - - アイコン： :ref:`gl-icon-target-size-mobile` - - フォーム： :ref:`gl-form-target-size-mobile` - -* NVDAの設定に関して加筆： :ref:`exp-screen-reader-check-nvda` -* キーボードのみによる操作に関して加筆： :ref:`exp-tab-order-check` diff --git a/en/source/intro/ChangeLog/2022/202209.1.rst b/en/source/intro/ChangeLog/2022/202209.1.rst deleted file mode 100644 index ba4527da..00000000 --- a/en/source/intro/ChangeLog/2022/202209.1.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ver-202209-1: - -********************************************************************************************* -`Ver. 202209.1 (2022年9月22日) `_ -********************************************************************************************* - -* NVDAの多言語処理に関する項目の推奨設定を変更： :ref:`exp-screen-reader-check-nvda` -* 各ガイドラインの「チェック内容」の項と :ref:`check-index` の表示を変更 -* 誤字修正 - diff --git a/en/source/intro/ChangeLog/2022/202210.0.rst b/en/source/intro/ChangeLog/2022/202210.0.rst deleted file mode 100644 index 49cae144..00000000 --- a/en/source/intro/ChangeLog/2022/202210.0.rst +++ /dev/null @@ -1,15 +0,0 @@ -.. _ver-202210-0: - -********************************************************************************************** -`Ver. 202210.0 (2022年10月11日) `_ -********************************************************************************************** - -* テキストの拡大に関連するガイドラインについて、意図が明確になるように文言を修正 - - - :ref:`gl-text-zoom` - - :ref:`gl-text-enlarge-settings` - - :ref:`gl-text-mobile-enlarge-settings` - - 文字サイズの設定による200パーセントの拡大表示 - - :ref:`gl-text-zoom-reflow` - -* NVDAの初期設定に関する説明で、NVDA Version 2022.3jpにおけるNVDAメニューの構成変更を反映： :ref:`exp-screen-reader-check-nvda` diff --git a/en/source/intro/ChangeLog/2023/202301.0.rst b/en/source/intro/ChangeLog/2023/202301.0.rst deleted file mode 100644 index 64e7829d..00000000 --- a/en/source/intro/ChangeLog/2023/202301.0.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. _ver-202301-0: - -********************************************************************************************* -`Ver. 202301.0 (2023年1月27日) `_ -********************************************************************************************* - -* NVDAの初期設定に関する説明で、マウス追跡の推奨設定を追加： :ref:`exp-screen-reader-check-nvda` diff --git a/en/source/intro/ChangeLog/2023/202302.0.rst b/en/source/intro/ChangeLog/2023/202302.0.rst deleted file mode 100644 index 2fb64450..00000000 --- a/en/source/intro/ChangeLog/2023/202302.0.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ver-202302-0: - -********************************************************************************************* -`Ver. 202302.0 (2023年2月20日) `_ -********************************************************************************************* - -* アクセシビリティー・チェック・リストをV3.5.4に更新 -* ソースの管理やビルド方法に関する情報を加筆： :ref:`intro-contributing` -* カラーユニバーサルデザイン機構（CUDO）のサイト上のURLなどの変更に合わせてリンクを修正： :ref:`exp-color-only` - diff --git a/en/source/intro/ChangeLog/2023/202303.0.rst b/en/source/intro/ChangeLog/2023/202303.0.rst deleted file mode 100644 index f5fd3ca7..00000000 --- a/en/source/intro/ChangeLog/2023/202303.0.rst +++ /dev/null @@ -1,8 +0,0 @@ -.. _ver-202303-0: - -******************************************************************************************** -`Ver. 202303.0 (2023年3月6日) `_ -******************************************************************************************** - -* アクセシビリティー・チェック・リストをV3.5.5に更新 - diff --git a/en/source/intro/ChangeLog/2023/202303.1.rst b/en/source/intro/ChangeLog/2023/202303.1.rst deleted file mode 100644 index e762ca9c..00000000 --- a/en/source/intro/ChangeLog/2023/202303.1.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _ver-202303-1: - -********************************************************************************************* -`Ver. 202303.1 (2023年3月10日) `_ -********************************************************************************************* - -* 外部情報へのリンクのうち、Material Design関連以外のものについて、掲載URLが変更されたものを更新 -* HTMLファイルの生成に用いているSphinxの設定を見直し - - - diff --git a/en/source/intro/ChangeLog/2023/202303.2.rst b/en/source/intro/ChangeLog/2023/202303.2.rst deleted file mode 100644 index e65bef4c..00000000 --- a/en/source/intro/ChangeLog/2023/202303.2.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ver-202303-2: - -********************************************************************************************* -`Ver. 202303.2 (2023年3月20日) `_ -********************************************************************************************* - -* アクセシビリティー・チェック・リストをV3.5.6に更新 - - - diff --git a/en/source/intro/ChangeLog/2023/202304.0.rst b/en/source/intro/ChangeLog/2023/202304.0.rst deleted file mode 100644 index d5fecbff..00000000 --- a/en/source/intro/ChangeLog/2023/202304.0.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ver-202304-0: - -******************************************************************************************** -`Ver. 202304.0 (2023年4月7日) `_ -******************************************************************************************** - -* :ref:`exp-screen-reader-check-nvda` の内容を補足する動画を追加 - - - diff --git a/en/source/intro/ChangeLog/2023/202304.1.rst b/en/source/intro/ChangeLog/2023/202304.1.rst deleted file mode 100644 index 62519cdd..00000000 --- a/en/source/intro/ChangeLog/2023/202304.1.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ver-202304-1: - -********************************************************************************************* -`Ver. 202304.1 (2023年4月21日) `_ -********************************************************************************************* - -* Material Design関連のリンクを更新： :ref:`exp-screen-reader-check-android-talkback` -* :ref:`info-axe-rules` を最新のaxe-coreのソースに基づいた内容に更新 - - diff --git a/en/source/intro/ChangeLog/2023/202305.0.rst b/en/source/intro/ChangeLog/2023/202305.0.rst deleted file mode 100644 index f41fa677..00000000 --- a/en/source/intro/ChangeLog/2023/202305.0.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. _ver-202305-0: - -********************************************************************************************* -`Ver. 202305.0 (2023年5月23日) `_ -********************************************************************************************* - -* :ref:`exp-screen-reader-check-nvda` の更新 - - - 多言語関連のチェックを実施する際に必要となる、Windowsの設定について追記 - - NVDAチートシートの画像を最新版に更新 - - 入力ヘルプ機能に関する動画を追加 - -* :ref:`info-axe-rules` の更新 - - - メッセージの日本語、英語の表示順序を変更 - - axe-core最新版に基づいた内容に更新 - diff --git a/en/source/intro/ChangeLog/2023/202306.0.rst b/en/source/intro/ChangeLog/2023/202306.0.rst deleted file mode 100644 index 16e82cec..00000000 --- a/en/source/intro/ChangeLog/2023/202306.0.rst +++ /dev/null @@ -1,8 +0,0 @@ -.. _ver-202306-0: - -******************************************************************************************** -`Ver. 202306.0 (2023年6月8日) `_ -******************************************************************************************** - -* :ref:`exp-screen-reader-check-ios-voiceover` を最新のHuman Interface Guidelinesに合わせて更新 - diff --git a/en/source/intro/ChangeLog/2023/202306.1.rst b/en/source/intro/ChangeLog/2023/202306.1.rst deleted file mode 100644 index 7f77f1e9..00000000 --- a/en/source/intro/ChangeLog/2023/202306.1.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. _ver-202306-1: - -********************************************************************************************* -`Ver. 202306.1 (2023年6月16日) `_ -********************************************************************************************* - -* アクセシビリティー・チェック・リストをV4.0.0に更新 -* 一部マークアップの修正 - diff --git a/en/source/intro/ChangeLog/2023/202307.0.rst b/en/source/intro/ChangeLog/2023/202307.0.rst deleted file mode 100644 index 436e5465..00000000 --- a/en/source/intro/ChangeLog/2023/202307.0.rst +++ /dev/null @@ -1,39 +0,0 @@ -.. _ver-202307-0: - -********************************************************************************************* -`Ver. 202307.0 (2023年7月20日) `_ -********************************************************************************************* - -参考： `freeeアクセシビリティー・ガイドラインVer. 202307.0を公開しました `_ - -* コントラスト比関連のガイドラインで、これまで[SHOULD]として記載していた基準を削除 - - - テキスト： :ref:`gl-text-contrast` - - 画像化されたテキスト： :ref:`gl-iot-text-contrast` - - 画像： :ref:`gl-image-text-contrast` - -* コントラスト比関連のガイドラインの文字サイズの記述について、ウェブアクセシビリティ基盤委員会が示しているものに修正 - - - テキスト： :ref:`gl-text-contrast` - - 画像化されたテキスト： :ref:`gl-iot-text-contrast` - - 画像： :ref:`gl-image-text-contrast` - -* コントラスト比関連のガイドラインで指定されている文字サイズについて、モバイルでは異なる基準を用いることとし、対象プラットフォームをモバイルにしたガイドラインを追加 - - 変更 - - テキスト： :ref:`gl-text-contrast` - - 画像化されたテキスト： :ref:`gl-iot-text-contrast` - - 画像： :ref:`gl-image-text-contrast` - 追加 - - テキスト： :ref:`gl-text-mobile-contrast` - - 画像化されたテキスト： :ref:`gl-iot-mobile-text-contrast` - - 画像： :ref:`gl-image-mobile-text-contrast` - -* :ref:`exp-screen-reader-check-nvda` の更新 - - - NVDAの読み上げに関連するキー操作についての記述と、関連する解説動画を追加 - - Windowsの音声合成エンジンの管理に関する解説動画を追加 - -* :ref:`check-example-nvda` に掲載しているチェック方法の多くについて、具体的なチェック実施方法を紹介する動画を追加（ :ref:`check-index` や各ガイドラインの当該チェックIDの項からも参照可能） -* アクセシビリティー・チェック・リストをV4.1.0に更新 -* 一部マークアップの修正 diff --git a/en/source/intro/ChangeLog/2023/202308.0.rst b/en/source/intro/ChangeLog/2023/202308.0.rst deleted file mode 100644 index 14fb606c..00000000 --- a/en/source/intro/ChangeLog/2023/202308.0.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. _ver-202308-0: - -******************************************************************************************** -`Ver. 202308.0 (2023年8月8日) `_ -******************************************************************************************** - -* フォーム・コントロールのキーボード操作に関するガイドラインを追加: :ref:`gl-form-keyboard-operable` -* :ref:`exp-axe`　に、推奨する初期設定について追記 -* アクセシビリティー・チェック・リストをV4.2.0に更新 diff --git a/en/source/intro/ChangeLog/2023/202309.0.rst b/en/source/intro/ChangeLog/2023/202309.0.rst deleted file mode 100644 index 69c6246e..00000000 --- a/en/source/intro/ChangeLog/2023/202309.0.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. _ver-202309-0: - -******************************************************************************************** -`Ver. 202309.0 (2023年9月4日) `_ -******************************************************************************************** - -* :ref:`exp-axe`　の記述を、axe DevToolsの最新版に合わせて更新 -* :ref:`info-axe-rules` を最新のaxe-coreのソースに基づいた内容に更新 - diff --git a/en/source/intro/ChangeLog/2023/202309.1.rst b/en/source/intro/ChangeLog/2023/202309.1.rst deleted file mode 100644 index 56e0463b..00000000 --- a/en/source/intro/ChangeLog/2023/202309.1.rst +++ /dev/null @@ -1,22 +0,0 @@ -.. _ver-202309-1: - -********************************************************************************************* -`Ver. 202309.1 (2023年9月26日) `_ -********************************************************************************************* - -* 各ガイドライン項目の優先度を廃止 -* ガイドライン項目とチェック内容の表示を調整 -* 優先度の廃止と表示の調整を反映する形で、全般的に文言を見直し -* 文字サイズ変更設定に関するガイドライン項目の見直し - - - テキスト：文字サイズの設定による200パーセントの拡大表示をテキスト： :ref:`gl-text-enlarge-settings` に統合 - - テキスト： :ref:`gl-text-mobile-enlarge-settings` を見直し、対象プラットフォームがWebのテキスト： :ref:`gl-text-enlarge-settings` と整合性がある形に変更 - -* 制限時間に関するガイドライン項目の見直し - - - ログイン・セッション：制限時間を設けないをログイン・セッション：ログイン・セッションにタイムアウトを設ける場合に統合し、同ガイドライン項目を :ref:`gl-login-session-timing` に改名 - - フォーム：制限時間を設けないをフォーム：フォームの入力に制限時間を設ける場合に統合し、 :ref:`gl-form-timing` に改名 - -* アクセシビリティー・チェック・リストをV4.3.0に更新 -* :ref:`info-axe-rules` を最新のaxe-coreのソースに基づいた内容に更新 - diff --git a/en/source/intro/ChangeLog/2023/202310.0.rst b/en/source/intro/ChangeLog/2023/202310.0.rst deleted file mode 100644 index 61e47400..00000000 --- a/en/source/intro/ChangeLog/2023/202310.0.rst +++ /dev/null @@ -1,8 +0,0 @@ -.. _ver-202310-0: - -********************************************************************************************* -`Ver. 202310.0 (2023年10月3日) `_ -********************************************************************************************* - -* 参考情報の各ページの関連ガイドライン項目の項について、自動生成するように変更 - diff --git a/en/source/intro/ChangeLog/2023/202311.0.rst b/en/source/intro/ChangeLog/2023/202311.0.rst deleted file mode 100644 index 84f2f116..00000000 --- a/en/source/intro/ChangeLog/2023/202311.0.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _ver-202311-0: - -********************************************************************************************* -`Ver. 202311.0 (2023年11月7日) `_ -********************************************************************************************* - -* 文言を見直し、「スクロール」を「自動スクロール」に変更： :ref:`gl-dynamic-content-pause-movement` -* アクセシビリティー・チェック・リストをV4.3.1に更新 -* macOS VoiceOverを用いたチェックに関する情報を追加： :ref:`exp-screen-reader-check-macos-vo` -* 誤字修正 - diff --git a/en/source/intro/ChangeLog/2023/202311.1.rst b/en/source/intro/ChangeLog/2023/202311.1.rst deleted file mode 100644 index eb7123d3..00000000 --- a/en/source/intro/ChangeLog/2023/202311.1.rst +++ /dev/null @@ -1,12 +0,0 @@ -.. _ver-202311-1: - -********************************************************************************************** -`Ver. 202311.1 (2023年11月27日) `_ -********************************************************************************************** - -参考： `freeeアクセシビリティー・ガイドラインVer. 202311.1を公開しました `_ - -* macOSの :kbd:`fn` キーに関する設定について追記： :ref:`exp-screen-reader-check-macos-vo` -* アクセシビリティー・チェック・リストをV4.3.2に更新 -* macOS VoiceOverを用いたチェック方法の例を追加し、これらをまとめたページを新設： :ref:`check-example-macos-vo` - diff --git a/en/source/intro/ChangeLog/2023/202312.0.rst b/en/source/intro/ChangeLog/2023/202312.0.rst deleted file mode 100644 index 54236162..00000000 --- a/en/source/intro/ChangeLog/2023/202312.0.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. _ver-202312-0: - -********************************************************************************************** -`Ver. 202312.0 (2023年12月15日) `_ -********************************************************************************************** - -* アクセシビリティー・チェック・リストをV4.3.3に更新 -* :ref:`faq-index` を追加 - diff --git a/en/source/intro/ChangeLog/2023/202312.1.rst b/en/source/intro/ChangeLog/2023/202312.1.rst deleted file mode 100644 index e491293d..00000000 --- a/en/source/intro/ChangeLog/2023/202312.1.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _ver-202312-1: - -********************************************************************************************** -`Ver. 202312.1 (2023年12月25日) `_ -********************************************************************************************** - -* アクセシビリティー・チェック実施に当たっての各種スクリーン・リーダーの位置づけについて改めて明記： :ref:`exp-screen-reader-check` -* :ref:`exp-grayscale` を更新 -* FAQに関連する表示の調整 -* FAQ記事追加 - - - :ref:`faq-p0002` - - :ref:`faq-p0003` - diff --git a/en/source/intro/ChangeLog/2024/202401.0.rst b/en/source/intro/ChangeLog/2024/202401.0.rst deleted file mode 100644 index 040a43c7..00000000 --- a/en/source/intro/ChangeLog/2024/202401.0.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. _ver-202401-0: - -********************************************************************************************* -`Ver. 202401.0 (2024年1月15日) `_ -********************************************************************************************* - -* 「ホバー」という表記を「マウスオーバー（ホバー）」または「マウスオーバー」に変更 -* アクセシビリティー・チェック・リストをV4.3.4に更新 - diff --git a/en/source/intro/history.rst b/en/source/intro/history.rst index f14fa008..e144493a 100644 --- a/en/source/intro/history.rst +++ b/en/source/intro/history.rst @@ -1,58 +1,58 @@ .. _intro-changes: -######## -更新履歴 -######## - -Ver. 202205.0以降、チェック内容に関連する更新情報は :ref:`checksheet-history` のみに掲載しています。 - -.. include:: ChangeLog/2024/202401.0.rst -.. include:: ChangeLog/2023/202312.1.rst -.. include:: ChangeLog/2023/202312.0.rst -.. include:: ChangeLog/2023/202311.1.rst -.. include:: ChangeLog/2023/202311.0.rst -.. include:: ChangeLog/2023/202310.0.rst -.. include:: ChangeLog/2023/202309.1.rst -.. include:: ChangeLog/2023/202309.0.rst -.. include:: ChangeLog/2023/202308.0.rst -.. include:: ChangeLog/2023/202307.0.rst -.. include:: ChangeLog/2023/202306.1.rst -.. include:: ChangeLog/2023/202306.0.rst -.. include:: ChangeLog/2023/202305.0.rst -.. include:: ChangeLog/2023/202304.1.rst -.. include:: ChangeLog/2023/202304.0.rst -.. include:: ChangeLog/2023/202303.2.rst -.. include:: ChangeLog/2023/202303.1.rst -.. include:: ChangeLog/2023/202303.0.rst -.. include:: ChangeLog/2023/202302.0.rst -.. include:: ChangeLog/2023/202301.0.rst -.. include:: ChangeLog/2022/202210.0.rst -.. include:: ChangeLog/2022/202209.1.rst -.. include:: ChangeLog/2022/202209.0.rst -.. include:: ChangeLog/2022/202205.0.rst -.. include:: ChangeLog/2022/202203.0.rst -.. include:: ChangeLog/2022/202202.0.rst -.. include:: ChangeLog/2022/202201.1.rst -.. include:: ChangeLog/2022/202201.0.rst -.. include:: ChangeLog/2021/202112.0.rst -.. include:: ChangeLog/2021/202111.0.rst -.. include:: ChangeLog/2021/202110.2.rst -.. include:: ChangeLog/2021/202110.1.rst -.. include:: ChangeLog/2021/202110.0.rst -.. include:: ChangeLog/2021/202107.0.rst -.. include:: ChangeLog/2021/202106.0.rst -.. include:: ChangeLog/2021/202105.0.rst -.. include:: ChangeLog/2021/202104.0.rst -.. include:: ChangeLog/2021/202103.0.rst -.. include:: ChangeLog/2021/202102.0.rst -.. include:: ChangeLog/2021/202101.1.rst -.. include:: ChangeLog/2021/202101.0.rst -.. include:: ChangeLog/2020/202011.0.rst -.. include:: ChangeLog/2020/202010.0.rst -.. include:: ChangeLog/2020/202009.0.rst -.. include:: ChangeLog/2020/202008.0.rst -.. include:: ChangeLog/2020/202007.0.rst -.. include:: ChangeLog/2020/202006.0.rst -.. include:: ChangeLog/2020/202005.1.rst -.. include:: ChangeLog/2020/202005.0.rst -.. include:: ChangeLog/2020/202004.0.rst +############## +Update History +############## + +Here, we list updates related to the English translation since the introduction of Ver. 202403.0, when we began providing translations of all guidelines. +For the changes to the original Japanese version, please refer to the `Japanese version of this page `__. + +`Ver. 202405.0 (May 14, 2024) `__ +============================================================================================= + +* Added FAQ: :ref:`faq-p0006` +* Updated :ref:`info-axe-rules` to be based on axe-core source as of April 29, 2024 +* Added translations: + + - :ref:`exp-contrast` + - :ref:`exp-check-contrast` + +* Added update history of this translation: this page and :ref:`checks-checksheet` + +`Ver. 202404.0 (April 23, 2024) `__ +=============================================================================================== + +* Added translations: + + - :ref:`exp-color-only` + - :ref:`exp-text-wording` + - :ref:`exp-axe` + - :ref:`exp-markup-semantics` + - :ref:`exp-grayscale` + - :ref:`exp-image-text-alternative` + +* Added FAQs: + + - :ref:`faq-p0004` + - :ref:`faq-p0005` + +`Ver. 202403.1 (March 29, 2024) `__ +=============================================================================================== + +* Added translations: + + - :ref:`intro` + - :ref:`intro-intro` + - :ref:`intro-usage` + - :ref:`intro-contributing` + - :ref:`info-axe-rules` + - :ref:`exp-screen-reader-check-nvda` + - :ref:`exp-screen-reader-check-macos-vo` + - :ref:`exp-target-size` + +* Added FAQ: :ref:`faq-d0003` + +`Ver. 202403.0 (March 4, 2024) `__ +============================================================================================== + +* The English translation of all guidelines was released. diff --git a/ja/source/_static/copylink.js b/ja/source/_static/copylink.js index 78410638..528e484e 100644 --- a/ja/source/_static/copylink.js +++ b/ja/source/_static/copylink.js @@ -4,7 +4,7 @@ document.addEventListener('DOMContentLoaded', function () { const firstH1 = document.querySelector('h1'); if (firstH1) { - appendDropdownMenu(firstH1, firstH1.textContent, location.href); + appendDropdownMenu(firstH1, firstH1.textContent, location.origin + location.pathname); } document.querySelectorAll('section.permalink').forEach(section => { diff --git a/ja/source/checks/checksheet.rst b/ja/source/checks/checksheet.rst index eff7f6ae..fe590429 100644 --- a/ja/source/checks/checksheet.rst +++ b/ja/source/checks/checksheet.rst @@ -368,3 +368,6 @@ V1.0 ==== 初版 + +.. translated:: true + diff --git a/ja/source/explanations/check-contrast.rst b/ja/source/explanations/check-contrast.rst index 345b7480..9051dcd1 100644 --- a/ja/source/explanations/check-contrast.rst +++ b/ja/source/explanations/check-contrast.rst @@ -4,52 +4,87 @@ コントラスト比のチェック方法 ############################ -ロービジョン者でもコンテンツを知覚できるよう、テキストやUIコンポーネントにはそれぞれコントラスト比の基準を満たす色が使われることが求められます。 +Webやモバイル・アプリケーションにおいて、ロービジョン者でもコンテンツを知覚できるよう、テキストやUIコンポーネントにそれぞれコントラスト比の基準を満たす色の組み合わせを用いることが重要です。 -実際のWebページから色のコントラスト比が不足している場所を発見するには `axe DevTools `__ のようなチェックツールを使用し、 -具体的な色同士のコントラスト比の計算には `WebAIM: Contrast Checker `__ のような計算ツールを使用します。 +Webページで色のコントラスト比が不足している場所を発見するには、 `axe DevTools`_ のようなチェック・ツールを用いると良いでしょう。 +モバイル・アプリケーションの画面など、このようなチェック・ツールが利用できない場合は、 `WebAIM: Contrast Checker`_ のような、具体的な色同士のコントラスト比の計算ができるツールと、カラー・ピッカーを組み合わせて使用すると良いでしょう。 **************************************** アクセシビリティー・チェックツールの使用 **************************************** -`axe DevTools `__ を使用すると、Webページ全体から（コントラスト比以外にも）アクセシビリティー上の問題のある場所を発見することができます。 +Google Chromeでは、開発者ツールの Lighthouseタブから、色のコントラスト比の問題を含め、アクセシビリティーの問題をチェックすることができます。 -Google Chromeの場合、開発者ツールの Audits タブに Lighthouse が搭載されていますが、これで採点できるもののうち、 Accessbility については axe DevToolsが使用されています。 -また、 `axe DevToolsのGoogle Chrome 拡張 `__ を使用すると、結果を日本語で読むこともできます。 +また、 `axe DevTools`_ でも、Webページ全体からコントラスト比の問題を含め、アクセシビリティー上の問題のある場所を発見することができます。 +axe DevToolsは、`Google Chrome 拡張`_ および `Mozilla Firefoxアドオン`_ として提供されています。 +************************************** コントラスト比の自動判定ができない場合 -====================================== +************************************** 画像の中の文字など、これらのチェック・ツールではコントラスト比を正しく判定できない場合があります。 axe DevToolsのGoogle Chrome拡張の場合、コントラスト比の判定ができない場合も「要素には十分な色のコントラストがなければなりません」のような、コントラスト比が不充分な場合と同じメッセージが表示されます。 しかし自動判定ができない場合は、詳細パネルに「This potential issue needs your review... コントラスト比を判定できません」といったメッセージが表示されます。 -このような場合は、当該箇所のカラー・コードを調べて、以下に示すツールを使ってコントラスト比を確認します。 +また、axe DevToolsが利用できるのはWebページに対するチェックのみで、モバイル・アプリケーションの画面などに対しては利用できません。 +このような場合は、当該箇所のカラー・コードを調べ、コントラスト比を確認します。 -******************************** -コントラスト比の計算ツールの使用 -******************************** +モバイル・アプリケーションの画面のチェック +========================================== + +モバイル・アプリケーションの画面を対象にしたチェックを実施する場合、以下のような方法が考えられます： + +* スクリーン・ショットを撮り、その画像をPC上でチェックする。 +* Google Meetなどのオンライン会議ツールを使って画面を共有し、PC上で共有された画面をチェックする。 + ただし利用するオンライン会議ツールによっては、共有された画面に色補正が加えられることも考えられるので、この方法を用いる場合は注意が必要です。 + +カラー・コードを調べる +====================== + +カラー・ピッカーと呼ばれるツールで、コントラスト比のチェックをしたい箇所で用いられている色のカラー・コードを調べることができます。 + +後述するWebAIM: Contrast Checkerでも、カラー・ピッカーが提供されていますが、WindowsやmacOSで動作するものもあります。 +以下では代表的なものを挙げます。 + +Windows +------- + +Microsoft PowerToysの機能の1つとして、Color Pickerが提供されています。 + +Microsoft PowerToysは、Microsoft StoreまたはGitHubから入手することができます： -コントラスト比の計算式は非常に複雑であるため、 `WebAIM: Contrast Checker `__ のような計算ツールを使用することが一般的です。 -`contrast.app `__ のように、インストールして常駐させるタイプのチェッカーも存在します。 +* `Microsoft PowerToys (Microsoft Store)`_ +* `Microsoft PowerToys (GitHub)`_ -このようなコントラスト比計算ツールを使用する場合は以下の点に注意が必要です。 +参考： `Microsoft PowerToys: Windows をカスタマイズするためのユーティリティ`_ -* コントラスト比の計算ツールによって小数点以下の丸め方に差異があり、計算結果がバラつくことがある。 +macOS +----- - - 計算結果は目安として、コントラスト比に余裕のある色を選ぶのが望ましい。 +macOSには、Digital Color Meterというカラー・ピッカーが標準で搭載されています。 -* カラーピッカーを使用する場合、macOSではディスプレイのカラープロファイルの影響を受けることがあるため、これを防ぐ必要がある。 +参考： `Mac用Digital Color Meterユーザガイド`_ - - `macOSのカラープロファイル設定 `__ で、「このディスプレイのプロファイルのみを表示」のチェックを外してから ``SRGB IEC61966-2.1`` を選択。 - - SketchではPreferences➝General➝Color Profileで「SRGB IEC61966-2.1」を選択。 +macOSでカラー・ピッカーを使用する場合、ディスプレイのカラー・プロファイルの影響を受けることがあります。 +これを防ぐためには、macOSのカラープロファイル設定で、「このディスプレイのプロファイルのみを表示」のチェックを外してから「SRGB IEC61966-2.1」を選択します。 - 上記はデフォルト設定なので、既存のドキュメントのカラープロファイルは異なったままになっている可能性があります。ファイルのカラープロファイルを変えたい場合は :menuselection:`File --> Document Settings` から変更します。 +参考： `Macのディスプレイのカラープロファイルを変更する`_ - - Adobe XDはOSの設定を引き継ぐので、カラープロファイルの設定を変更した場合は再起動。 +Figmaを使用する場合、画面上部、ファイル名の右横のメニュー内、「File color profile」から、各ファイルに適用されているカラー・プロファイルを確認することができます。 +「sRGB」または「Same as preferred profile (sRGB)」となっていれば問題ありません。 + +また、画面左上、Figmaのメニュー・アイコンから、:menuselection:`Preferences --> Color profile...` で 「sRGB」に変更することで、ファイルの新規作成時にsRGBが選択されるようになります。 + +コントラスト比の計算ツールの使用 +================================ + +コントラスト比の計算式は非常に複雑であるため、 `WebAIM: Contrast Checker`_ のような計算ツールを使用することが一般的です。 +`contrast.app`_ のように、インストールして常駐させるタイプのチェッカーも存在します。 + +なお、コントラスト比の計算ツールによって小数点以下の丸め方に差異があり、計算結果がバラつくことがあります。 +計算結果は目安として考え、コントラスト比に余裕のある色を選ぶのが望ましいでしょう。 **** 参考 @@ -59,3 +94,17 @@ axe DevToolsのGoogle Chrome拡張の場合、コントラスト比の判定が * |Vibes Color Contrast| .. include:: /inc/info2gl/exp-check-contrast.rst + +.. _axe DevTools: https://www.deque.com/axe/ +.. _WebAIM\: Contrast Checker: https://webaim.org/resources/contrastchecker/ +.. _Google Chrome 拡張: https://chrome.google.com/webstore/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd +.. _Mozilla Firefoxアドオン: https://addons.mozilla.org/firefox/addon/axe-devtools/ +.. _contrast.app: https://usecontrast.com/ +.. _Macのディスプレイのカラープロファイルを変更する: https://support.apple.com/ja-jp/guide/mac-help/mchlf3ddc60d/mac +.. _Mac用Digital Color Meterユーザガイド: https://support.apple.com/ja-jp/guide/digital-color-meter/welcome/mac +.. _Microsoft PowerToys (Microsoft Store): https://apps.microsoft.com/detail/xp89dcgq3k6vld +.. _Microsoft PowerToys (GitHub): https://github.com/microsoft/PowerToys +.. _Microsoft PowerToys\: Windows をカスタマイズするためのユーティリティ: https://learn.microsoft.com/ja-jp/windows/powertoys/ + +.. translated:: true + diff --git a/ja/source/explanations/contrast.rst b/ja/source/explanations/contrast.rst index 1f5f8d64..9afb8584 100644 --- a/ja/source/explanations/contrast.rst +++ b/ja/source/explanations/contrast.rst @@ -23,3 +23,6 @@ * |Vibes Color Contrast| .. include:: /inc/info2gl/exp-contrast.rst + +.. translated:: true + diff --git a/ja/source/intro/ChangeLog/2024/202405.0.rst b/ja/source/intro/ChangeLog/2024/202405.0.rst new file mode 100644 index 00000000..c56a9f3f --- /dev/null +++ b/ja/source/intro/ChangeLog/2024/202405.0.rst @@ -0,0 +1,9 @@ +.. _ver-202405-0: + +********************************************************************************************** +`Ver. 202405.0 (2024年5月14日) `__ +********************************************************************************************** + +* 参考情報更新： :ref:`exp-check-contrast` +* FAQ追加： :ref:`faq-p0006` +* :ref:`info-axe-rules` を2024年4月29日時点のaxe-coreのソースに基づいた内容に更新 diff --git a/ja/source/intro/history.rst b/ja/source/intro/history.rst index 09c833ed..e29c0334 100644 --- a/ja/source/intro/history.rst +++ b/ja/source/intro/history.rst @@ -6,6 +6,7 @@ Ver. 202205.0以降、チェック内容に関連する更新情報は :ref:`checksheet-history` のみに掲載しています。 +.. include:: ChangeLog/2024/202405.0.rst .. include:: ChangeLog/2024/202404.0.rst .. include:: ChangeLog/2024/202403.1.rst .. include:: ChangeLog/2024/202403.0.rst @@ -59,3 +60,6 @@ Ver. 202205.0以降、チェック内容に関連する更新情報は :ref:`che .. include:: ChangeLog/2020/202005.1.rst .. include:: ChangeLog/2020/202005.0.rst .. include:: ChangeLog/2020/202004.0.rst + +.. translated:: true + diff --git a/package-lock.json b/package-lock.json index 50b4b52a..339c421b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -13,7 +13,7 @@ }, "devDependencies": { "@textlint-ja/textlint-rule-no-synonyms": "^1.3.0", - "ajv": "^8.12.0", + "ajv": "^8.13.0", "ajv-cli": "^5.0.0", "husky": "^9.0.11", "lint-staged": "^15.2.2", @@ -30,15 +30,6 @@ "textlint-rule-preset-jtf-style": "^2.3.14" } }, - "node_modules/@aashutoshrathi/word-wrap": { - "version": "1.2.6", - "resolved": "https://registry.npmjs.org/@aashutoshrathi/word-wrap/-/word-wrap-1.2.6.tgz", - "integrity": "sha512-1Yjs2SvM8TflER/OD3cOjhWWOZb58A2t7wpE2S9XfBYTiIl+XFhQG2bjy4Pu1I+EAlCNUzRDYDdFwFYUKvXcIA==", - "dev": true, - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/@azu/format-text": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/@azu/format-text/-/format-text-1.0.2.tgz", @@ -55,9 +46,9 @@ } }, "node_modules/@babel/parser": { - "version": "7.24.4", - "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.24.4.tgz", - "integrity": "sha512-zTvEBcghmeBma9QIGunWevvBAp4/Qu9Bdq+2k0Ot4fVMD6v3dsC9WOcRSKk7tRRyBM/53yKMJko9xOatGQAwSg==", + "version": "7.24.5", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.24.5.tgz", + "integrity": "sha512-EOv5IK8arwh3LI47dz1b0tKUb/1uhHAnHJOrjgtQMIpu1uXd9mlFrJg9IUgGUgZ41Ch0K8REPTYpO7B76b4vJg==", "dev": true, "bin": { "parser": "bin/babel-parser.js" @@ -464,15 +455,15 @@ "dev": true }, "node_modules/ajv": { - "version": "8.12.0", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.12.0.tgz", - "integrity": "sha512-sRu1kpcO9yLtYxBKvqfTeh9KzZEwO3STyX1HT+4CaDzC6HpTGYhIhPIzj9XuKU7KYDwnaeh5hcOwjy1QuJzBPA==", + "version": "8.13.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.13.0.tgz", + "integrity": "sha512-PRA911Blj99jR5RMeTunVbNXMF6Lp4vZXnk5GQjcnUWUTsrXtekg/pnmFFI2u/I36Y/2bITGS30GZCXei6uNkA==", "dev": true, "dependencies": { - "fast-deep-equal": "^3.1.1", + "fast-deep-equal": "^3.1.3", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2", - "uri-js": "^4.2.2" + "uri-js": "^4.4.1" }, "funding": { "type": "github", @@ -1491,12 +1482,13 @@ } }, "node_modules/globalthis": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.3.tgz", - "integrity": "sha512-sFdI5LyBiNTHjRd7cGPWapiHWMOXKyuBNX/cWJ3NfzrZQVa8GI/8cofCl74AOVqq9W5kNmguTIzJ/1s2gyI9wA==", + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz", + "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==", "dev": true, "dependencies": { - "define-properties": "^1.1.3" + "define-properties": "^1.2.1", + "gopd": "^1.0.1" }, "engines": { "node": ">= 0.4" @@ -2850,17 +2842,17 @@ } }, "node_modules/optionator": { - "version": "0.9.3", - "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.3.tgz", - "integrity": "sha512-JjCoypp+jKn1ttEFExxhetCKeJt9zhAgAve5FXHixTvFDW/5aEktX9bufBKLRRMdU7bNtpLfcGu94B3cdEJgjg==", + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", "dev": true, "dependencies": { - "@aashutoshrathi/word-wrap": "^1.2.3", "deep-is": "^0.1.3", "fast-levenshtein": "^2.0.6", "levn": "^0.4.1", "prelude-ls": "^1.2.1", - "type-check": "^0.4.0" + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" }, "engines": { "node": ">= 0.8.0" @@ -4526,6 +4518,15 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/wrap-ansi": { "version": "9.0.0", "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.0.tgz", diff --git a/package.json b/package.json index 020706da..351d28d9 100644 --- a/package.json +++ b/package.json @@ -18,7 +18,7 @@ "homepage": "https://github.com/freee/a11y-guidelines#readme", "devDependencies": { "@textlint-ja/textlint-rule-no-synonyms": "^1.3.0", - "ajv": "^8.12.0", + "ajv": "^8.13.0", "ajv-cli": "^5.0.0", "husky": "^9.0.11", "lint-staged": "^15.2.2", diff --git a/tools/yaml2rst/a11y_guidelines.py b/tools/yaml2rst/a11y_guidelines.py index b067bb96..89b562f1 100644 --- a/tools/yaml2rst/a11y_guidelines.py +++ b/tools/yaml2rst/a11y_guidelines.py @@ -346,12 +346,14 @@ def get_dependency(self): def template_object(self, lang): rel = RelationshipManager() tags = rel.get_faq_to_tags(self) + if lang == 'ja': + date_format = "%Y年%-m月%-d日" + else: + date_format = "%B %-d, %Y" template_object = { 'id': self.id, 'updated': self.updated, - 'updated_year': self.updated.year, - 'updated_month': self.updated.month, - 'updated_day': self.updated.day, + 'updated_str': self.updated.strftime(date_format), 'title': self.title[lang], 'problem': self.problem[lang], 'solution': self.solution[lang], diff --git a/tools/yaml2rst/a11y_guidelines_initializer.py b/tools/yaml2rst/a11y_guidelines_initializer.py index b2e18687..72aa2f88 100644 --- a/tools/yaml2rst/a11y_guidelines_initializer.py +++ b/tools/yaml2rst/a11y_guidelines_initializer.py @@ -4,10 +4,10 @@ import json import time import yaml -from git import Repo +import git from jsonschema import validate, ValidationError, RefResolver from a11y_guidelines import Category, WcagSc, InfoRef, Guideline, Check, Faq, FaqTag, CheckTool, AxeRule, RelationshipManager -from constants import CHECK_TOOLS, DEQUE_URL +from constants import CHECK_TOOLS, AXE_CORE from path import get_src_path def setup_instances(settings): @@ -43,37 +43,49 @@ def setup_instances(settings): for entity_type, srcdir, schema_filename, constructor in entity_config: process_entity_files(srcdir, src_path['schema'], schema_filename, resolver, constructor) - process_axe_rules(src_path['axe_rules'], src_path['axe_msg_ja'], src_path['axe_pkg'], DEQUE_URL) + process_axe_rules(basedir, AXE_CORE) rel = RelationshipManager() rel.resolve_faqs() return rel -def process_axe_rules(axe_rules_dir, axe_msg_ja_file, axe_pkg_file, base_url): - try: - file_content = read_file_content(axe_msg_ja_file) - except Exception as e: - handle_file_error(e, axe_msg_ja_file) +def process_axe_rules(basedir, AXE_CORE): + root_repo = git.Repo(basedir) + submodule = None + for sm in root_repo.submodules: + if sm.name == AXE_CORE['submodule_name']: + submodule = sm + break + + if submodule is None: + raise ValueError(f'Submodule with name {AXE_CORE["submodule_name"]} not found.') + + axe_base = os.path.join(basedir, submodule.path) + axe_commit_id = submodule.hexsha + axe_repo = git.Repo(axe_base) + axe_commit = axe_repo.commit(axe_commit_id) + + # Get message file + blob = axe_commit.tree / AXE_CORE['msg_ja_file'] + file_content = blob.data_stream.read().decode('utf-8') messages_ja = json.loads(file_content) - rule_files = ls_dir(axe_rules_dir, '.json') - for rule_file in rule_files: - try: - file_content = read_file_content(rule_file) - except Exception as e: - handle_file_error(e, rule_file) + + # Get rule files + tree = axe_commit.tree / AXE_CORE['rules_dir'] + rule_blobs = [item for item in tree.traverse() if item.type == 'blob' and item.path.endswith('.json')] + for blob in rule_blobs: + file_content = blob.data_stream.read().decode('utf-8') parsed_data = json.loads(file_content) AxeRule(parsed_data, messages_ja) - try: - file_content = read_file_content(axe_pkg_file) - except Exception as e: - handle_file_error(e, axe_pkg_file) + + # Get the package file + blob = axe_commit.tree / AXE_CORE['pkg_file'] + file_content = blob.data_stream.read().decode('utf-8') parsed_data = json.loads(file_content) - version = parsed_data['version'] - AxeRule.version = version - AxeRule.major_version = re.sub(r'(\d+)\.(\d+)\.\d+', r'\1.\2', version) - AxeRule.deque_url = base_url - for item in Repo(os.path.dirname(axe_pkg_file)).iter_commits('develop', max_count=1): - AxeRule.timestamp = time.strftime("%F %T%z", time.localtime(item.authored_date)) + AxeRule.version = parsed_data['version'] + AxeRule.major_version = re.sub(r'(\d+)\.(\d+)\.\d+', r'\1.\2', parsed_data['version']) + AxeRule.deque_url = AXE_CORE['deque_url'] + AxeRule.timestamp = time.strftime("%F %T%z", time.localtime(axe_commit.authored_date)) def ls_dir(dirname, extension=None): files = [] diff --git a/tools/yaml2rst/constants.py b/tools/yaml2rst/constants.py index 04335e77..5d6cc126 100644 --- a/tools/yaml2rst/constants.py +++ b/tools/yaml2rst/constants.py @@ -99,4 +99,10 @@ } # for axe rules -DEQUE_URL = 'https://dequeuniversity.com/rules/axe/' +AXE_CORE = { + 'submodule_name': 'vendor/axe-core', + 'deque_url': 'https://dequeuniversity.com/rules/axe/', + 'msg_ja_file': 'locales/ja.json', + 'pkg_file': 'package.json', + 'rules_dir': 'lib/rules' +} diff --git a/tools/yaml2rst/path.py b/tools/yaml2rst/path.py index 7873f0a8..e850c2ed 100644 --- a/tools/yaml2rst/path.py +++ b/tools/yaml2rst/path.py @@ -111,9 +111,6 @@ def get_src_path(basedir): 'wcag_sc': os.path.join(json_basedir, 'wcag-sc.json'), 'gl_categories': os.path.join(json_basedir, 'guideline-categories.json'), 'faq_tags': os.path.join(json_basedir, 'faq-tags.json'), - 'info': os.path.join(json_basedir, 'info.json'), - 'axe_rules': os.path.join(basedir, AXE_SRC_BASE, AXE_RULES_DIR), - 'axe_msg_ja': os.path.join(basedir, AXE_SRC_BASE, AXE_LOCALE_DIR, AXE_LOCALE_JA_FILE), - 'axe_pkg': os.path.join(basedir, AXE_SRC_BASE, AXE_PKG_FILE) + 'info': os.path.join(json_basedir, 'info.json') } return src_path diff --git a/tools/yaml2rst/templates/faq/article.rst b/tools/yaml2rst/templates/faq/article.rst index 0f5c4507..7670b816 100644 --- a/tools/yaml2rst/templates/faq/article.rst +++ b/tools/yaml2rst/templates/faq/article.rst @@ -10,11 +10,11 @@ {{ title|make_heading(1) }} {% if lang == 'ja' -%} -最終更新：{{ updated_year }}年{{ updated_month }}月{{ updated_day }}日 +最終更新：{{ updated_str }} タグ： {%- elif lang == 'en' -%} -Last Updated: {{ updated_year }}-{{ updated_month }}-{{ updated_day }} +Last Updated: {{ updated_str }} Tags: {%- endif -%} diff --git a/tools/yaml2rst/templates/faq/index.rst b/tools/yaml2rst/templates/faq/index.rst index fcc9a9dd..f2bc4f83 100644 --- a/tools/yaml2rst/templates/faq/index.rst +++ b/tools/yaml2rst/templates/faq/index.rst @@ -49,9 +49,9 @@ List of FAQ Articles {% for article in articles -%} {%- if lang == 'ja' -%} -* :ref:`faq-{{ article.id }}` （{{ article.updated_year }}年{{ article.updated_month }}月{{ article.updated_day }}日更新） +* :ref:`faq-{{ article.id }}` （{{ article.updated_str }}更新） {%- elif lang == 'en' -%} -* :ref:`faq-{{ article.id }}` (updated on {{ article.updated_year }}-{{ article.updated_month }}-{{ article.updated_day }}) +* :ref:`faq-{{ article.id }}` (updated on {{ article.updated_str }}) {%- endif %} {% endfor %} {% if lang == 'ja' -%} diff --git a/vendor/axe-core b/vendor/axe-core index ed737c72..eac82232 160000 --- a/vendor/axe-core +++ b/vendor/axe-core @@ -1 +1 @@ -Subproject commit ed737c7270c1726ea8ff04e4d7891befd8aff653 +Subproject commit eac822328b21325f0c16438b69f4a39a3102d5b9 diff --git a/version.py b/version.py index 9dca331a..c1b8c088 100644 --- a/version.py +++ b/version.py @@ -1,3 +1,3 @@ -guidelines_version = 'Ver. 202404.0' +guidelines_version = 'Ver. 202405.0' checksheet_version = '4.3.7' -publishedDate = '2024-04-23' +publishedDate = '2024-05-14'