Acessibilidade em PHP: torne seu site acessível para todos

Por que acessibilidade não é sobre "marcar checklist", mas sobre pessoas reais

Imagine: você entra em um site e o botão "Comprar" não funciona. Ou o texto se mistura ao fundo, como um camaleão no asfalto. Para uma pessoa com baixa visão ou dificuldades motoras, isso não é um "bug" — é a realidade diária. Acessibilidade (a11y) não é uma tendência passageira, é a ponte que conecta seu código a milhões de usuários.

No Brasil, segundo o IBGE, mais de 18 milhões de pessoas têm deficiência. Se somarmos idosos e limitações temporárias (braço quebrado, sol forte), o público que precisa de acessibilidade é imenso. Desenvolver em PHP com acessibilidade não é apenas ético, é inteligente: os mecanismos de busca valorizam a semântica e os usuários adoram a facilidade de uso.

Neste artigo, vamos mostrar como aplicar os princípios das WCAG (Web Content Accessibility Guidelines) diretamente no seu código PHP. Sem enrolação, com exemplos reais e soluções prontas para usar.

Por onde começar: marcação semântica e PHP

Muita gente pensa que acessibilidade é só sobre CSS e JavaScript. Mas a raiz do problema geralmente está no backend. O PHP gera o HTML, e se esse HTML for "surdo" — nenhum frontend vai salvar.

Títulos e estrutura corretos

Leitores de tela (screen readers) navegam pelos títulos. Se sua página tem um <h1> e depois um <h3> direto, é como um livro que pula do sumário para uma nota de rodapé. A hierarquia fica quebrada.

Abordagem ruim:

<?php\n// Geração de conteúdo sem pensar na semântica\necho '<div class="titulo">' . $titulo . '</div>';\necho '<div class="subtitulo">' . $subtitulo . '</div>';\n?>

Abordagem correta (Acessibilidade em PHP):

<?php\n// Estrutura semântica para leitores de tela\necho '<h1>' . htmlspecialchars($titulo, ENT_QUOTES, 'UTF-8') . '</h1>';\necho '<h2>' . htmlspecialchars($subtitulo, ENT_QUOTES, 'UTF-8') . '</h2>';\n?>

Repare no uso de htmlspecialchars() — isso é básico para segurança e acessibilidade. Caracteres especiais nos títulos podem quebrar a marcação ou ser lidos incorretamente.

Atributos ARIA: quando o HTML não é suficiente

ARIA (Accessible Rich Internet Applications) é um conjunto de atributos que complementam a semântica. Por exemplo, se você cria um menu suspenso personalizado com PHP e JavaScript, o leitor de tela precisa saber: "Ei, isso é um botão que abre um menu".

Exemplo de geração de botão compatível com ARIA:

<?php\nfunction renderizarBotaoAcessivel(string $rotulo, string $id): string {\n    return sprintf(\n        '<button id="%s" aria-expanded="false" aria-controls="menu-%s">%s</button>',\n        htmlspecialchars($id),\n        htmlspecialchars($id),\n        htmlspecialchars($rotulo)\n    );\n}\necho renderizarBotaoAcessivel('Menu', 'menu-principal');\n?>

O atributo aria-expanded informa ao leitor de tela se o menu está aberto. O aria-controls conecta o botão ao bloco do menu. É como um GPS para o usuário cego.

Trabalhando com formulários: a armadilha da acessibilidade

Formulários são o ponto mais crítico. O usuário preenche um campo, e o leitor de tela diz: "Edição de texto". Que texto? Para quê? Sem rótulos, é um jogo de azar.

Conectando label e input

No PHP, você frequentemente gera campos dinamicamente. A regra de ouro: cada <input> deve ter um <label> com o atributo for, ou o próprio input deve estar dentro do label.

Exemplo para formulário dinâmico:

<?php\n$campos = [\n    'nome' => 'Nome',\n    'email' => 'Email',\n    'telefone' => 'Telefone'\n];\nforeach ($campos as $chave => $rotulo):\n?>\n    <div class="grupo-formulario">\n        <label for="input-<?= $chave ?>"><?= $rotulo ?></label>\n        <input type="text" id="input-<?= $chave ?>" name="<?= $chave ?>">\n    </div>\n<?php endforeach; ?>