diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index e6cacba3bb..fb1f1eafda 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -1,32 +1,32 @@ --- 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. +网络无障碍辅助功能(Accessibility,也被称为 [**a11y**](https://en.wiktionary.org/wiki/a11y),因为以A开头,以Y结尾,一共11个字母)是一种可以帮助所有人获得服务的设计和创造。无障碍辅助功能是使得辅助技术正确解读网页的必要条件。 -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,WCAG)](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](https://webaim.org/standards/wcag/checklist) -- [Checklist from The A11Y Project](https://a11yproject.com/checklist.html) +- [Wuchang 提供的 WCAG 检查表(WCAG checklist from Wuhcag)](https://www.wuhcag.com/wcag-checklist/) +- [WebAIM 提供的 WCAG 检查表(WCAG checklist from WebAIM)](https://webaim.org/standards/wcag/checklist) +- [A11Y Project 提供的检查表(Checklist from The A11Y Project)](https://a11yproject.com/checklist.html) ### 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 变量和属性命名都使用驼峰命名(camelCased),但 aria-* 应该像其在 HTML 中一样使用带连字符的命名法(也叫诸如 hyphen-cased,kebab-case,lisp-case)。 ```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} +语义化的 HTML 是无障碍辅助功能网络应用的基础。 +利用多种 HTML 元素来强化您网站中的信息通常可以使您直接获得无障碍辅助功能。 -- [MDN HTML elements reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Element) +- [MDN 的 HTML 元素参照(MDN HTML elements reference)](https://developer.mozilla.org/en-US/docs/Web/HTML/Element) -Sometimes we break HTML semantics when we add `
` elements to our JSX to make our React code work, especially when working with lists (`
    `, `