Acessibilidade & WCAG
HTML Semântico
<!-- Use elementos semânticos em vez de divs genéricos -->
<header>
<nav aria-label="Navegação principal">
<ul>
<li><a href="/" aria-current="page">Início</a></li>
<li><a href="/produtos">Produtos</a></li>
<li><a href="/sobre">Sobre</a></li>
</ul>
</nav>
</header>
<main>
<article>
<h1>Detalhes do Produto</h1>
<section aria-labelledby="especificacoes-titulo">
<h2 id="especificacoes-titulo">Especificações</h2>
<dl>
<dt>Peso</dt>
<dd>1.2 kg</dd>
<dt>Dimensões</dt>
<dd>30 x 20 x 10 cm</dd>
</dl>
</section>
</article>
</main>
<footer>
<p>© 2024 Nome da Empresa</p>
</footer>
Use <nav>, <main>, <article>, <section>, <aside> em vez de <div> para landmarks. Os leitores de tela utilizam esses elementos para navegar pela página.
Padrões ARIA
function Modal({ isOpen, onClose, title, children }) {
if (!isOpen) return null;
return (
<div
role="dialog"
aria-modal="true"
aria-labelledby="modal-titulo"
onKeyDown={(e) => e.key === "Escape" && onClose()}
>
<h2 id="modal-titulo">{title}</h2>
<div>{children}</div>
<button onClick={onClose} aria-label="Fechar diálogo">
<XIcon aria-hidden="true" />
</button>
</div>
);
}
function Abas({ tabs, activeIndex, onChange }) {
return (
<div>
<div role="tablist" aria-label="Seções de configurações">
{tabs.map((tab, i) => (
<button
key={tab.id}
role="tab"
id={`aba-${tab.id}`}
aria-selected={i === activeIndex}
aria-controls={`painel-${tab.id}`}
tabIndex={i === activeIndex ? 0 : -1}
onClick={() => onChange(i)}
onKeyDown={(e) => handleArrowKeys(e, i, tabs.length, onChange)}
>
{tab.label}
</button>
))}
</div>
{tabs.map((tab, i) => (
<div
key={tab.id}
role="tabpanel"
id={`painel-${tab.id}`}
aria-labelledby={`aba-${tab.id}`}
hidden={i !== activeIndex}
tabIndex={0}
>
{tab.content}
</div>
))}
</div>
);
}
Navegação por Teclado
function handleArrowKeys(
event: React.KeyboardEvent,
currentIndex: number,
totalItems: number,
onSelect: (index: number) => void
) {
let newIndex = currentIndex;
switch (event.key) {
case "ArrowRight":
case "ArrowDown":
newIndex = (currentIndex + 1) % totalItems;
break;
case "ArrowLeft":
case "ArrowUp":
newIndex = (currentIndex - 1 + totalItems) % totalItems;
break;
case "Home":
newIndex = 0;
break;
case "End":
newIndex = totalItems - 1;
break;
default:
return;
}
event.preventDefault();
onSelect(newIndex);
}
Todos os elementos interativos devem ser alcançáveis via teclado. Use Tab para navegação por foco, Enter/Barra de espaço para ativação e teclas de seta para navegação dentro de componentes.
Acessibilidade em Formulários
function FormularioCadastro() {
return (
<form aria-labelledby="titulo-formulario" noValidate>
<h2 id="titulo-formulario">Criar Conta</h2>
<div>
<label htmlFor="email">Endereço de e-mail</label>
<input
id="email"
type="email"
required
aria-required="true"
aria-describedby="dica-email erro-email"
aria-invalid={temErro ? "true" : undefined}
/>
<p id="dica-email">Nunca compartilharemos seu e-mail.</p>
{temErro && (
<p id="erro-email" role="alert">
Informe um endereço de e-mail válido.
</p>
)}
</div>
<button type="submit">Criar Conta</button>
</form>
);
}
Cor e Contraste
:root {
--text-primary: #1a1a1a; /* 15.3:1 sobre branco */
--text-secondary: #595959; /* 7.0:1 sobre branco */
--text-on-primary: #ffffff; /* Garantir 4.5:1 na cor da marca */
--border-focus: #0066cc; /* Anel de foco visível */
}
*:focus-visible {
outline: 3px solid var(--border-focus);
outline-offset: 2px;
}
.mensagem-erro {
color: #d32f2f;
/* Não confie apenas na cor - adicione ícone ou prefixo de texto */
}
.mensagem-erro::before {
content: "Erro: ";
font-weight: bold;
}
WCAG AA exige contraste de 4.5:1 para texto normal, 3:1 para texto grande (18px negrito ou 24px normal).
Antipadrões
- Usar
divespanpara elementos clicáveis em vez debuttonoua - Remover contornos de foco sem fornecer um indicador alternativo
- Confiar apenas na cor para transmitir informações (vermelho para erro, verde para sucesso)
- Usar
aria-labelquando o texto visível já rotula o elemento - Reproduzir mídia automaticamente sem um mecanismo de pausa
- Falta do link de navegação de pular para usuários de teclado
Checklist
- Todos os elementos interativos acessíveis por teclado (Tab, Enter, Escape, Setas)
- Landmarks de HTML semântico usados (
nav,main,article,section) - Imagens possuem texto
altdescritivo (oualt=""para decorativas) - Contraste de cores atende WCAG AA (4.5:1 texto normal, 3:1 texto grande)
- Indicadores de foco visíveis em todos os elementos interativos
- Campos de formulário possuem elementos
<label>associados - Mensagens de erro anunciadas para leitores de tela via
role="alert" - Página testada com leitor de tela (VoiceOver, NVDA) e apenas teclado