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
FloatingGrouppara 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.
| Prop | Tipo | Para qué sirve |
|---|---|---|
className | string | Se une a las clases de la biblioteca, no las sustituye. |
corner | FloatingCorner | — |
focusTarget | string | Id 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. |
from | number | A partir de cuantos pixeles de bajada aparece. Por defecto 400. |
label | string | El nombre si no lleva texto visible. |
size | "sm" | "md" | "lg" | — |
text | string | Texto 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:
