Saltar al contenido

VisuallyHidden

Oculta contenido a la vista pero lo mantiene en el árbol de accesibilidad. Sirve para darle nombre textual a un control de sólo ícono, o para nombrar una región con un heading sin ocupar espacio. Reutiliza la utilidad ts sr-only.

Auxiliares · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Texto solo para lector de pantalla

Este texto se ve.Y este sólo lo lee un lector de pantalla.

html

Cuándo usarlo

  • Hay información que la vista da por el diseño y el lector de pantalla no recibe.
  • Se busca nombrar una región con un heading que no va a mostrarse.
  • Un texto de contexto ayuda a entender un control fuera de su lugar visual.

Cuándo no

  • Sólo se busca ocultar algo temporalmente: eso es display: none, y sí lo saca del árbol.
  • La información le sirve a todos: se muestra.

Cómo usarlo

  • Sirve para completar lo que la interfaz comunica sólo por posición o color.

Cómo no usarlo

  • No se esconde ahí texto para SEO ni contenido que todos deberían leer.
  • No se usa para tapar un problema de diseño: si algo no se entiende, se arregla el diseño.

Relacionados

IconButton

TaishoDS Core

No necesita JavaScript: es marcado y CSS.

Sólo CSS de ocultamiento accesible.

Sin build, desde el CDN: este componente no tiene archivo propio, se arma con taisho.base.css.

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • Oculta visualmente sin sacar del árbol de accesibilidad: es la primitiva para texto que sólo debe leer el lector de pantalla.

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.