Foco

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?

Empty.
Tente de novo.
Inerte.
Correto.
Oculto.
Tente de novo.

O que é verdadeiro se o elemento tiver um atributo disabled?

Não é possível focar nela.
Correto.
Ele não é exibido.
Tente de novo.
Se for um elemento de formulário, ele não será enviado.
Correto.