ACCESIBILIDAD ≠ OVERLAY · 44
Botões que respondem ao seu nome ao navegar por voz
📅 19 de novembro de 2026 · ⏱ 6 min de leitura
Vê um botão com o texto «Adicionar ao carrinho» e pede à ferramenta de voz que o ative. Nada acontece. O botão funciona com rato e teclado, mas o nome acessível diz «Comprar produto». A pessoa está a dizer as palavras que a loja apresenta. Para descobrir a causa, compare o texto visível com o nome que o navegador disponibiliza às tecnologias de apoio. Nesta entrega seguimos esse percurso desde a ficha até ao carrinho, incluindo variantes, estados de espera e versões traduzidas.
01. Comece pelo texto que a pessoa vê
Numa ficha simples, o próprio conteúdo do botão pode fornecer o nome acessível. Um elemento button com o texto «Adicionar ao carrinho» costuma transmitir essas palavras sem outra etiqueta. Registe o texto completo apresentado antes da ativação, incluindo informações que mudam quando é escolhida uma variante. Se o botão diz «Reservar», essa palavra deve ser reconhecível na lista de botões de um leitor de ecrã. A mesma referência permite passar da observação à leitura em voz alta e ao comando por voz. Inclua ligações com aspeto de botão e ações em cartões de produtos. A aparência pode ser igual apesar de o código ter origens diferentes.
02. Veja o nome calculado pelo navegador
Localize o controlo na árvore de acessibilidade das ferramentas de desenvolvimento. Procure o nome calculado e compare-o com o texto visível. Um aria-label pode substituir o nome que viria do conteúdo do botão. O aria-labelledby pode obter texto de outros elementos através dos seus identificadores. Verifique cada referência, pois um identificador errado pode apontar para o nome de outro produto. O resultado parece descritivo, mas refere uma ação diferente. Depois ouça o controlo com um leitor de ecrã. Esta segunda verificação mostra o que chega à pessoa e permite detetar controlos duplicados perto da mesma ficha. Guarde as duas versões do nome para facilitar a reprodução do problema.
03. Acrescente contexto mantendo a etiqueta visível
Num catálogo de casacos, «Adicionar ao carrinho» pode aparecer muitas vezes. Um nome como «Adicionar ao carrinho, casaco azul» mantém a referência visível e identifica o produto. Colocar as palavras visíveis no início facilita reconhecê-las. O critério 2.5.3 das WCAG 2.2 exige que o nome contenha o texto da etiqueta visível quando esta inclui texto ou uma imagem de texto. Escolha o contexto de acordo com os cartões reais. Uma cor pode ser insuficiente se vários produtos azuis aparecem juntos. Ouça a lista de controlos sem consultar a disposição visual e confirme se consegue selecionar o artigo pretendido de forma clara.
04. Siga o botão através dos seus estados
Selecione um tamanho, mude a cor e volte à ação de compra. Confirme que o contexto corresponde à variante escolhida. Se o botão ficar indisponível até completar uma escolha, as instruções devem explicar o que falta. Depois de o ativar, verifique o nome durante a espera e após a resposta do servidor. Uma mudança visível para «A adicionar» precisa de uma expressão compreensível para quem ouve. O resultado também deve ser anunciado, como vimos na entrega anterior. Registe cada estado para distinguir um nome incorreto de uma operação ainda pendente. Por fim, confirme o produto e a quantidade no carrinho antes de avançar para o passo seguinte.
05. Examine o resultado da página em Divi
No WordPress, o texto de um módulo pode combinar-se com atributos acrescentados pelo tema, uma extensão ou uma personalização. Veja a ficha publicada para conhecer o resultado final. O editor ajuda a encontrar a origem, enquanto o nome calculado revela o que o navegador apresenta em conjunto. Se existir um aria-label antigo, verifique se é necessário e se inclui a etiqueta atual. Quando basta o texto do botão, usá-lo como fonte do nome reduz o número de cadeias a atualizar. Inclua os modelos móveis, produtos relacionados e cartões promocionais. Podem usar módulos diferentes com o mesmo aspeto, mantendo configurações antigas que não aparecem na ficha principal.
06. Teste os idiomas ao longo do percurso
Uma tradução pode alterar o texto visível e conservar um aria-label noutro idioma. O controlo continua com um nome, mas quem o vê e ouve recebe referências diferentes. Abra cada idioma da loja, escolha um produto e compare os nomes. Verifique também o idioma do documento, que ajuda a pronúncia do leitor de ecrã. As mensagens de espera e o contexto do produto exigem a mesma revisão que a etiqueta inicial. Se várias pessoas editam o catálogo, documente onde se traduzem os atributos. Assim, uma alteração à ação visível pode atualizar as cadeias relacionadas. Guarde um produto simples e outro com variantes, com as opções exatas usadas no teste.
07. Experimente a voz com o Blind Reader
O Blind Reader permite navegar por voz e oferece um percurso de compra no WooCommerce, PrestaShop e Odoo. No Chrome ou Edge, ative a voz e consulte a ajuda para saber que ordens estão disponíveis na página. Procure o produto, escolha as opções e chegue à ação de compra. A ajuda explica o que a ferramenta reconhece. A inspeção do nome acessível verifica o que a própria loja comunica. Registe as duas observações, porque ferramentas diferentes podem ter comandos diferentes. Repita a tarefa com o teclado e um leitor de ecrã. Confirme se identifica o mesmo artigo e consegue consultar a quantidade efetivamente adicionada ao carrinho.
08. Registe um caso reproduzível
Escolha uma ficha e anote o endereço, idioma, variante e largura da janela. Guarde o texto visível, o nome calculado e a mensagem do leitor. Acrescente a ordem de voz e a ação que realmente ocorreu. Repita num catálogo com vários botões iguais para confirmar que o contexto permite escolher o produto pretendido. Uma ferramenta automática pode identificar algumas diferenças. A tarefa de compra verifica o resultado da ativação. Volte aos mesmos exemplos depois de atualizar o Divi, traduzir etiquetas ou alterar a integração do Blind Reader. Termine quando a pessoa conseguir reconhecer o botão, executar a ação prevista e verificar o produto adicionado, incluindo as opções selecionadas e a quantidade correta.
09. Ouça a referência completa do produto
No catálogo, ouça o nome completo do botão antes de o ativar. Se incluir um tamanho, confirme que corresponde à seleção atual. Repita depois de ordenar os resultados ou mudar de página do catálogo. Um cartão reutilizado pode manter uma referência a um identificador anterior. Registe o artigo que chegou realmente ao carrinho e compare com o que pretendia escolher. Assim pode localizar se a diferença está na etiqueta, na referência que fornece o nome ou na ação executada pelo módulo. Guarde o resultado junto da ficha testada.

