Todos los componentes (204)
Texto oculto
Tipografía · VisuallyHidden
Qué es y cuándo usarlo
Texto que se quita de la VISTA pero no del árbol de accesibilidad: lo lee el lector de pantalla, no se ve.
Cuándo usarlo
- Para lo que la pantalla dice con la forma y el sonido no: «(se abre en otra pestaña)» detrás de un enlace, la unidad de un importe, el «de 4 pasos» de un indicador, el nombre largo de un botón que solo enseña un icono.
- Es un
span;as="div"cuando dentro va algo que no es de línea.
Cuándo no
- Para esconder algo de TODO el mundo,
hiddenodisplay: none. Esto es lo contrario. - Para el nombre de un campo cuyo rótulo no se pinta, la prop
hiddenLabeldel propio campo: además lo enlaza como etiqueta de verdad. - Para un icono decorativo,
aria-hidden, que es al revés: se ve y no se lee.
Teclado: no participa. Ojo si dentro hay algo enfocable: al enfocarlo, el foco iría a un sitio invisible.
Accesibilidad: NO es display: none ni visibility: hidden, que sacan el texto del árbol y no lo lee nadie. Es la técnica de siempre: un píxel, recortado y sin salto de línea, para que el navegador lo siga considerando texto visible.
Aspecto fino: ninguno. Es la clase .amset-hidden-visual, que no se toca.
Cómo se ve
Consulta las condiciones del servicio (se abre en otra pestaña).
84,90 € euros, IVA incluido
Lo oculto no se ve, pero el lector de pantalla lo lee: «condiciones del servicio (se abre en otra pestaña)» y «84,90 euros, IVA incluido».
<Link href="/condiciones" target="_blank">
condiciones del servicio
<VisuallyHidden> (se abre en otra pestana)</VisuallyHidden>
</Link>Props
Se importa con import { VisuallyHidden } from '@amset/ui'. Las obligatorias van marcadas.
| Prop | Tipo | Para qué sirve |
|---|---|---|
childrenobligatoria | ReactNode | — |
as | "div" | "span" | `span` por defecto; `div` cuando dentro hay algo que no es de linea. |
className | string | Se une a las clases de la biblioteca, no las sustituye. |
Acepta además los atributos del elemento que pinta: className, style, data-*, aria-* y sus eventos.
En el banco de pruebas
Cada estado y cada variante, para tocarlos de uno en uno, en su ficha de ui.amset.tech:
