Skip to content

Carousel

El Carousel muestra varios elementos de la misma familia en un espacio reducido. El usuario lo recorre con flechas, teclado, arrastre o swipe, sin que la interfaz se sobrecargue.

  • Mostrar múltiples elementos relacionados en un espacio reducido.
  • Destacar contenido visual sin sobrecargar la pantalla.
  • Aprovechar el desplazamiento táctil natural en mobile.

El Carousel es una estructura: el contenido de cada slide lo diseña el UX como un componente local (card, imagen, saldo) y lo coloca dentro del slot.

  1. Título: encabezado de la sección. Se puede cambiar su tamaño visual sin alterar su nivel de jerarquía.
  2. Descripción (opcional): texto de apoyo debajo del título.
  3. Controles: flechas anterior y siguiente. Si hay autoplay, se suma el botón pausa / play.
  4. Difuminado izquierdo: indica que hay contenido previo. Desaparece al estar en el inicio.
  5. Difuminado derecho: indica que hay más contenido. Desaparece al llegar al final.
  6. Slot: los slides con el contenido local del UX.
  1. Slot: una promoción por slide. Toda la imagen es accionable y tiene esquinas redondeadas (radio 3xl).
  2. Indicadores: un punto por promoción. El activo se estira y se va llenando mientras corre el tiempo del autoplay. Al tocar un punto se va a esa promoción.
  3. Pausa / play: Action Icon outline, a la derecha de los indicadores.

No lleva título visible; se nombra para lectores de pantalla como “Promociones”.

  1. Slot: una cuenta por slide. Cada cuenta es un Paper lg (fondo blanco, radio 2xl, sombra xs); el carousel no tiene contenedor propio. El contenido lo arma el UX como componente local: etiqueta de la cuenta, saldo, detalle (límite y disponible) y accesos rápidos.
  2. Flechas: fijas arriba a la derecha de la cuenta visible, siempre visibles. No se mueven al cambiar de cuenta; la card nueva entra deslizándose y se ve el gap entre los dos Papers.

La primera fila de la card (la etiqueta) debe dejar libre el espacio de las flechas, para que no se superpongan con etiquetas largas.

  • Default: flechas activas en color primario y difuminados visibles según haya contenido oculto.
  • Hover: las flechas muestran un fondo primario suave. Con mouse, el cursor indica que el contenido se puede arrastrar.
  • Focus: anillo de foco visible en cada flecha y en cada elemento accionable del slide.
  • Active / arrastrando: el cursor cambia a “agarrado” y el autoplay se detiene.
  • Disabled: sin loop, la flecha anterior pasa a fondo gris con borde e ícono neutros en el inicio, y la siguiente al final. Siguen siendo alcanzables con teclado, para que el lector anuncie que no hay más.
  • Pausado: al tocar una flecha o un indicador, arrastrar o presionar pausa, el autoplay se frena y el botón cambia a play. Pasar el mouse o el foco por encima también lo detiene de forma temporal.
  • Un solo slide: se ocultan flechas, indicadores y pausa.
  • Listas de cards o imágenes con la misma estructura: contactos frecuentes, servicios agregados, productos.
  • Promociones, destacados, testimonios o banners.
  • Contenido que se puede explorar en orden y donde no es necesario verlo todo a la vez.
  • Contenido crítico que el usuario no puede perderse (términos legales, alertas). Usá contenido estático.
  • Elementos sin relación entre sí. Separalos en secciones.
  • Para comparar elementos lado a lado. Usá una grilla o una tabla.
  • Listas largas que el usuario necesita recorrer completas. Usá una lista con “ver todos”.
  • Mantené el mismo tamaño y estructura en todos los slides.
  • Dejá asomar parte de la siguiente card en mobile para que se entienda que hay más contenido.
  • No abuses de la cantidad de slides; más de 8 dificulta llegar al final.
  • Usá los tokens de gap carousel/gap: 16 px en desktop y 8 px en mobile (1 rem y 0,5 rem).
  • El carousel nunca debe bloquear el scroll vertical de la página.
  • El autoplay es solo para promociones; en carruseles con acciones internas genera errores de toque.

Se usa en secciones internas, como contactos frecuentes o servicios agregados. Arranca sin loop y con arrastre libre (el contenido se detiene donde lo suelta el usuario). El UX define el tamaño del título y cómo se dimensionan las cards:

  • Cantidad por vista: las cards se estiran para ocupar el ancho disponible. Sirve para productos o banners.
  • Ancho fijo: cada card mide siempre lo mismo y entran más o menos según la pantalla. Es lo recomendado para contactos frecuentes. La última card visible debe quedar cortada, para que se entienda que hay más.

Todas las cards de un carousel miden lo mismo de alto: toman la altura de la más alta. Los nombres largos se cortan en dos líneas con puntos suspensivos.

  • Loop: opcional, desactivado por defecto.
  • Autoplay: opcional, cada 3 segundos, siempre con botón de pausa visible.
  • Ancho completo en mobile: cada slide ocupa el 100% del ancho.
  • Accionable: toda la card clickeable, o con acciones internas. Con acciones internas, el foco va a cada acción y no a la card.

Exclusivo para promociones. Muestra una promoción por vez, sin difuminado ni flechas. Hace loop, avanza solo cada 3 segundos y se encastra en cada slide. El indicador activo funciona como barra de tiempo: se llena durante esos 3 segundos y se frena mientras el usuario tiene el mouse o el foco encima. Tocar un indicador o arrastrar pausa el autoplay; play lo reanuda desde cero. Al pausar, el indicador activo queda lleno.

Todas las imágenes de un mismo carousel deben tener la misma proporción, para que la altura no salte al cambiar de promoción. Cada promoción necesita un texto alternativo que explique la oferta completa, no solo el nombre de la imagen.

Exclusivo para cuentas del usuario. No hace loop y muestra una cuenta por vez. Las flechas quedan fijas arriba a la derecha y se deshabilitan en los extremos; al avanzar, la cuenta nueva entra deslizándose y se ve el espacio entre cards. El saldo lleva al detalle de la cuenta y las acciones secundarias (Alias / CBU, Transferir, Movimientos) se alcanzan con Tab. El orden de foco es primero el contenido de la cuenta y después las flechas.

Dos tonos según el fondo: surface cuando el carousel está sobre el fondo de la página y paper cuando está dentro de un Paper. La variante Cuentas no lo usa.

  • El carrusel se anuncia con su título, o con un nombre (“Promociones”, “Mis cuentas”) cuando no tiene título visible.
  • Cada slide se anuncia como “X de N” para que el usuario sepa cuántos hay.
  • Al cambiar de slide manualmente se anuncia la posición. Mientras el autoplay avanza no se anuncia, para no interrumpir al lector.
  • Las flechas se nombran según el contenido: “Siguiente contacto”, “Contacto anterior”. En Cuentas incluyen la posición de destino.
  • El botón pausa / play informa su estado.
  • Si el usuario pidió reducir el movimiento en su sistema, el autoplay no arranca solo y las transiciones son instantáneas.