Os elementos interativos, incluindo controles de formulário, links e botões, são focalizáveis e tabuláveis por padrão. Os elementos que podem ser acessados com a tecla Tab fazem parte da ordem de navegação de foco sequencial do documento. Outros elementos são inertes, ou seja, não são interativos. Com atributos HTML, é possível tornar elementos interativos inertes e elementos inertes interativos.
Por padrão, a ordem de foco da navegação é igual à ordem visual, que é a ordem do código-fonte. Há atributos HTML que podem alterar essa ordem e propriedades CSS que podem alterar a ordem visual do conteúdo. Mudar a ordem de tabulação com HTML ou a ordem de renderização visual com CSS pode prejudicar a experiência do usuário.
Não altere a ordem de tabulação percebida e real com CSS e HTML. Como os dois exemplos a seguir demonstram, as ordens de tabulação que diferem da ordem esperada visualmente são confusas para os usuários e ruins para a experiência do usuário.
No exemplo a seguir, o valor do atributo
tabindex
deixou a ordem de tabulação caótica:
Neste exemplo, o CSS criou uma divergência entre a ordem de tabulação e a ordem visual do conteúdo:
A declaração flex-flow: row-reverse;
inverteu a ordem visual. Além disso, a propriedade CSS
order foi aplicada
à sexta palavra, "This", que moveu visualmente essa palavra. A sequência de tabulação
é a ordem do código, que não corresponde mais à ordem visual.
Isso cria uma desconexão para os usuários de teclado.
Alguns recursos de CSS, incluindo flexbox, grid, positioning, transforms e multi-column, podem alterar a ordem visual do conteúdo. Teste seu conteúdo usando a tecla Tab com um teclado: com Shift + Tab para voltar pelo conteúdo. Use CSS para indicar qual elemento está em foco. Não reordene elementos focalizáveis com CSS.
É importante manter uma ordem de tabulação lógica em todos os tamanhos de janela de visualização.
Tornar elementos inertes interativos
Os atributos contenteditable e tabindex, por serem globais, podem ser
adicionados a qualquer elemento, tornando-os focalizáveis no processo. Os elementos focalizáveis
também podem ser focalizados com um mouse ou ponteiro, definindo o
atributo
autofocus
ou por script, como com
element.focus().
O atributo tabindex
O atributo global tabindex,
introduzido em atributos, permite que
elementos que normalmente não poderiam receber foco o recebam, geralmente com Tab, daí o nome.
O atributo tabindex usa um número inteiro como valor. Um valor negativo torna
um elemento focalizável, mas não tabulável. Um valor tabindex de 0 torna o
elemento focalizável e navegável por tabulação, adicionando o elemento em que ele é aplicado à
ordem de navegação de foco sequencial na ordem do código-fonte. Um valor de 1 ou
mais torna o elemento focalizável e tabulável, mas o adiciona a uma sequência de tabulação
priorizada e deve ser evitado.
Nesta página, o botão de compartilhamento, <share-action>, é um
elemento personalizado. O tabindex="0" adiciona esse
elemento à ordem de tabulação padrão do teclado:
<share-action authors="@front-end.social/@estellevw" data-action="click"
data-category="web.dev" data-icon="share" data-label="share, mastodon"
role="button" tabindex="0">
<svg aria-label="share" role="img" xmlns="http://www.w3.org/2000/svg">
<use href="#shareIcon" />
</svg>
<span>Share</span>
</share-action>
Além disso, a navegação local
tem um elemento personalizado com um valor negativo de tabindex:
<web-navigation-drawer type="standard" tabindex="-1">
Um atributo tabindex com um valor negativo torna o elemento focalizável, mas
não tabulável. O elemento pode receber foco, como ao usar
HTMLElement.focus(),
mas não faz parte da ordem de navegação de foco sequencial. A convenção para
elementos focalizáveis que não podem ser acessados por tabulação é usar tabindex="-1". Se você adicionar
tabindex="-1" a um elemento interativo, ele não poderá mais ser acessado com a tecla Tab.
O método element.focus()
pode ser usado para definir o foco em elementos focalizáveis. Os navegadores rolam os elementos
em foco para visualização. Por esse motivo, evite o uso de
element.focus({preventScroll:true}), já que focar em um elemento não visível é uma
experiência ruim para o usuário.
Se você quiser consultar o documento para descobrir qual elemento está em foco, use a propriedade somente leitura Document.activeElement.
Os elementos com um tabindex de 1 ou maior são incluídos em uma sequência de guias
separada. Como no Codepen a seguir, a tabulação começa em uma sequência separada, em
ordem do menor para o maior valor, antes de passar pelas sequências
regulares (sem tabindex definido ou tabindex="0") na ordem de origem:
tabindex com um valor positivo coloca o elemento em uma sequência de foco priorizada, o que pode causar caos na ordem de foco. Evite
modificar a ordem do DOM com tabindex. A ordem de tabulação alterada pode criar experiências ruins para o usuário e é difícil de manter.
O atributo contenteditable
O contenteditable é um atributo
global. Definir contenteditable="true" em qualquer elemento o torna
editável, focalizável e parte da ordem de tabulação. O comportamento do foco é semelhante à
configuração de tabindex="0", mas não é o mesmo.
Os elementos contenteditable aninhados são focalizáveis, mas não podem ser acessados com a tecla Tab. Para tornar um
elemento contenteditable aninhado acessível por tabulação, adicione tabindex="0", que adiciona o
elemento à ordem de navegação de foco sequencial.
Atribuir autofocus a elementos interativos
Embora o booleano autofocus
seja um atributo global que pode ser definido em qualquer elemento, ele não torna um elemento
inerte interativo. Quando o carregamento de página, o primeiro elemento focalizável com os atributos autofocus recebe o foco, desde que esse elemento seja exibido e não esteja aninhado em um <dialog>.
Definir o foco automaticamente no conteúdo pode confundir os usuários. Quando você define
autofocus em um controle de formulário, esse controle de formulário é rolado para visualização no carregamento de página.
Os usuários, incluindo aqueles que usam leitores de tela e aqueles com janelas de visualização pequenas, podem
não ver as instruções do formulário ou até mesmo o rótulo do controle do formulário. Além disso, o
atributo autofocus não altera a ordem de navegação de foco sequencial
do documento. Os elementos na sequência que vêm antes do elemento com foco automático são ignorados. Por esses motivos, evite usar o atributo
autofocus.
A exceção à recomendação "não use autofocus" é incluir o
atributo autofocus em elementos <dialog>. Quando uma caixa de diálogo é aberta,
o navegador foca automaticamente no primeiro elemento interativo focalizável
dentro do <dialog>, o que significa que não é necessário adicionar autofocus a um
elemento. Se você quiser garantir que um elemento interativo específico na caixa de diálogo
receba o foco quando ela for aberta, adicione o atributo autofocus a esse
elemento.
<dialog open>
<form method="dialog">
<button type="submit" autofocus>close</button>
</form>
</dialog>
O atributo autofocus definido no <button> de fechamento permite que ele receba o foco
quando a caixa de diálogo é aberta. Como o primeiro elemento na caixa de diálogo, ele teria
recebido o foco de qualquer maneira. Por padrão, quando uma caixa de diálogo é aberta, o primeiro
elemento focalizável nela recebe o foco, a menos que um elemento diferente
tenha o atributo autofocus definido.
Tornar os elementos interativos inertes
Também há atributos HTML que podem remover elementos interativos da
sequência de tabulação. Incluir um tabindex negativo em elementos focalizáveis, adicionar o atributo disabled a controles de formulário compatíveis e adicionar o atributo global inert a um contêiner tornam os elementos não tabuláveis. Esses três
atributos são completamente separados e não são intercambiáveis.
Valor negativo de tabindex
Um atributo tabindex com um valor negativo torna um elemento focalizável, mas não
tabulável. Não é necessário adicionar tabindex="0" a um elemento que pode ser focado por padrão,
incluindo links, botões, controles de formulário e elementos que são contenteditable.
Incluir um tabindex com um valor negativo remove elementos normalmente
tabuláveis da ordem de navegação de foco sequencial.
Um valor negativo de tabindex impede que os usuários do teclado se concentrem em elementos
interativos, mas não desativa o elemento. Os usuários de ponteiro ainda podem focar no
elemento. Para desativar um elemento, use o atributo disabled.
Desativado
O atributo booleano disabled faz com que os controles de formulário em que ele é aplicado e os descendentes, se houver, não possam ser focados. Os controles de formulário desativados não podem ser focados, não recebem eventos de clique e não são enviados no envio do formulário.
disabled não é um atributo global. Ele se aplica a <button>, <input>,
<optgroup>, <option>, <select>, <textarea>, elementos personalizados associados a formulários
e <fieldset>.
Quando definido em <optgroup> ou <fieldset>, todos os controles de formulário filhos são
desativados, exceto o conteúdo do primeiro
<legend> do <fieldset>.
Os mesmos elementos que aceitam disabled também podem ser segmentados com as pseudoclasses
:disabled
e :enabled. Os elementos desativados com o atributo disabled geralmente
são estilizados em cinza-claro com a folha de estilo do user agent, mesmo que um
accent-color
esteja definido.
Por ser um atributo booleano, a presença dele desativa o elemento que,
caso contrário, estaria ativado. Não é possível defini-lo como false. Para reativar um elemento desativado,
o atributo precisa ser removido, geralmente com
Element.removeAttribute('disabled').
A propriedade HTMLInputElement.disabled
permite verificar se uma entrada está desativada. Como disabled não é um atributo global, ele não é herdado do HTMLElement, mas todas as interfaces de elementos compatíveis, como HTMLSelectElement e HTMLTextareaElement, têm a mesma propriedade somente leitura.
O atributo disabled não se aplica a elementos normalmente inert que se tornam
focalizáveis com tabindex ou contenteditable, nem ao
elemento <form>. Para desativar esses elementos, use o atributo global inert.
O atributo inert
Quando o atributo booleano global inert é adicionado a um elemento, ele
e todo o conteúdo aninhado são desativados, o que significa que não é possível clicar neles ou
usar a tecla Tab para acessá-los. Eles também são removidos da árvore de acessibilidade. Embora inert
possa ser aplicado a qualquer elemento, ele geralmente é usado para seções de conteúdo,
como conteúdo fora da tela ou conteúdo oculto.
Ao aplicar disabled a controles de formulário, o navegador fornece um estilo padrão
e pode ser estilizado usando a pseudoclasse
:disabled. O atributo inert não fornece indicadores visuais e não tem uma pseudoclasse correspondente (embora o seletor de atributos [inert] corresponda).
Usar inert em conteúdo visível sem estilos que indiquem a inércia pode
levar a uma experiência do usuário ruim. Como o conteúdo inerte não está disponível para usuários de leitores de tela, isso pode causar confusão quando usuários de leitores de tela com visão veem conteúdo na
tela que não está disponível para as ferramentas de acessibilidade. Deixe a inércia bem
evidente com CSS.
O foco nunca pode ser movido para conteúdo não visível. Tudo o que for renderizado fora da tela e não aparecer automaticamente quando focado precisa ser definido como inert. Se o conteúdo estiver oculto, mas aparecer quando focado, como um link para pular para o conteúdo, ele não precisará ser tornado inerte.
Teste seu conhecimento
Teste seus conhecimentos sobre foco.
Se um elemento não pode ser focado, como ele é descrito?
O que é verdadeiro se o elemento tiver um atributo disabled?