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.
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.
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.