# Guia WCAG

> Referência em português para compreensão e aplicação das Web Content Accessibility Guidelines (WCAG).

Este arquivo serve como índice para agentes de IA e outros consumidores automatizados do conteúdo do Guia WCAG.

- [Versão expandida](https://guia-wcag.com/llms-full.txt): Conteúdo consolidado do Guia WCAG para consulta por agentes de IA.

## Projeto

- Site: [https://guia-wcag.com/](https://guia-wcag.com/)
- Versão: 8.5.0
- Idioma: Português (Brasil)
- Escopo: Acessibilidade digital
- Base técnica: WCAG do W3C
- Público: UX, UI, Desenvolvimento, Conteúdo, QA, Gestão de Produto, Educação e Acessibilidade

## Estrutura

### Princípio 1 — Perceptível

- 1.1 Conteúdo não textual
- 1.2 Mídias baseadas em tempo
- 1.3 Adaptável
- 1.4 Distinguível

### Princípio 2 — Operável

- 2.1 Teclado
- 2.2 Tempo suficiente
- 2.3 Convulsões e reações físicas
- 2.4 Navegação
- 2.5 Modalidades de entrada

### Princípio 3 — Compreensível

- 3.1 Legível
- 3.2 Previsível
- 3.3 Assistência de entrada

### Princípio 4 — Robusto

- 4.1 Compatível

## Recursos relacionados

- [Checklist ABNT](https://academiadeacessibilidade.com.br/ferramentas/checklist-abnt/): Checklist baseado na ABNT NBR 17225.
- [Academia de Acessibilidade](https://academiadeacessibilidade.com.br/): Cursos, materiais e ferramentas sobre acessibilidade digital.

## Integração com a ABNT NBR 17225

Os cards do Guia WCAG possuem duas faces:

- a face principal apresenta o critério WCAG em linguagem simples;
- o verso apresenta os itens correspondentes da ABNT NBR 17225, quando há referência direta ao critério.

Um mesmo critério WCAG pode estar relacionado a vários itens da norma. Cada referência apresentada no verso informa o código ABNT, o título do item, sua classificação como requisito ou recomendação e a orientação de cumprimento.

O critério 4.1.1 é mantido no Guia como referência histórica, pois foi removido da WCAG 2.2, e não possui correspondência direta no checklist da ABNT NBR 17225.

A relação detalhada entre critérios WCAG e itens ABNT está disponível na [versão expandida](https://guia-wcag.com/llms-full.txt).

## Uso da WCAG com LLMs

LLMs podem ajudar a compreender, planejar e documentar avaliações de acessibilidade, mas não comprovam sozinhas a conformidade com a WCAG. Seu uso não substitui fontes oficiais, testes manuais, tecnologias assistivas, avaliações com pessoas com deficiência ou revisão especializada.

### Preparar

- **Use a versão correta da WCAG:** informe à LLM a versão, o nível de conformidade e o identificador exato do critério. Confira as referências na versão oficial da WCAG.
- **Forneça o contexto da interface:** descreva o produto, a página, o componente, o conteúdo, as formas de interação, o comportamento observado e o comportamento esperado. Não compartilhe dados pessoais, credenciais ou informações confidenciais.

### Analisar

- **Peça explicações, não vereditos:** use a LLM para compreender critérios, termos e exemplos, sem pedir que ela declare automaticamente a conformidade.
- **Transforme critérios em roteiros de teste:** solicite pré-condições, ferramentas, passos, resultados esperados, possíveis falhas, evidências e verificações manuais. A execução e o registro dos testes permanecem sob responsabilidade humana.
- **Analise poucos critérios por vez:** trabalhe com um critério ou um pequeno conjunto relacionado para obter respostas específicas e rastreáveis.

### Validar

- **Diferencie critérios, técnicas e boas práticas:** critérios de sucesso determinam conformidade; documentos de compreensão auxiliam a interpretação; técnicas apresentam formas possíveis de atendimento; boas práticas adicionais não são automaticamente obrigatórias.
- **Registre evidências sem inventar resultados:** use a LLM para organizar fatos observados e indique como “não verificada” qualquer informação ausente.
- **Mantenha a decisão final com pessoas:** confirme respostas nas fontes oficiais, registre dúvidas como pendentes e encaminhe casos ambíguos para pessoas especialistas.

## Orientações

Ao utilizar este conteúdo:

- preservar a numeração oficial dos critérios WCAG;
- utilizar os nomes oficiais dos critérios;
- diferenciar critérios, técnicas, falhas e boas práticas;
- priorizar a intenção do critério antes da implementação técnica;
- utilizar exemplos práticos quando possível;
- considerar diferentes soluções para um mesmo requisito;
- consultar a documentação oficial do W3C em caso de dúvida normativa.

## Fonte oficial

- [Fonte oficial WCAG](https://www.w3.org/WAI/standards-guidelines/wcag/): Documentação oficial do W3C.