Enfoque

Los elementos interactivos, incluidos los controles de formulario, los vínculos y los botones, se pueden enfocar y tabular de forma predeterminada. Los elementos que admiten tabulación forman parte del orden de navegación secuencial del enfoque del documento. Otros elementos son inertes, lo que significa que no son interactivos. Con los atributos HTML, es posible hacer que los elementos interactivos sean inertes y que los elementos inertes sean interactivos.

De forma predeterminada, el orden de enfoque de navegación es el mismo que el orden visual, que es el orden del código fuente. Existen atributos HTML que pueden alterar este orden y propiedades CSS que pueden alterar el orden visual del contenido. Cambiar el orden de tabulación con HTML o el orden de renderización visual con CSS puede perjudicar la experiencia del usuario.

No alteres el orden de tabulación percibido y real con CSS y HTML. Como se demuestra en los siguientes dos ejemplos, los órdenes de tabulación que difieren del orden esperado visualmente son confusos para los usuarios y perjudiciales para la experiencia del usuario.

En el siguiente ejemplo, el valor del atributo tabindex hace que el orden de tabulación sea caótico:

En este ejemplo, CSS creó una divergencia entre el orden de tabulación y el orden visual del contenido:

La declaración flex-flow: row-reverse; invirtió el orden visual. Además, se aplicó la propiedad order de CSS a la sexta palabra, "This", lo que movió visualmente esa palabra. La secuencia de tabulación es el orden del código, que ya no coincide con el orden visual. Esto genera una desconexión para los usuarios de teclado.

Algunas funciones de CSS, como flexbox, grid, positioning, transforms y multi-column, pueden alterar el orden visual del contenido. Prueba tu contenido navegando por él con la tecla Tab de un teclado: con Mayúsculas + Tab para retroceder por el contenido. Usa CSS para indicar qué elemento tiene el foco. No reordenes los elementos enfocables con CSS.

Es importante que mantengas un orden lógico de tabulación en todos los tamaños de viewport.

Cómo hacer interactivos los elementos inertes

Los atributos contenteditable y tabindex, que son globales, se pueden agregar a cualquier elemento, lo que los hace enfocables en el proceso. Los elementos enfocables también se pueden enfocar con un mouse o un puntero, con el atributo autofocus establecido o con una secuencia de comandos, como element.focus().

El atributo tabindex

El atributo global tabindex, que se presenta en Atributos, permite que los elementos que, de lo contrario, no podrían recibir el enfoque, lo obtengan, por lo general, con Tab, de ahí el nombre.

El atributo tabindex toma como valor un número entero. Un valor negativo hace que un elemento sea enfocable, pero no navegable con la tecla Tab. Un valor tabindex de 0 hace que el elemento sea enfocable y se pueda tabular, lo que agrega el elemento en el que se aplica al orden de navegación de enfoque secuencial en el orden del código fuente. Un valor de 1 o más hace que el elemento sea enfocable y se pueda tabular, pero lo agrega a una secuencia de tabulación priorizada y debe evitarse.

En esta página, el botón para compartir, <share-action>, es un elemento personalizado. El tabindex="0" agrega este elemento al orden de tabulación predeterminado del 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>

Además, la navegación local tiene un elemento personalizado con un valor tabindex negativo:

<web-navigation-drawer type="standard" tabindex="-1">

Un atributo tabindex con un valor negativo hace que el elemento sea enfocable, pero no se puede tabular. El elemento puede recibir el foco, por ejemplo, con HTMLElement.focus(), pero no forma parte del orden de navegación secuencial del foco. La convención para los elementos enfocables que no se pueden tabular es usar tabindex="-1". Si agregas tabindex="-1" a un elemento interactivo, ya no se podrá tabular.

El método element.focus() se puede usar para establecer el enfoque en los elementos enfocables. Los navegadores desplazan los elementos enfocados para que se vean. Por este motivo, evita el uso de element.focus({preventScroll:true}), ya que enfocarse en un elemento no visible es una mala experiencia del usuario.

