From dd8d38eddba004b63afab0f0c3f6c3d5d11383c6 Mon Sep 17 00:00:00 2001 From: Francisco Madeira Date: Thu, 23 Jan 2020 20:46:55 +0000 Subject: [PATCH 01/46] Translation of the first paragrapher of accessibility --- content/docs/accessibility.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index a8c73e64b..2c220539c 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -4,11 +4,11 @@ title: Accessibility permalink: docs/accessibility.html --- -## Why Accessibility? {#why-accessibility} +## Porque Acessibilidade? {#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. +A acessibilidade na web (tambem conhecido por [**a11y**](https://en.wiktionary.org/wiki/a11y)) é o design e a criação de websites que podem ser usados por todos. O suporte à acessibilidade é necessário para permitir que as tecnologias assistivas interpretem as páginas da web. -React fully supports building accessible websites, often by using standard HTML techniques. +O React suporta totalmente a construção de websites acessíveis, muitas vezes com apenas técnias de HTML padrão. ## Standards and Guidelines {#standards-and-guidelines} From 9480c5ea62d984a3b0f2e1532d0a7e6e88c0e647 Mon Sep 17 00:00:00 2001 From: Francisco Madeira Date: Sun, 26 Jan 2020 13:29:12 +0000 Subject: [PATCH 02/46] Update content/docs/accessibility.md Co-Authored-By: Francisco Joshua --- content/docs/accessibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index 2c220539c..8e7c1267f 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -6,7 +6,7 @@ permalink: docs/accessibility.html ## Porque Acessibilidade? {#why-accessibility} -A acessibilidade na web (tambem conhecido por [**a11y**](https://en.wiktionary.org/wiki/a11y)) é o design e a criação de websites que podem ser usados por todos. O suporte à acessibilidade é necessário para permitir que as tecnologias assistivas interpretem as páginas da web. +A acessibilidade na web (também conhecida por [**a11y**](https://en.wiktionary.org/wiki/a11y)) é o design e a criação de websites que podem ser usados por todos. O suporte à acessibilidade é necessário para permitir que as tecnologias assistivas interpretem as páginas da web. O React suporta totalmente a construção de websites acessíveis, muitas vezes com apenas técnias de HTML padrão. From f2160fb548ab9a64993ac636b1d0cc856f028eb1 Mon Sep 17 00:00:00 2001 From: Francisco Madeira Date: Wed, 11 Mar 2020 23:27:45 +0000 Subject: [PATCH 03/46] Finish WCAG and WAI-ARIA paragraph --- content/docs/accessibility.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index 8e7c1267f..827aacde4 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -6,7 +6,7 @@ permalink: docs/accessibility.html ## Porque Acessibilidade? {#why-accessibility} -A acessibilidade na web (também conhecida por [**a11y**](https://en.wiktionary.org/wiki/a11y)) é o design e a criação de websites que podem ser usados por todos. O suporte à acessibilidade é necessário para permitir que as tecnologias assistivas interpretem as páginas da web. +A acessibilidade na web (também conhecida por [** a11y **](https://en.wiktionary.org/wiki/a11y)) é o design e a criação de websites que podem ser usados por todos. O suporte à acessibilidade é necessário para permitir que as tecnologias assistivas interpretem as páginas da web. O React suporta totalmente a construção de websites acessíveis, muitas vezes com apenas técnias de HTML padrão. @@ -14,9 +14,9 @@ O React suporta totalmente a construção de websites acessíveis, muitas vezes ### WCAG {#wcag} -The [Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) provides guidelines for creating accessible web sites. +O [Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) fornece as diretrizes necessárias para a criação de sites acessíveis. -The following WCAG checklists provide an overview: +As seguintes checklists das WCAG fornecem uma visão geral: - [WCAG checklist from Wuhcag](https://www.wuhcag.com/wcag-checklist/) - [WCAG checklist from WebAIM](https://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. +O documento [Web Accessibility Initiative - Accessible Rich Internet Applications](https://www.w3.org/WAI/intro/aria) contém as técnicas necessárias para criar widgets totalmente acessíveis. -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: +Nota que todos os atributos HTML `aria-*` são totalmente suportados em JSX. Apesar da maioria das proriedades e atributos do DOM no React serem em camelCase, estes atributos devem ser em hyphen-cased (tambem conhecido como kebab-case, lisp-case, etc) pois estão em HTML: ```javascript{3,4} Date: Thu, 12 Mar 2020 00:52:56 +0000 Subject: [PATCH 04/46] Add Semantic HTML Paragraph --- content/docs/accessibility.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index 827aacde4..bd7eba27c 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -39,16 +39,15 @@ Nota que todos os atributos HTML `aria-*` são totalmente suportados em JSX. Ape /> ``` -## 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. +## Semântica HTML {#semantic-html} +A semântica é a base de uma aplicação web acessível. Se usarmos corretamente os elementos HTML para reforçar o significado da informação colocada nos nossos websites, muitas das vezes a acessibilidade pode ser gratuita. - [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 (`
    `, `
      ` and `
      `) and the HTML ``. -In these cases we should rather use [React Fragments](/docs/fragments.html) to group together multiple elements. +Às vezes, quebramos a semântica HTML para adicionar elementos `
      ` ao nosso JSX apenas para fazer funcionar no React, especialmente quando trabalharmos com listas (`
        `, `
          ` and `
          `) e com `
      `. +Nestes casos devemos usar [React Fragments](/docs/fragments.html) para agrupar vários elementos. -For example, +Por exemplo, ```javascript{1,5,8} import React, { Fragment } from 'react'; @@ -73,14 +72,14 @@ function Glossary(props) { } ``` -You can map a collection of items to an array of fragments as you would any other type of element as well: +Podemos mapear uma coleção de itens para um array de fragments tal como fariamos para qualquer outro tipo de elemento: ```javascript{6,9} function Glossary(props) { return (
      {props.items.map(item => ( - // Fragments should also have a `key` prop when mapping collections + // Quando estamos a iterar um array, os Fragments devem ter a propriedade `key` adicionada
      {item.term}
      {item.description}
      @@ -91,7 +90,7 @@ function Glossary(props) { } ``` -When you don't need any props on the Fragment tag you can use the [short syntax](/docs/fragments.html#short-syntax), if your tooling supports it: +Quando não é necessario passar propriedades para a tag Fragment podemos usar a [syntax curta](/docs/fragments.html#short-syntax), se a configuração suportar: ```javascript{3,6} function ListItem({ item }) { @@ -104,7 +103,7 @@ function ListItem({ item }) { } ``` -For more info, see [the Fragments documentation](/docs/fragments.html). +Para mais informação, veja a [documentação sobre Fragments](/docs/fragments.html). ## Accessible Forms {#accessible-forms} From 7bb20b06308b5de0ec48ff62157fbe17eea78ed6 Mon Sep 17 00:00:00 2001 From: Francisco Madeira Date: Thu, 12 Mar 2020 01:05:45 +0000 Subject: [PATCH 05/46] Add Labeling Paragraph --- content/docs/accessibility.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index bd7eba27c..fba9068d4 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -105,22 +105,22 @@ function ListItem({ item }) { Para mais informação, veja a [documentação sobre Fragments](/docs/fragments.html). -## Accessible Forms {#accessible-forms} +## Formulários Acessíveis {#accessible-forms} -### Labeling {#labeling} -Every HTML form control, such as `` and `