Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é aria-label?

    O aria-label fornece um nome acessível a elementos que permitem nomeação. Pode identificar um botão com ícone quando falta um texto visível para a ação.

    Também chamado de: rótulo ARIA

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Um nome que as tecnologias assistivas podem usar

    O aria-label é um atributo que fornece um nome acessível a um elemento cujo papel permite nomeação. Esse nome identifica o elemento para tecnologias assistivas, como leitores de tela. Num botão que mostra apenas um ícone, ele pode comunicar a ação que o desenho representa.

    O navegador calcula o nome acessível a partir do conteúdo e das associações do elemento. Um botão com o texto “Enviar” já pode receber esse nome do próprio conteúdo. O aria-label é útil quando não há um texto adequado para essa identificação e pode substituir o nome que viria do conteúdo do botão.

    Nomear um botão que mostra um X

    O botão deste exemplo apresenta um X na tela e recebe o nome acessível “Fechar aviso”:

    <button type="button" aria-label="Fechar aviso">
    <span aria-hidden="true">×</span>
    </button>

    O aria-hidden="true" retira o desenho do cálculo do nome. O aria-label identifica o botão para a tecnologia assistiva, mas não implementa a ação de fechar o aviso. Você ainda precisa programar essa ação e conferir o nome exposto na árvore de acessibilidade do navegador.

    Correspondência com o texto visível

    Quando o controle já possui um texto visível adequado, preserve a nomeação pelo HTML ou associe esse texto com aria-labelledby. Um campo de formulário pode usar um label associado. Acrescentar um nome diferente do que aparece na tela pode dificultar o uso por comando de voz.

    O atributo nomeia o controle, mas não corrige a sua semântica ou o comportamento pelo teclado. Um elemento genérico com aria-label não adquire as funções de um botão. O guia de nomes acessíveis da W3C detalha a escolha da técnica conforme o elemento.

    Dúvidas frequentes

    Perguntas frequentes sobre aria-label

    O aria-label acrescenta texto visível à página?
    O texto do atributo participa do nome acessível e não aparece visualmente na página. Instruções necessárias para compreender a interface também precisam de uma apresentação visível adequada.
    Posso aplicar aria-label a qualquer elemento?
    O papel do elemento precisa permitir um nome acessível. Um botão admite essa nomeação, mas elementos com papéis que a proíbem não devem receber aria-label.
    Qual é a diferença para aria-labelledby?
    O aria-label contém o texto do nome. O aria-labelledby referencia os IDs dos elementos que fornecem esse texto e tem precedência quando as duas formas válidas estão presentes.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    A revisão de uma interface criada com agentes inclui conferir o nome acessível dos controles e sua correspondência com as ações apresentadas na tela.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano