Skip to content

Papéis do ARIA explicados

Folha de consulta dos valores de papel do ARIA: papéis de ponto de referência, de documento, de widget e de região dinâmica, com finalidade e casos de uso.

Os papéis do ARIA declaram o que um elemento faz. Os papéis de ponto de referência mapeiam as regiões da página. Os papéis de documento estruturam o conteúdo. Os papéis de widget marcam controles interativos. Os papéis de região dinâmica anunciam atualizações em tempo real.

Tabela de referência · 77 entradas
77 of 77 rows
Ponto de referência
Identifica o cabeçalho do site no topo da página.Logotipo da marca, slogan principal, topo da página.
Agrupa uma coleção de links de navegação.Menus principais, trilhas de navegação, navegação interna.
Marca o conteúdo dominante do documento.O corpo principal único da página.
Marca conteúdo de apoio separado do principal.Barras laterais, links relacionados, destaques.
Agrupa metadados de rodapé sobre o documento pai.Linhas de copyright, links de privacidade, rodapé legal.
Marca uma região que contém um formulário de busca.Busca do site, formulários de filtro, campos de localização.
Marca uma seção nomeada e perceptível da página.Seções personalizadas com um nome acessível.
Marca uma região que contém um conjunto de campos de formulário.Formulários de busca nomeados, painéis de filtro, seções de pesquisa.
Marca uma região que se comporta como um aplicativo de software.Editores de página inteira, mapas, superfícies de jogos.
Documento
Marca uma composição autossuficiente.Postagens de blog, notícias, cartões de produto.
Marca um título para uma seção de conteúdo.Títulos de seção quando os h1-h6 nativos não se aplicam.
Agrupa uma lista de itens relacionados.Listas com marcadores ou numeradas personalizadas.
Marca um único item dentro de uma lista.Uma linha de uma lista personalizada.
Agrupa um conjunto de controles de formulário relacionados.Conjuntos de campos, grupos de rádio, entradas relacionadas.
Marca conteúdo gráfico pareado com uma legenda.Imagens, diagramas, gráficos com um rótulo.
Marca dados dispostos em linhas e colunas.Dados tabulares construídos com elementos personalizados.
Marca um rótulo visível para uma tabela, grade ou figura.Títulos acima de tabelas de dados, rótulos de figuras.
Agrupa um conjunto de linhas relacionadas em uma tabela.Faixas de cabeçalho, corpo e rodapé de uma tabela.
Marca uma linha de células em uma tabela ou grade.Uma única linha de registro de uma tabela personalizada.
Marca uma célula de cabeçalho para uma coluna da tabela.Rótulos do topo de uma tabela de dados.
Marca uma célula de cabeçalho para uma linha da tabela.O rótulo inicial de cada linha da tabela.
Marca uma célula de dados dentro de uma linha.Valores individuais de uma linha de tabela personalizada.
Marca uma palavra ou frase que está sendo definida.Chaves de dicionário, termos de lista de definições.
Marca o significado do termo precedente.A descrição sob um termo definido.
Marca uma observação posicionada ao lado do conteúdo principal.Dicas, apartes, observações estilo nota de rodapé.
Marca uma lista de referências a membros do grupo.Sumários e índices de links (obsoleto no ARIA 1.2).
Marca uma lista rolável de seções de artigos.Fluxos de rolagem infinita que carregam mais conteúdo.
Marca conteúdo escrito em notação matemática.Fórmulas renderizadas de LaTeX ou MathML.
Marca um valor escalar dentro de um intervalo conhecido.Barras de uso de disco, pontuações, medidores de força.
Marca um momento específico ou uma duração.Carimbos de tempo, datas de eventos, tempos decorridos.
Marca um bloco de texto em prosa.Blocos de texto não escritos como elementos p nativos.
Marca uma citação retirada de outra fonte.Citações destacadas e trechos citados.
Marca um fragmento de código de computador.Trechos inline e nomes de comandos em prosa.
Marca texto que carrega ênfase de stress.Palavras enfatizadas dentro de uma frase.
Marca texto com forte importância.Avisos, frases-chave, rótulos de leitura obrigatória.
Marca texto renderizado abaixo da linha de base.Fórmulas químicas como H2O.
Marca texto renderizado acima da linha de base.Marcadores de nota de rodapé e expoentes.
Marca um contêiner simples sem significado especial.Invólucros de layout e ganchos de estilo.
Remove a semântica de um elemento.Imagens decorativas, tabelas de layout, elementos divisores.
Marca um elemento como uma única imagem.Sprites de ícones, grupos de SVG, gráficos desenhados com CSS.
Widget
Marca um controle clicável que dispara uma ação.Botões personalizados, botões de ícone, gatilhos de ação.
Marca um link para outro recurso ou local.Âncoras personalizadas e links de rotas no aplicativo.
Marca um alternador para uma única opção.Caixas de seleção personalizadas, alternadores de aceitação de termos.
Marca uma escolha em um grupo mutuamente exclusivo.Rádios personalizados dentro de um radiogroup.
Marca um alternador binário ligado/desligado.Alternadores de tema, mudo e configurações.
Agrupa os rótulos de um conjunto de abas.A faixa de abas de um painel com abas.
Marca um rótulo dentro de um tablist.Uma única aba que mostra um painel.
Marca o painel de conteúdo de uma aba.O corpo exibido quando sua aba está ativa.
Marca uma janela sobreposta ao topo da página.Modais, gavetas, popovers que capturam o foco.
Marca um diálogo que exige uma resposta do usuário.Confirmações de exclusão, avisos de alterações não salvas.
Marca uma entrada com um popup de escolhas.Preenchimento automático, busca com seleção, listas de sugestão.
Marca um controle que define um valor em um intervalo.Volume, preço, opacidade, entradas de intervalo.
Marca uma lista de escolhas oferecidas ao usuário.Menus suspensos, menus de contexto, paletas de ferramentas.
Marca uma única opção dentro de um menu.Uma linha ou item de um menu suspenso.
Marca um campo para entrada de texto livre.Entradas personalizadas, campos de busca, caixas de comentário.
Marca uma lista hierárquica de itens.Exploradores de arquivos, menus aninhados, organogramas.
Marca uma lista de opções selecionáveis.Seletores personalizados para uma ou várias escolhas.
Marca uma única escolha dentro de um listbox.Uma entrada selecionável de um listbox personalizado.
Agrupa um conjunto de escolhas mutuamente exclusivas.Conjuntos de rádio personalizados, seletores de plano, respostas de escala.
Marca um widget de linhas e colunas de células.Layouts de planilha, visões de mês de calendário.
Marca uma grade cujas linhas expandem e recolhem.Tabelas de dados aninhadas, tabelas de conversas de e-mail.
Marca uma opção expansível dentro de uma árvore.Um nó de arquivo ou pasta em um explorador de arquivos.
Marca um popup que dá dicas sobre um controle.Dicas de passar o mouse, sugestões de foco para botões de ícone.
Marca um elemento que mostra o progresso de uma tarefa.Barras de upload e indicadores de carregamento.
Marca um controle que rola uma visão de conteúdo.Alças de rolagem personalizadas para painéis e carrosséis.
Marca um controle que altera um valor em passos.Seletores de quantidade, contadores numéricos.
Marca um campo de texto para inserir termos de busca.Barras de busca e campos de filtro personalizados.
Marca um grupo de controles usados com frequência.Barras de formatação, linhas de ação acima de editores.
Marca uma linha de gatilhos de menu persistentes.Faixas de menu Arquivo e Editar estilo aplicativo.
Marca uma opção de menu que alterna ligado/desligado.Alternadores de opções de visão dentro de um menu suspenso.
Marca uma escolha exclusiva dentro de um menu.Escolhas de ordem de classificação e tema em um menu.
Marca um divisor entre grupos de conteúdo.Divisores de menu, separadores arrastáveis de painéis.
Região dinâmica
Anuncia uma mensagem importante e urgente.Erros de formulário, avisos urgentes que exigem atenção.
Anuncia uma atualização informativa sem interromper.Confirmação de salvamento, progresso, resultados suaves.
Anuncia novas entradas em um fluxo cronológico.Transcrições de chat, registros de eventos, feeds de atividade.
Anuncia conteúdo de texto em rolagem ou movimento.Cotações, barras de notícias rolantes, banners rotativos.
Anuncia um cronômetro ou contagem regressiva ao vivo.Tempos limite de sessão, contagens regressivas, cronômetros.