diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index 663251a03..dd101d81a 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -1,22 +1,22 @@ --- id: accessibility -title: Accessibility +title: アクセシビリティ permalink: docs/accessibility.html --- -## Why Accessibility? {#why-accessibility} +## なぜアクセシビリティが必要なのか? {#why-accessibility} -Web accessibility (also referred to as [**a11y**](https://en.wiktionary.org/wiki/a11y)) is the design and creation of websites that can be used by everyone. Accessibility support is necessary to allow assistive technology to interpret web pages. +Web アクセシビリティ([**a11y**](https://en.wiktionary.org/wiki/a11y) とも呼ばれます)とは、誰にでも使えるようウェブサイトを設計・構築することです。ユーザ補助技術がウェブページを解釈できるようにするためには、サイトでアクセシビリティをサポートする必要があります。 -React fully supports building accessible websites, often by using standard HTML techniques. +React はアクセシビリティを備えたウェブサイトの構築を全面的にサポートしており、大抵は標準の HTML の技術が用いられます。 -## Standards and Guidelines {#standards-and-guidelines} +## 標準およびガイドライン {#standards-and-guidelines} ### WCAG {#wcag} -The [Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) provides guidelines for creating accessible web sites. +[Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) はアクセシビリティを備えたウェブサイトを構築するためのガイドラインを提供しています。 -The following WCAG checklists provide an overview: +以下の WCAG のチェックリストはその概要を示します。 - [WCAG checklist from Wuhcag](https://www.wuhcag.com/wcag-checklist/) - [WCAG checklist from WebAIM](http://webaim.org/standards/wcag/checklist) @@ -24,9 +24,9 @@ The following WCAG checklists provide an overview: ### WAI-ARIA {#wai-aria} -The [Web Accessibility Initiative - Accessible Rich Internet Applications](https://www.w3.org/WAI/intro/aria) document contains techniques for building fully accessible JavaScript widgets. +[Web Accessibility Initiative - Accessible Rich Internet Applications](https://www.w3.org/WAI/intro/aria) には十分なアクセシビリティを持つ JavaScript ウィジェットの構築テクニックが含まれています。 -Note that all `aria-*` HTML attributes are fully supported in JSX. Whereas most DOM properties and attributes in React are camelCased, these attributes should be hyphen-cased (also known as kebab-case, lisp-case, etc) as they are in plain HTML: +補足として、JSX ではすべての `aria-*` で始まる HTML 属性がサポートされています。React においてほとんどの DOM プロパティと属性がキャメルケースである一方で、これらの属性は純粋な HTML と同じようにハイフンケース(ケバブケースやリスプケースなどとも言われる)である必要があります。 ```javascript{3,4} ``` -## Semantic HTML {#semantic-html} -Semantic HTML is the foundation of accessibility in a web application. Using the various HTML elements to reinforce the meaning of information -in our websites will often give us accessibility for free. +## セマンティックな HTML {#semantic-html} -- [MDN HTML elements reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Element) +セマンティック(意味論的)な HTML はウェブアプリケーションにおけるアクセシビリティの基礎となります。ウェブサイト内の情報の意味を明確にするための多様な HTML 要素を使うことにより、大抵の場合は少ない手間でアクセシビリティを手に入れられます。 -Sometimes we break HTML semantics when we add `