2021年6月1日時点の社内版を反映、Ver. 202106.0.

Author: ma10

package-lock.json

@@ -6,7 +6,7 @@
   "dependencies": {
     "@textlint-ja/textlint-rule-no-synonyms": "^1.1.0",
     "sudachi-synonyms-dictionary": "^4.1.0",
-    "textlint": "^11.8.1",
+    "textlint": "^12.0.0",
     "textlint-filter-rule-whitelist": "^2.0.0",
     "textlint-plugin-rst": "^0.1.1",
     "textlint-rule-ja-hiragana-fukushi": "^1.3.0",

package.json

@@ -20,9 +20,9 @@
 project = 'freeeアクセシビリティー・ガイドライン'
 copyright = '2020-2021, freee株式会社'
 author = 'freee株式会社'
-version = 'Ver. 202105.0'
+version = 'Ver. 202106.0'
 release = version
-publishedDate = u'2021年5月6日'
+publishedDate = u'2021年6月1日'
 
 if 'internal' in tags:
   publishedDate = datetime.datetime.now().strftime("%Y-%m-%d")

source/conf.py

@@ -16,6 +16,16 @@
 Google Chromeの場合、開発者ツールの Audits タブに Lighthouse が搭載されていますが、これで採点できるもののうち、 Accessbility については axe DevToolsが使用されています。
 また、 `axe DevToolsのGoogle Chrome 拡張 <https://chrome.google.com/webstore/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd>`_ を使用すると、結果を日本語で読むこともできます。
 
+コントラスト比の自動判定ができない場合
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+画像の中の文字など、これらのチェック・ツールではコントラスト比を正しく判定できない場合があります。
+
+axe DevToolsのGoogle Chrome拡張の場合、コントラスト比の判定ができない場合も「要素には十分な色のコントラストがなければなりません」のような、コントラスト比が不充分な場合と同じメッセージが表示されます。
+しかし自動判定ができない場合は、詳細パネルに「This potential issue needs your review... コントラスト比を判定できません」といったメッセージが表示されます。
+
+このような場合は、当該箇所のカラー・コードを調べて、以下に示すツールを使ってコントラスト比を確認します。
+
 
 コントラスト比の計算ツールの使用
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/explanations/check-contrast.rst

@@ -21,13 +21,10 @@
 
       javascript:(function(){var d=document;s=d.createElement("style");s.innerHTML="*{filter:grayscale(100%) !important}";d.body.appendChild(s)})()
 
-   .. only:: html
-
-      .. raw:: html
-
-         </details>
-         <a href='javascript:(function(){var d=document;s=d.createElement("style");s.innerHTML="*{filter:grayscale(100%) !important}";d.body.appendChild(s)})();'>表示中のページをグレースケール表示にするブックマークレット</a>
+   .. raw:: html
 
+      </details>
+      <a href='javascript:(function(){var d=document;s=d.createElement("style");s.innerHTML="*{filter:grayscale(100%) !important}";d.body.appendChild(s)})();'>表示中のページをグレースケール表示にするブックマークレット</a>
 
 #. チェック対象のページを表示した状態で、このブックマークレットを実行。
 

source/explanations/grayscale.rst

@@ -30,12 +30,10 @@
 
       javascript:window.open(location.href,'a11ytest_1280x1024','width=1280,height=1024')
 
-   .. only:: html
-
-      .. raw:: html
+   .. raw:: html
 
-         </details>
-         <a href="javascript:window.open(location.href,'a11ytest_1280x1024','width=1280,height=1024')">ウィンドウ・サイズを1280x1024にするブックマークレット</a>
+      </details>
+      <a href="javascript:window.open(location.href,'a11ytest_1280x1024','width=1280,height=1024')">ウィンドウ・サイズを1280x1024にするブックマークレット</a>
 
 #. チェック対象のページを表示した状態で、このブックマークレットを実行。
 

source/explanations/magnification.rst

@@ -28,13 +28,11 @@ The Nu Html Checkerを用いたHTMLのバリデーション
 
       javascript:(function(){function c(a,b){var c=document.createElement("textarea");c.name=a;c.value=b;d.appendChild(c)}var e=function(a){for(var b="",a=a.firstChild;a;){switch(a.nodeType){case Node.ELEMENT_NODE:b+=a.outerHTML;break;case Node.TEXT_NODE:b+=a.nodeValue;break;case Node.CDATA_SECTION_NODE:b+="<![CDATA["+a.nodeValue+"]]\>";break;case Node.COMMENT_NODE:b+="<\!--"+a.nodeValue+"--\>";break;case Node.DOCUMENT_TYPE_NODE:b+="<!DOCTYPE "+a.name+">\n"}a=a.nextSibling}return b}(document),d=document.createElement("form");d.method="POST";d.action="https://validator.w3.org/nu/";d.enctype="multipart/form-data";d.target="_blank";d.acceptCharset="utf-8";c("showsource","yes");c("content",e);document.body.appendChild(d);d.submit()})();
 
-   .. only:: html
 
-      .. raw:: html
-
-         </details>
-         <a href='javascript:(function(){function c(a,b){var c=document.createElement("textarea");c.name=a;c.value=b;d.appendChild(c)}var e=function(a){for(var b="",a=a.firstChild;a;){switch(a.nodeType){case Node.ELEMENT_NODE:b+=a.outerHTML;break;case Node.TEXT_NODE:b+=a.nodeValue;break;case Node.CDATA_SECTION_NODE:b+="<![CDATA["+a.nodeValue+"]]\>";break;case Node.COMMENT_NODE:b+="<\!--"+a.nodeValue+"--\>";break;case Node.DOCUMENT_TYPE_NODE:b+="<!DOCTYPE "+a.name+">\n"}a=a.nextSibling}return b}(document),d=document.createElement("form");d.method="POST";d.action="https://validator.w3.org/nu/";d.enctype="multipart/form-data";d.target="_blank";d.acceptCharset="utf-8";c("showsource","yes");c("content",e);document.body.appendChild(d);d.submit()})();'>表示中のページを https://validator.w3.org/nu/ に送信するブックマークレット</a>
+   .. raw:: html
 
+      </details>
+      <a href='javascript:(function(){function c(a,b){var c=document.createElement("textarea");c.name=a;c.value=b;d.appendChild(c)}var e=function(a){for(var b="",a=a.firstChild;a;){switch(a.nodeType){case Node.ELEMENT_NODE:b+=a.outerHTML;break;case Node.TEXT_NODE:b+=a.nodeValue;break;case Node.CDATA_SECTION_NODE:b+="<![CDATA["+a.nodeValue+"]]\>";break;case Node.COMMENT_NODE:b+="<\!--"+a.nodeValue+"--\>";break;case Node.DOCUMENT_TYPE_NODE:b+="<!DOCTYPE "+a.name+">\n"}a=a.nextSibling}return b}(document),d=document.createElement("form");d.method="POST";d.action="https://validator.w3.org/nu/";d.enctype="multipart/form-data";d.target="_blank";d.acceptCharset="utf-8";c("showsource","yes");c("content",e);document.body.appendChild(d);d.submit()})();'>表示中のページを https://validator.w3.org/nu/ に送信するブックマークレット</a>
 
 #. チェック対象のページを表示した状態で、このブックマークレットを実行。
 

source/explanations/nu-html-checker.rst

@@ -209,9 +209,9 @@ JAWSでは、「仮想PCカーソル」がブラウズ・モード、「フォ
 ``````````````````````````
 
 ここまでで紹介したキー操作などはごく一部のものですが、NVDA日本語チームが公開している `NVDAチートシート <https://github.com/nvdajp/cheatsheet>`_ には、他のキー操作も含めてまとめられています。
-GitHub上では、 `pptx版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheet.pptx>`_ と `PDF版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheet.pdf>`_ が公開されていますが、以下これを画像化したものを掲載します。
+GitHub上では、 `pptx版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.pptx>`_ と `PDF版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.pdf>`_ が公開されていますが、以下これを画像化したものを掲載します。
 
-.. image:: /img/nvdacheet.png
+.. image:: /img/nvdacheat.png
    :alt: 画像化したNVDAチートシート
 
 NVDAの更新

source/explanations/screen-reader-check.rst

@@ -51,12 +51,10 @@ Tab/Shift+Tabキーを用いたチェックは、以下を確認するために
 
       javascript:(function(){var s=document.createElement('style');s.innerText="*{cursor:none !important;pointer-events:none !important}*:focus{cursor: none !important;pointer-events:none !important}";document.head.appendChild(s)})()
 
-   .. only:: html
-
-      .. raw:: html
+   .. raw:: html
 
-         </details>
-         <a href="javascript:(function(){var s=document.createElement('style');s.innerText='*{cursor:none !important;pointer-events:none !important}*:focus{cursor: none !important;pointer-events:none !important}';document.head.appendChild(s)})()">マウス・ポインターを非表示にするブックマークレット</a>
+      </details>
+      <a href="javascript:(function(){var s=document.createElement('style');s.innerText='*{cursor:none !important;pointer-events:none !important}*:focus{cursor: none !important;pointer-events:none !important}';document.head.appendChild(s)})()">マウス・ポインターを非表示にするブックマークレット</a>
 
 #. チェック対象のページを表示した状態で、このブックマークレットを実行。
 

source/explanations/tab-order-check.rst

@@ -30,12 +30,10 @@
 
       javascript:(function(){var d = document,e=d.createElement('div'),g=d.createElement('div'),w=window;d.body.appendChild(e);e.appendChild(g);e.setAttribute('style','position:absolute;top:0;left:0;z-index:2147483647;box-sizing:border-box;width:44px;height:44px;border:1px solid #f00;background:#fff;opacity:0.5;transform: translate(-50%,-50%);pointer-events:none;');g.setAttribute('style','position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);box-sizing:border-box;width:24px;height:24px;border:1px solid #00f;');w.onmousemove=(function(v){e.style.left=w.scrollX+v.clientX+'px';e.style.top=w.scrollY+v.clientY+'px'})})()
 
-   .. only:: html
-
-      .. raw:: html
+   .. raw:: html
 
-         </details>
-         <a href="javascript:(function(){var d = document,e=d.createElement('div'),g=d.createElement('div'),w=window;d.body.appendChild(e);e.appendChild(g);e.setAttribute('style','position:absolute;top:0;left:0;z-index:2147483647;box-sizing:border-box;width:44px;height:44px;border:1px solid #f00;background:#fff;opacity:0.5;transform: translate(-50%,-50%);pointer-events:none;');g.setAttribute('style','position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);box-sizing:border-box;width:24px;height:24px;border:1px solid #00f;');w.onmousemove=(function(v){e.style.left=w.scrollX+v.clientX+'px';e.style.top=w.scrollY+v.clientY+'px'})})()">44x44 pxの4角形を表示するブックマークレット</a>
+      </details>
+      <a href="javascript:(function(){var d = document,e=d.createElement('div'),g=d.createElement('div'),w=window;d.body.appendChild(e);e.appendChild(g);e.setAttribute('style','position:absolute;top:0;left:0;z-index:2147483647;box-sizing:border-box;width:44px;height:44px;border:1px solid #f00;background:#fff;opacity:0.5;transform: translate(-50%,-50%);pointer-events:none;');g.setAttribute('style','position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);box-sizing:border-box;width:24px;height:24px;border:1px solid #00f;');w.onmousemove=(function(v){e.style.left=w.scrollX+v.clientX+'px';e.style.top=w.scrollY+v.clientY+'px'})})()">44x44 pxの4角形を表示するブックマークレット</a>
 
 #. チェック対象のページを表示した状態で、このブックマークレットを実行。