Saltar al contenido
EspañolEnglish
Todos los componentes (204)

Volver arriba

Acciones · BackToTop

Qué es y cuándo usarlo

El botón de subir: aparece en una esquina cuando se ha bajado por la página, la sube de vuelta y lleva el foco al principio: al primer h1 que se vea, o al elemento cuyo id diga focusTarget. Aparece a partir de los píxeles de bajada que diga from (400 por defecto). Mientras no se ve, no está en el DOM, así que tampoco ocupa una parada del Tab.

Cuándo usarlo

  • Páginas largas de verdad: un catálogo con muchas filas, una guía, unas condiciones.
  • Junto a otro botón flotante, dentro de un FloatingGroup para que no se pisen.

Cuándo no

  • Una página que cabe en dos pantallas: no aporta nada.
  • Para saltar a una sección concreta: TableOfContents, que también se lleva el foco.
  • Cualquier otra acción flotante: FloatingButton.

Teclado: cuando aparece es un botón en el sitio del DOM donde se ponga: al final, que es donde el teclado lo espera. Intro o Espacio suben la página y dejan el foco arriba, así que el siguiente Tab sigue desde el principio y no desde la mitad. Subir solo el scroll no es volver arriba.

Accesibilidad: se llama «Volver arriba» (label), o lo que diga text si se quiere a la vista. El desplazamiento es suave, salvo con movimiento reducido, que salta sin animación. Si el destino no es enfocable, se le pone tabindex="-1" mientras tiene el foco y se le quita al salir.

Aspecto fino: es un FloatingButton de contorno: sin variables propias; se ajusta con las --amset-button-* sobre .amset-button-floating.

En esta ficha, baja dentro del marco de cada historia para que aparezca.

Cómo se ve

Baja por la página: pasados 200 píxeles, en la esquina de esta caja aparece el botón que la sube de vuelta y deja el foco en el título. En una página de verdad sale en la esquina de la ventana.

<BackToTop from={200} />

Props

Se importa con import { BackToTop } from '@amset/ui'. Las obligatorias van marcadas.

PropTipoPara qué sirve
classNamestringSe une a las clases de la biblioteca, no las sustituye.
cornerFloatingCorner—
focusTargetstringId de lo que recibe el foco al subir. Sin el, el primer `h1` de la pagina. Subir solo el scroll deja el foco donde estaba y el siguiente tabulador devuelve a media pagina: eso no es volver arriba.
fromnumberA partir de cuantos pixeles de bajada aparece. Por defecto 400.
labelstringEl nombre si no lleva texto visible.
size"sm" | "md" | "lg"—
textstringTexto visible: entonces el nombre es este.

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: