Saltar al contenido
Alea0.1
Pro
  1. Alea
  2. Componentes
  3. Navegación
  4. SkipLink y VisuallyHidden

Navegación

SkipLink y VisuallyHidden

El primer enlace de la página salta la navegación; el texto oculto da a los lectores de pantalla el contexto que la pantalla ya muestra.

import { SkipLink, VisuallyHidden } from '@alea/ui';

Ejemplos

Tokens

Los tokens de diseño que usa este componente, con su valor en el tema actual. Cambia cualquiera para darle otro estilo.

Color

  • --alea-chip-bg…
  • --alea-chip-text…
  • --alea-focus…

Radius

  • --alea-radius-full…

Type

  • --alea-font-family-body…
  • --alea-font-size-md…
  • --alea-font-weight-semibold…

Motion

  • --alea-motion-duration-base…
  • --alea-motion-ease-out…

Layer

  • --alea-z-toast…

Props

VisuallyHidden props

Contenido solo para lectores de pantalla: se lee, nunca se ve.

PropTipoPor defectoDescripción
childrenobligatoriaReactNode-Texto que solo deben escuchar los lectores de pantalla.
as"div" | "h2" | "h3" | "p" | "span"-Se muestra como otro elemento. Por defecto span.

Especificaciones

Generado desde el código: las variantes de los tipos, los estados y tokens del CSS, y los patrones de motion que aplican. Las grillas muestran el componente real en ambos temas; los números se miden en la página.

SkipLink

Estados
Focus (CSS)
Oscuro y claro
Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
Clases para estilos
.alea-skip-link

VisuallyHidden

Variantes
asdivh2h3pspan
Oscuro y claro
Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
Clases para estilos
.alea-visually-hidden

Accesibilidad

  • SkipLink está oculto hasta que recibe foco, y entonces aparece arriba a la izquierda. Ponlo primero en el body y dale a tu elemento main el mismo id.
  • VisuallyHidden mantiene el texto en el árbol de accesibilidad; nunca lo uses para ocultar cosas que necesita quien ve y usa teclado.

Teclado

TeclaAcción
Tab (el primero)Muestra el enlace para saltar
EnterSalta al contenido

Qué hacer y qué evitar

Hacer

  • Pon SkipLink primero en cada página con navegación antes del contenido.
  • Usa VisuallyHidden para contexto como "(se abre en una pestaña nueva)".

Evitar

  • No ocultes controles que reciben foco con VisuallyHidden.
  • No apuntes el skip link a un elemento sin el id.
Probado con axe, teclado y roles de lector de pantalla