{"componentChunkName":"component---src-templates-docs-js","path":"/docs/accessibility.html","result":{"data":{"markdownRemark":{"html":"

Por que Acessibilidade ?

\n

A acessibilidade da Web (também chamada de ** a11y **) é o design e a criação de sites que podem ser usados ​​por todos. O suporte à acessibilidade é necessário para permitir que tecnologias assistivas interpretem as páginas da web.

\n

React suporta totalmente a construção de sites acessíveis, muitas vezes usando técnicas HTML padrão.

\n

Padrões e Diretrizes

\n

WCAG

\n

O Web Content Accessibility Guidelines fornece diretrizes para a criação de sites acessíveis.

\n

As seguintes checklists das WCAG fornecem uma visão geral:

\n\n

WAI-ARIA

\n

O documento Web Accessibility Initiative - Accessible Rich Internet Applications contém técnicas para a criação de widgets JavaScript totalmente acessíveis.

\n

Note que todos os atributos HTML aria-* são totalmente suportados no JSX. Enquanto a maioria das propriedades e atributos do DOM no React são camelCase, esses atributos devem ser hyphen-case ​​(também conhecidos como kebab-case, lisp-case, etc), pois estão em HTML:

\n
<input\n  type=\"text\"\n  aria-label={labelText}  aria-required=\"true\"  onChange={onchangeHandler}\n  value={inputValue}\n  name=\"name\"\n/>
\n

Linguagem HTML

\n

Linguagem é a base da acessibilidade em um aplicativo da web. Usando os elementos HTML corretamente para reforçar o significado da informação\nem nossos sites, muitas vezes a acessibilidade pode vir gratuitamente.

\n\n

Às vezes, quebramos a semântica de HTML quando adicionamos elementos <div> ao nosso JSX somente para fazer nosso código React funcionar, especialmente ao trabalhar com listas (<ol>, <ul> e <dl>) e HTML <table>. Nesses casos, devemos usar React Fragments para agrupar vários elementos.

\n

Por exemplo,

\n
import React, { Fragment } from 'react';\nfunction ListaDeItems({ item }) {\n  return (\n    <Fragment>      <dt>{item.nome}</dt>\n      <dd>{item.descricao}</dd>\n    </Fragment>  );\n}\n\nfunction Glossario(props) {\n  return (\n    <dl>\n      {props.items.map(item => (\n        <ListaDeItems item={item} key={item.id} />\n      ))}\n    </dl>\n  );\n}
\n

Você pode mapear uma coleção de items para uma matriz de fragmentos como faria com qualquer outro tipo de elemento:

\n
function Glossario(props) {\n  return (\n    <dl>\n      {props.items.map(item => (\n        // Fragments também aceitam `key`(chave) prop quando estao mapeando coleções\n        <Fragment key={item.id}>          <dt>{item.nome}</dt>\n          <dd>{item.descricao}</dd>\n        </Fragment>      ))}\n    </dl>\n  );\n}
\n

Quando você não precisa de nenhum prop na tag Fragment você pode usar a syntax curta, se a sua configuração suportar:

\n
function ListaDeItems({ item }) {\n  return (\n    <>      <dt>{item.nome}</dt>\n      <dd>{item.descricao}</dd>\n    </>  );\n}
\n

Para mais informações, veja a doumentação para Fragments.

\n

Formulários Acessíveis

\n

Rótulos

\n

Todos os elements de um formulário HTML, como <input> e <textarea>, precisam ser rotulados. Precisamos fornecer rótulos descritivos pois são expostos aos leitores de tela.

\n

Os seguintes artigos nos mostram como fazer isso:

\n\n

Embora essas práticas HTML padrão possam ser usadas diretamente em React, observe que o atributo for está escrito como htmlFor em JSX:

\n
<label htmlFor=\"nomeDaEntrada\">Nome:</label><input id=\"nomeDaEntrada\" type=\"text\" name=\"nome\"/>
\n

Notificando erros ao usuário

\n

Situações de erro precisam ser entendidas por todos os usuários. Os artigos a seguir nos mostram como expor os erros aos leitores de tela:

\n\n

Controle de Foco

\n

Certifique-se de que seu aplicativo da web seja totalmente navegável apenas com o teclado:

\n\n

Foco no teclado e foco de contorno

\n

Foco no teclado se refere ao elemento no DOM que foi selecionado e aceita ações do teclado. Podemos ver o contorno do foco na imagem a seguir:

\n\n \n \n \n \n \"Contorno\n \n \n \n \n \n

Somente use CSS que elimine este contorno, por exemplo, definindo outline: 0, se você for substituí-lo por outra implementação de esquema de foco.

\n

Mecanismos para pular conteúdo

\n

São mecanismos para permitir que os usuários ignorem as seções de navegação anteriores em seu aplicativo, pois isso ajuda e acelera a navegação pelo teclado.

\n

Skiplinks ou Links para Pular Navegacão são links de navegação ocultos que só se tornam visíveis quando os usuários interagem com a página usando o teclado. Eles são muito fáceis de implementar com alguns estilos e âncoras de páginas:

\n\n

Também use elementos e pontos de referência, como <main> e <aside>, para demarcar regiões de páginas como tecnologia assistiva, permitindo que o usuário navegue rapidamente para estas seções.

\n

Leia mais sobre o uso desses elementos para melhorar a acessibilidade aqui:

\n\n

Programaticamente gerenciando o foco

\n

Aplicações em React modificam continuamente o HTML DOM durante o tempo de execução, às vezes levando à perda de foco do teclado ou a um elemento inesperado. Para consertar isso, precisamos programar o foco do teclado na direção certa, de maneira programática. Por exemplo, redefinindo o foco do teclado para um botão que abriu uma janela modal depois que essa janela restrita é fechada.

\n

Você pode encontrar mais informações de como fazer isto no MDN navegação por teclado de JavaScript widgets.

\n

Para definir o foco no React, podemos usar Refs para elementos no DOM.

\n

Dessa maneira, primeiro criamos uma referência a um elemento no JSX de uma classe de componente:

\n
class EntradaDeTexto extends React.Component {\n  constructor(props) {\n    super(props);\n    // Cria um ref para guardar o inputDeTexto no DOM     this.inputDeTexto = React.createRef();  }\n  render() {\n  // Use a `ref` callback para guardar a referencia do texto no input dentro do DOM   // elemento em um campo (por exemplo, this.inputDeTexto).    return (\n      <input\n        type=\"text\"\n        ref={this.inputDeTexto}      />\n    );\n  }\n}
\n

Então podemos nos concentrar em outro lugar em nosso componente quando necessário:

\n
focus() {\n  // Focalize explicitamente a entrada de texto usando a API DOM \n  // Nota: estamos acessando o DOM \"atual\" para obter o elemento\n  this.textInput.current.focus();\n}
\n

Às vezes, um componente pai precisa definir o foco para um elemento em um componente filho. Nós podemos fazer isso expondo as referências DOM aos componentes pais, através de um prop especial no componente filho que encaminha a referência do pai o elemento filho.

\n
function EntradaDeTexto(props) {\n  return (\n    <div>\n      <input ref={props.inputRef} />    </div>\n  );\n}\n\nclass ComponentePai extends React.Component {\n  constructor(props) {\n    super(props);\n    this.inputElement = React.createRef();  }\n  render() {\n    return (\n      <EntradaDeTexto inputRef={this.inputElement} />    );\n  }\n}\n\n// Agora você pode definir o foco quando necessário.\nthis.inputElement.current.focus();
\n

Ao usar um HOC (Componente de alta ordem) para estender componentes é recomendado encaminhar a ref para o componente de menor order usando a função de React forwardRef. Se um terceiro HOC não passar a referência, o padrão acima ainda pode ser usado como fallback.

\n

Um ótimo exemplo de gerenciamento de foco é o react-aria-modal. Este é um exemplo relativamente raro de uma janela modal totalmente acessível. Não só define o foco inicial o botão cancelar (impedindo o usuário do teclado de ativar acidentalmente a ação de sucesso) e interceptar o foco do teclado dentro do modal, ele também redefine o foco de volta para o elemento que inicialmente acionou o modal.

\n
\n

Nota:

\n

Embora esse seja um recurso de acessibilidade muito importante, também é uma técnica que deve ser usada de maneira criteriosa.\nUse-o para reparar o comportamento do foco do teclado quando ele é alterado, e não para tentar antecipar como os usuários desejam usar os aplicativos.

\n
\n

Movimentos do mouse e ponteiro (cursor)

\n

Certifique-se de que todas as funcionalidades expostas através do movimento de mouse ou ponteiro também possam ser acessadas usando apenas o teclado. Se depender apenas do movimento do mouse, haverá muitos casos em que usuários de teclado não poderão usar seu aplicativo.

\n

Para ilustrar isso, abaixo pode-se ver um exemplo clássico de quebra da acessibilidade causada por cliques. Esse é o padrão de clique externo, em que um usuário pode desativar um popover aberto clicando fora do elemento.

\n\"\n

Isso geralmente é implementado ao anexar um click ao objeto de janela que fecha o popover:

\n
class ClickForaExemplo extends React.Component {\n  constructor(props) {\n    super(props);\n\n    this.state = { isOpen: false };\n    this.toggleContainer = React.createRef();\n\n    this.onClickHandler = this.onClickHandler.bind(this);\n    this.onClickOutsideHandler = this.onClickOutsideHandler.bind(this);\n  }\n\n  componentDidMount() {    window.addEventListener('click', this.onClickOutsideHandler);  }\n  componentWillUnmount() {\n    window.removeEventListener('click', this.onClickOutsideHandler);\n  }\n\n  onClickHandler() {\n    this.setState(currentState => ({\n      isOpen: !currentState.isOpen\n    }));\n  }\n\n  onClickOutsideHandler(event) {    if (this.state.isOpen && !this.toggleContainer.current.contains(event.target)) {      this.setState({ isOpen: false });    }  }\n  render() {\n    return (\n      <div ref={this.toggleContainer}>\n        <button onClick={this.onClickHandler}>Select an option</button>\n        {this.state.isOpen && (\n          <ul>\n            <li>Option 1</li>\n            <li>Option 2</li>\n            <li>Option 3</li>\n          </ul>\n        )}\n      </div>\n    );\n  }\n}
\n

Isso pode funcionar bem para usuários com dispositivos com ponteiro, como um mouse. Mas, operá-lo apenas com o teclado quebra a funcionalidade ao passar para o próximo elemento, já que o objeto window nunca recebe um evento click. Isso pode levar a uma funcionalidade escondida que impede os usuários de usar seu aplicativo.

\n\"A\n

A mesma funcionalidade pode ser obtida usando manipuladores de eventos apropriados, como onBlur e onFocus:

\n
class ExamploDeBlur extends React.Component {\n  constructor(props) {\n    super(props);\n\n    this.state = { isOpen: false };\n    this.timeOutId = null;\n\n    this.onClickHandler = this.onClickHandler.bind(this);\n    this.onBlurHandler = this.onBlurHandler.bind(this);\n    this.onFocusHandler = this.onFocusHandler.bind(this);\n  }\n\n  onClickHandler() {\n    this.setState(currentState => ({\n      isOpen: !currentState.isOpen\n    }));\n  }\n\n  // Fechamos o popover no próximo tick usando setTimeout.  // Isso é necessário porque precisamos primeiro checar se  // outro filho do elemento recebeu foco como  // o evento blur é acionado antes do novo evento de foco.  onBlurHandler() {    this.timeOutId = setTimeout(() => {      this.setState({        isOpen: false      });    });  }\n  // Se o elemento filho receber foco, não feche o popover.  onFocusHandler() {    clearTimeout(this.timeOutId);  }\n  render() {\n    // O React nos ajuda cancelando o blur e    // focando nos eventos do elemento pai.    return (\n      <div onBlur={this.onBlurHandler}           onFocus={this.onFocusHandler}>        <button onClick={this.onClickHandler}\n                aria-haspopup=\"true\"\n                aria-expanded={this.state.isOpen}>\n          Select an option\n        </button>\n        {this.state.isOpen && (\n          <ul>\n            <li>Option 1</li>\n            <li>Option 2</li>\n            <li>Option 3</li>\n          </ul>\n        )}\n      </div>\n    );\n  }\n}
\n

Esse código expõe a funcionalidade para usuários de dispositivo de mouse e teclado. Observe também os aria-* props adicionados para suportar usuários de leitores de tela. Por motivos de simplicidade a interação com as setas nas opções de popover não foram implementados.

\n\"Uma\n

Este é um exemplo de muitos casos em que, depender apenas dos eventos de ponteiro e o mouse, pode quebrar a funcionalidade para usuários de teclado. Sempre testar com o teclado realçará imediatamente as áreas problemáticas que podem ser corrigidas usando manipuladores de eventos com reconhecimento de teclado.

\n

Widgets mais complexos

\n

Uma experiência do usuário mais complexa não significa ser menos acessível. Considerando que a acessibilidade é mais facilmente alcançada programando o mais próximo possível do HTML, até mesmo o widget mais complexo pode ser programado de forma acessível.

\n

Aqui, exigimos conhecimento de ARIA Roles, bem como ARIA States and Properties.\nEstas são caixas de ferramentas preenchidas com atributos HTML que são totalmente suportados no JSX e nos permitem construir componentes em React totalmente funcionais e totalmente acessíveis.

\n

Cada tipo de widget tem um padrão de design específico e espera-se que funcione de certa forma por usuários e agentes do usuário:

\n\n

Outros pontos a serem consideração

\n

Definindo o idioma

\n

Indique o idioma dos textos de página, pois o software leitor de tela usa isso para selecionar as configurações de voz correta:

\n\n

Definindo o título do documento

\n

Defina no documento <title> para descrever corretamente o conteúdo atual da página, pois isso garante que o usuário permaneça ciente do contexto da página atual:

\n\n

Podemos definir o titulo usando React Document Title Component.

\n

Contraste de Cor

\n

Certifique-se de que todo o texto legível em seu site tenha contraste de cores suficiente para permanecer legível ao máximo por usuários com baixa visão:

\n\n

Pode ser entediante calcular manualmente as combinações de cores adequadas para todos os casos em seu site. Em vez disso, você pode calcular uma paleta de cores inteira acessível com Colorable.

\n

As ferramentas abaixo aXe e WAVE incluem testes de contraste de cores e relatam erros de contraste.

\n

Se você quiser estender suas habilidades de teste de contraste, você pode usar estas ferramentas:

\n\n

Ferramentas de Desenvolvimento e Teste

\n

Há várias ferramentas que podemos usar para ajudar na criação de aplicativos acessíveis.

\n

O Teclado

\n

Há várias ferramentas que podemos usar para ajudar na criação de aplicativos da Web acessíveis.

\n
    \n
  1. Desconectando o seu mouse.
    2. \n
  2. Usando Tab e Shift+Tab navegue pelo site.
    3. \n
  3. Usando Enter para clicar elementos.
    4. \n
  4. Se necessário, usando o teclado e as setas, interaja com alguns elementos, como menus e dropdowns.
    5. \n
\n

Assistência ao desenvolvimento

\n

Podemos verificar alguns recursos de acessibilidade diretamente em nosso código JSX. Frequentemente, as verificações do intellisense já são fornecidas em IDEs JSX para as funções, estados e propriedades do ARIA. Nós também temos acesso à seguintes ferramentas:

\n

eslint-plugin-jsx-a11y

\n

O eslint-plugin-jsx-a11y plugin para ESLint fornece feedback sobre o linting da AST em relação a problemas de acessibilidade no seu JSX. Muitos dos IDE permitem integrar essas descobertas diretamente na análise de código e nas janelas de código-fonte.

\n

Create React App tem este plugin com um subconjunto de regras ativadas. Se você quiser ativar ainda mais regras de acessibilidade, você pode criar um arquivo .eslintrc na raiz do seu projeto com este conteúdo:

\n
{\n  "extends": ["react-app", "plugin:jsx-a11y/recommended"],\n  "plugins": ["jsx-a11y"]\n}
\n

Testando acessibilidade no navegador

\n

Existem várias ferramentas que podem executar auditorias de acessibilidade em páginas da Web em seu navegador. Por favor, use-as em combinação com outras verificações de acessibilidade mencionadas aqui, pois elas podem somente testar a acessibilidade técnica do seu HTML.

\n

aXe, aXe-core and react-axe

\n

Deque Systems oferece aXe-core para testes de acessibilidade automatizados e de ponta a ponta de seus aplicativos. Este módulo inclui integrações para o Selenium.

\n

O mecanismo de acessibilidade aXe é uma extensão de navegador de inspetor de acessibilidade construída com aXe-core.

\n

Você também pode usar o react-axe, um módulo para logar essas descobertas de acessibilidade diretamente no console durante o desenvolvimento e avaliação.

\n

WebAIM WAVE

\n

O Web Accessibility Evaluation Tool é outra extensão do navegador de acessibilidade.

\n

Inspectores de Acessibilidade e a Árvore de Acessibilidade

\n

The Accessibility Tree é um subconjunto da árvore DOM que contém objetos acessíveis para cada elemento DOM que deve ser exposto para tecnologia assistiva, como leitores de tela.

\n

Em alguns navegadores, podemos visualizar facilmente as informações de acessibilidade de cada elemento na árvore de acessibilidade:

\n\n

Leitores de tela

\n

Testar com um leitor de tela deve fazer parte de seus testes de acessibilidade.

\n

Observe que as combinações de navegador / leitor de tela são importantes. É recomendável que você teste seu aplicativo no navegador mais adequado ao seu leitor de tela preferido.

\n

Leitores de tela mais comumente usados

\n

NVDA no Firefox

\n

NonVisual Desktop Access ou NVDA é um leitor de tela do Windows de código aberto que é amplamente utilizado.

\n

Consulte os seguintes guias sobre como usar melhor o NVDA:

\n\n

VoiceOver no Safari

\n

O VoiceOver é um leitor de tela integrado em dispositivos Apple.

\n

Consulte os seguintes guias sobre como ativar e usar o VoiceOver:

\n\n

JAWS no Internet Explorer

\n

Job Access With Speech ou JAWS, é um leitor de tela muito popular, utilizado no sistema Windows.

\n

Consulte os seguintes guias sobre como ativar e usar o JAWS:

\n\n

Outros leitores de tela

\n

ChromeVox no Google Chrome

\n

ChromeVox é um leitor de tela integrado nos Chromebooks e está disponível como extensão para o Google Chrome.

\n

Consulte os guias a seguir sobre como usar melhor o ChromeVox:

\n","frontmatter":{"title":"Acessibilidade","next":null,"prev":null},"fields":{"path":"content/docs/accessibility.md","slug":"docs/accessibility.html"}}},"pageContext":{"slug":"docs/accessibility.html"}},"staticQueryHashes":[]}