Si quieres consultar el documento para saber qué elemento tiene el foco, usa la propiedad de solo lectura Document.activeElement.

Los elementos con un tabindex de 1 o más se incluyen en una secuencia de pestañas independiente. Como en el siguiente Codepen, la tabulación comienza en una secuencia separada, en orden del valor más bajo al más alto, antes de pasar por los de la secuencia normal (sin tabindex establecido o tabindex="0") en el orden de origen:

tabindex con un valor positivo coloca el elemento en una secuencia de enfoque priorizada, lo que puede generar caos en el orden de enfoque. Evita modificar el orden del DOM con tabindex. El orden de tabulación alterado puede crear malas experiencias del usuario y es difícil de mantener.

El atributo contenteditable

contenteditable es un atributo global. Si configuras contenteditable="true" en cualquier elemento, este se vuelve editable, enfocable y parte del orden de tabulación. El comportamiento de enfoque es similar a configurar tabindex="0", pero no es el mismo.

Los elementos contenteditable anidados se pueden enfocar, pero no se puede navegar por ellos con la tecla Tab. Para que se pueda tabular un elemento contenteditable anidado, agrega tabindex="0", que agrega el elemento al orden de navegación de enfoque secuencial.

Asigna autofocus a los elementos interactivos

Si bien el valor booleano autofocus es un atributo global que se puede establecer en cualquier elemento, no hace que un elemento inerte sea interactivo. Cuando se carga la página, el primer elemento enfocable con los atributos autofocus recibe el foco, siempre que ese elemento se muestre y no esté anidado en un <dialog>.

Establecer automáticamente el enfoque en el contenido puede confundir a los usuarios. Cuando configuras autofocus en un control de formulario, ese control se desplaza para que se vea cuando se carga la página. Es posible que tus usuarios, incluidos los que usan lectores de pantalla y los que tienen viewports pequeños, se pierdan las instrucciones del formulario o incluso la etiqueta del control del formulario. Además, el atributo autofocus no altera el orden de navegación de enfoque secuencial del documento. Se omiten los elementos de la secuencia que preceden al elemento enfocado automáticamente. Por estos motivos, debes evitar usar el atributo autofocus.

La excepción a la recomendación "no usar autofocus" es incluir el atributo autofocus dentro de los elementos <dialog>. Cuando se abre un diálogo, el navegador se enfoca automáticamente en el primer elemento interactivo enfocable dentro de <dialog>, lo que significa que no es necesario agregar autofocus a un elemento. Si quieres asegurarte de que un elemento interactivo específico dentro del diálogo reciba el foco cuando se abra el diálogo, agrega el atributo autofocus a ese elemento.

<dialog open>
  <form method="dialog">
    <button type="submit" autofocus>close</button>
  </form>
</dialog>

El atributo autofocus establecido en el elemento <button> de cierre permite que reciba el foco cuando se abre el diálogo. Como es el primer elemento del diálogo, recibiría el foco de todos modos. De forma predeterminada, cuando se abre un diálogo, el primer elemento enfocable dentro del diálogo recibe el foco, a menos que se haya establecido el atributo autofocus en otro elemento dentro del diálogo.

Inhabilita los elementos interactivos

También hay atributos HTML que pueden quitar elementos interactivos de la secuencia de tabulación. Incluir un tabindex negativo en los elementos enfocables, agregar el atributo disabled a los controles de formulario compatibles y agregar el atributo global inert a un contenedor hace que los elementos no se puedan tabular. Estos tres atributos son completamente independientes y no se pueden intercambiar.

Valor tabindex negativo

Un atributo tabindex con un valor negativo hace que un elemento sea enfocable, pero no tabulable. Si bien no es necesario agregar tabindex="0" a un elemento que se puede enfocar de forma predeterminada, incluidos los vínculos, los botones, los controles de formulario y los elementos que son contenteditable, incluir un tabindex con un valor negativo quita los elementos que normalmente se pueden tabular del orden de navegación de enfoque secuencial.

