Saltar al contenido
EspañolEnglish
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, hidden o display: none. Esto es lo contrario.
  • Para el nombre de un campo cuyo rótulo no se pinta, la prop hiddenLabel del 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.

PropTipoPara qué sirve
childrenobligatoriaReactNode—
as"div" | "span"`span` por defecto; `div` cuando dentro hay algo que no es de linea.
classNamestringSe 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: