Visão geral
O editor audita continuamente a lição que está a editar face a um vasto conjunto de verificações WCAG 2.2. À medida que adiciona ou edita bricks, os problemas surgem em dois locais:
- Um distintivo em cada brick afetado — vermelho para erros, âmbar para avisos — com uma dica que resume o primeiro problema.
- O botão Acessibilidade na barra de ferramentas — mostra a contagem agregada da lição e abre o painel de acessibilidade.
A vista de curso também mostra um distintivo por lição com os totais de cada lição, calculado no servidor a partir do último estado guardado.
As verificações são apenas informativas: nunca bloqueiam guardar, exportar ou publicar.
O painel de acessibilidade
O painel lista todos os problemas agrupados por brick, pela ordem da lição. Cada entrada mostra:
- O que está errado — por exemplo, "A imagem não tem texto alternativo", com o critério de sucesso WCAG correspondente.
- Como corrigir — orientação concreta de correção.
- Botões de correção — quando existe uma correção segura de um clique (ver abaixo).
Clicar no título de um grupo desloca o editor até esse brick.
O que é verificado
| Área | WCAG | Verificações |
|---|---|---|
| Texto alternativo | 1.1.1 | Todos os slots de imagem ativos em todos os tipos de brick (incluindo itens de galeria/carrossel, faces de flashcards, pares de correspondência, avatares de diálogo, imagens de jogos, capas de carrossel). Alt vazio = explicitamente decorativo e é válido. Textos alternativos que parecem nomes de ficheiro ou que excedem 150 carateres são assinalados. |
| Vídeo | 1.2.2 / 1.2.3 | Os vídeos alojados localmente precisam de um ficheiro de legendas (erro). Os vídeos alojados em plataformas (YouTube/Vimeo) recebem um lembrete para verificar as legendas na plataforma. A ausência de transcrições é um aviso. |
| Áudio | 1.2.1 | Os bricks de áudio e os conteúdos de áudio precisam de uma transcrição. O áudio das falas de diálogo está isento — o texto da fala é a sua própria transcrição. |
| Cabeçalhos | 1.3.1 / 2.4.6 | Saltos de nível (h2 → h4), cabeçalhos de topo duplicados (o título da lição já é apresentado como o cabeçalho da página), cabeçalhos vazios e lições longas sem qualquer cabeçalho. |
| Tabelas | 1.3.1 | Tabelas sem linha ou coluna de cabeçalho (erro); células combinadas (aviso). |
| Contraste | 1.4.3 | Cores efetivas do texto e dos cabeçalhos face ao fundo efetivo, resolvendo toda a cascata: cores do tema → estilos por tipo → substituições por contentor do brick → marcas de cor/destaque em linha no texto rico. Os cabeçalhos grandes usam o limiar de 3:1. |
| Cor como única pista | 1.4.1 | Séries de gráfico ou categorias de trivia com cores quase idênticas. |
| Ligações | 2.4.4 | Ligações sem texto, com texto genérico ("clique aqui", "aquí", …) ou com um URL em bruto como texto. |
| Incorporações | 4.1.2 | Iframes sem um título acessível (preencha o campo Título acessível nas definições da incorporação). |
Correções de um clique
Os problemas com uma correção segura e determinística oferecem um botão que a aplica diretamente (um único passo de anular):
- Marcar como decorativo — define um alt vazio explícito.
- Corrigir nível de cabeçalho — define o nível que a hierarquia espera.
- Ativar linha de cabeçalho — para tabelas sem cabeçalhos.
- Usar nome da personagem — como texto alternativo do avatar do diálogo.
Os problemas de contraste incluem uma cor de substituição sugerida na mensagem — a cor mais próxima da paleta do seu tema que passa, ou uma variação ajustada da cor atual. As cores ao nível do tema são corrigidas no editor de temas, pelo que uma única alteração corrige todo o curso.
Gerar texto alternativo com IA
Os problemas de imagem oferecem Gerar alt com IA. A imagem é enviada para o modelo que a sua organização escolheu para Processamento de texto (ver Modelos de IA), que devolve uma descrição curta no idioma do conteúdo. A sugestão aparece num campo editável — nada é escrito até a aplicar. Cada geração é contabilizada com créditos, tal como as restantes funcionalidades de IA.
Limitações
- Fundos que usam gradientes, imagens ou CSS personalizado não podem ser verificados automaticamente quanto ao contraste. Em vez de arriscar uma suposição, surge um único aviso de "não verificável" — verifique-os manualmente.
- Os distintivos por lição na vista de curso refletem o último estado guardado, pelo que podem atrasar-se alguns segundos face às suas edições mais recentes.
- Os bricks de jogo (sopa de letras, forca, …) são inerentemente visuais/interativos; o verificador valida as suas imagens e textos, mas a mecânica do próprio jogo pode precisar de uma revisão manual de acessibilidade.
Rever e corrigir via MCP
O mesmo verificador está disponível para assistentes de IA ligados através do servidor MCP: audit_content_accessibility / audit_lesson_accessibility devolvem o relatório, apply_accessibility_autofix aplica uma correção e generate_accessibility_alt_text sugere texto alternativo para imagens. Útil para uma passagem "revê a acessibilidade deste curso e corrige o que puderes" conduzida por conversa.