Un valor negativo de tabindex impide que los usuarios de teclado se enfoquen en elementos interactivos, pero no inhabilita el elemento. Los usuarios de punteros aún pueden enfocarse en el elemento. Para inhabilitar un elemento, usa el atributo disabled.

Inhabilitado

El atributo booleano disabled hace que los controles de formulario en los que se aplica y sus descendientes, si los hay, no se puedan enfocar. Los controles de formulario inhabilitados no se pueden enfocar, no reciben eventos de clic y no se envían cuando se envía el formulario.

disabled no es un atributo global. Se aplica a <button>, <input>, <optgroup>, <option>, <select>, <textarea>, elementos personalizados asociados a formularios y <fieldset>. Cuando se establece en <optgroup> o <fieldset>, se inhabilitan todos los controles de formulario secundarios, excepto el contenido del primer <legend> de <fieldset>.

Los mismos elementos que admiten disabled también se pueden segmentar con las seudoclases :disabled y :enabled. Los elementos que se inhabilitan con el atributo disabled suelen tener un estilo gris claro con la hoja de estilo del usuario-agente, incluso si se establece un accent-color.

Como es un atributo booleano, su presencia inhabilita el elemento que, de lo contrario, estaría habilitado; no puedes establecerlo en false. Para volver a habilitar un elemento inhabilitado, se debe quitar el atributo, por lo general, con Element.removeAttribute('disabled').

La propiedad HTMLInputElement.disabled te permite verificar si una entrada está inhabilitada. Como disabled no es un atributo global, no se hereda del HTMLElement, pero cada interfaz de elemento compatible, como HTMLSelectElement, HTMLTextareaElement, tiene la misma propiedad de solo lectura.

El atributo disabled no se aplica a los elementos inert normales que se pueden enfocar con tabindex o contenteditable, ni tampoco al elemento <form>. Para inhabilitar estos elementos, se puede usar el atributo global inert.

El atributo inert

Cuando se agrega el atributo booleano global inert a un elemento, ese elemento y todo el contenido anidado se inhabilitan, lo que significa que no se puede hacer clic en ellos ni presionar la tecla Tab para acceder a ellos. También se quitan del árbol de accesibilidad. Si bien inert se puede aplicar a cualquier elemento, por lo general, se usa para secciones de contenido, como contenido fuera de la pantalla o contenido oculto.

Cuando se aplica disabled a los controles de formulario, el navegador proporciona un diseño predeterminado y se puede diseñar con la seudoclase :disabled. El atributo inert no proporciona indicadores visuales y no tiene una seudoclase coincidente (aunque el selector de atributos [inert] coincide).

Usar inert en contenido visible sin estilos que indiquen la inercia puede generar una experiencia del usuario deficiente. Como el contenido inerte no está disponible para los usuarios de lectores de pantalla, puede generar confusión cuando los usuarios de lectores de pantalla con visión ven contenido en la pantalla que no está disponible para las herramientas de accesibilidad. Haz que la inercia sea muy evidente con CSS.

Asegúrate de que el enfoque nunca se mueva al contenido no visible. Todo lo que se renderice fuera de la pantalla y no aparezca automáticamente cuando se enfoque debe hacerse inerte. Si el contenido está oculto, pero se muestra cuando se enfoca, como un vínculo para saltar al contenido, no es necesario que se vuelva inerte.

Verifica tus conocimientos

Pon a prueba tus conocimientos sobre el enfoque.

Si no se puede enfocar un elemento, ¿cómo se describe?

Vacío.
Vuelve a intentarlo.
Inercial
Correcto.
Se ocultó.
Vuelve a intentarlo.

¿Qué es verdadero si el elemento tiene un atributo disabled?

No se puede enfocar.
Correcto.
No se muestra.
Vuelve a intentarlo.
Si es un elemento de formulario, no se envía.
Correcto.