Documentação de instalação e uso
1. Instalação
- No painel (Entrar), abra o site e copie o código de instalação. Cada domínio tem a sua chave.
- Cole o código antes de
</body>em todas as páginas, ou no rodapé do tema:<script src="https://acessivel.saasul.com.br/w.js" data-chave="SUA-CHAVE" defer></script>
- Pronto: o botão de acessibilidade aparece no canto da tela. As alterações de cor, posição e recursos feitas no painel valem em até 5 minutos, sem mexer no site.
Por plataforma
- WordPress: Aparência → Editor de temas →
footer.php, ou um plugin de inserção de código no rodapé. - Joomla / Drupal / Liferay: bloco ou módulo de HTML personalizado no rodapé do template.
- Gerenciador de tags: tag HTML personalizada disparada em todas as páginas.
- Política de segurança (CSP): libere
script-srceconnect-srcparaacessivel.saasul.com.br; para Libras,vlibras.gov.br.
2. Recursos e diretrizes atendidas
| Recurso | eMAG / WCAG |
|---|---|
| Tamanho do texto (até 200%) | eMAG 4.3 · WCAG 1.4.4 |
| Espaçamento de letras, palavras e linhas | WCAG 1.4.12 |
| Fonte legível | eMAG 3.5 · WCAG 1.4.8 |
| Alto contraste (escuro, claro, invertido) | eMAG 4.1 · WCAG 1.4.3 / 1.4.6 |
| Tons de cinza | WCAG 1.4.1 |
| Destacar links | eMAG 3.5 · WCAG 1.4.1 / 2.4.4 |
| Destacar títulos | eMAG 1.3 · WCAG 2.4.6 |
| Cursor grande | WCAG 2.5 |
| Guia de leitura | Apoio cognitivo · WCAG 1.4.8 |
| Máscara de leitura | Apoio cognitivo · WCAG 1.4.8 |
| Pausar animações | eMAG 2.6 · WCAG 2.2.2 / 2.3.3 |
| Ocultar imagens | Apoio cognitivo / baixa visão |
| Leitura em voz alta (pt-BR) | Apoio à leitura · WCAG 1.4.8 |
| Destacar foco do teclado | eMAG 2.1 · WCAG 2.1.1 / 2.4.7 |
| Libras com VLibras (ferramenta do Governo Federal) | eMAG 5.4 · Lei 10.436/2002 |
| Atalho Alt+A e navegação completa por teclado | eMAG 2.1 · WCAG 2.1.1 |
| "Pular para o conteúdo" quando o site não tiver | eMAG 1.5 · WCAG 2.4.1 |
| Auditoria automática das páginas (axe-core, WCAG 2.1 A/AA) | Relatórios de gestão e evidências |
O widget complementa, mas não substitui, a correção do código das páginas. A auditoria automática do painel mostra o que precisa ser corrigido no site e onde.
3. Uso pelo cidadão
- Abrir e fechar: botão no canto da tela ou Alt+A. Esc fecha.
- Todos os comandos funcionam por teclado (Tab, Enter, Espaço) e com leitores de tela (NVDA, JAWS, VoiceOver, TalkBack).
- As escolhas ficam salvas no navegador da pessoa e valem nas próximas visitas.
- Leitura em voz alta: ative e clique em qualquer texto para ouvir.
4. Painel de gestão
- Uso: visitas com o widget, aberturas do painel e uso de cada recurso, por dia.
- Auditoria: uma amostra das visitas roda a verificação WCAG 2.1 A/AA (axe-core) na própria página e envia só os problemas encontrados (regra, gravidade e seletor do elemento). Para auditar uma página na hora, abra-a com
?ap-auditar=1no endereço. - Relatório mensal: evidências de disponibilidade, uso e conformidade, para imprimir ou salvar em PDF.
- Suporte: abertura e acompanhamento de chamados pelo painel; resposta em até 1 dia útil.
5. Requisitos e compatibilidade
Chrome, Edge, Firefox e Safari (versões atuais), Android e iOS. Script de cerca de 25 KB, carregado de forma assíncrona: não atrasa a abertura da página. Sem dependências no site do cliente.
6. Desativação
Basta remover a linha do script. Nada mais fica no site. Ao fim do contrato, os dados de uso e auditoria são entregues em planilha (CSV) e apagados a pedido.