전체 카탈로그
ContainerCarousel12 props

Carousel

Carousel scrolls a row of items horizontally when they overflow the available width. Use it for card grids, image galleries, product lists, or any set of items that should be br...

공식 문서 열기
live previewContainer

Preview

Import

import {Carousel} from '@astryxdesign/core/Carousel';

Astryx 문서 권장 방식대로 root barrel이 아니라 컴포넌트 subpath에서 가져옵니다.

When to use

Carousel scrolls a row of items horizontally when they overflow the available width. Use it for card grids, image galleries, product lists, or any set of items that should be br...

carouselsliderscrollgalleryfilmstripswiperhorizontaloverflow

Important props

gap0 | 0.5 | 1 | 1.5 | 2 | 3 | 4optional
padding0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10optional

Theming targets

astryx-carousel

Best practices

  • DoEnable scroll-snap when each item should land precisely at the start edge, like a gallery or product list.
  • DoAlways provide an aria-label that describes what the carousel contains, like "Featured products" or "Team members".
  • DoUse a consistent gap and item width so the carousel looks intentional, not like content overflowing by accident.
  • Do notUse a carousel for content every user must see. Not everyone scrolls horizontally, so put critical content above the fold.