Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é aria-pressed?

    O aria-pressed informa às tecnologias assistivas se uma função está ativa em um botão de alternância. O atributo deve acompanhar o estado da interface.

    Também chamado de: estado de alternância ARIA

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    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

    O aria-pressed é um atributo de acessibilidade que informa se a função de um botão de alternância está ativa. Um leitor de tela pode apresentar esse estado junto com o nome do botão, permitindo reconhecer uma opção selecionada mesmo sem enxergar sua aparência.

    O estado acompanha a função

    Um botão de alternância mantém uma opção ativa ou inativa entre os acionamentos. O valor true indica a opção ativa e false indica a opção inativa. Já mixed descreve estados diferentes entre os itens controlados. A ausência do atributo, cujo valor padrão é undefined, significa que o controle não informa uma alternância por esse mecanismo.

    O atributo comunica o estado às tecnologias assistivas. A aplicação continua encarregada de executar a função e atualizar a apresentação visual. Acrescentar aria-pressed ao botão não cria o comportamento de alternância, conforme explica a MDN.

    Um botão Silenciar com nome estável

    Este exemplo mostra a marcação inicial de um controle de áudio com o som habilitado:

    <button type="button" aria-pressed="false">Silenciar</button>

    Ao acionar o controle, a aplicação deve silenciar o áudio e mudar o atributo para true. O nome Silenciar permanece porque o estado informa que essa função está ativa. No acionamento seguinte, o som retorna e o atributo volta para false. A marcação isolada acima não implementa essas ações.

    O padrão de botão do W3C orienta essa estabilidade do nome. Você pode conferir a implementação acionando o botão pelo teclado e comparando o áudio com o estado apresentado pelo leitor de tela. Caso o atributo mude e o áudio continue igual, a interface comunica uma condição que a aplicação não executou.

    Dúvidas frequentes

    Perguntas frequentes sobre aria-pressed

    O valor true corresponde apenas ao instante do clique?
    O valor true indica que a função da alternância está ativa. Ele permanece depois que você solta o mouse ou a tecla e muda quando a função é desativada.
    O nome do botão deve mudar junto com o estado?
    No padrão de alternância, o nome permanece estável. Um botão Silenciar usa o estado para informar se o áudio está silenciado. Um controle que alterna o nome entre Silenciar e Ativar som pode usar um botão de ação comum, sem aria-pressed.
    Quando o valor mixed faz sentido?
    Ele descreve um conjunto com estados diferentes. Um botão Negrito pode usar mixed quando a seleção reúne texto com e sem negrito. Esse valor não indica erro nem carregamento.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao revisar um botão criado com agentes de código, você precisa conferir se a função executada corresponde ao estado informado às tecnologias assistivas.

    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