ant-design/components/carousel/index.en-US.md

2.9 KiB
Raw Blame History

category group title description cover coverDark demo
Components Data Display Carousel A set of carousel areas. https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*bPMSSqbaTMkAAAAAAAAAAAAADrJ8AQ/original https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*a-58QpYnqOsAAAAAAAAAAAAADrJ8AQ/original
cols
2

When To Use

  • When there is a group of content on the same level.
  • When there is insufficient content space, it can be used to save space in the form of a revolving door.
  • Commonly used for a group of pictures/cards.

Examples

Basic Position Scroll automatically Fade in Arrows for switching Component Token

API

Common props refCommon props

Property Description Type Default Version
arrows Whether to show switch arrows boolean false 5.17.0
autoplay Whether to scroll automatically boolean false
autoplaySpeed Delay between each auto scroll (in milliseconds) number 3000
adaptiveHeight Adjust the slide's height automatically boolean false
dotPosition The position of the dots, which can be one of top bottom left right string bottom
dots Whether to show the dots at the bottom of the gallery, object for dotsClass and any others boolean | { className?: string } true
draggable Enable scrollable via dragging on desktop boolean false
fade Whether to use fade transition boolean false
infinite Infinitely wrap around contents boolean true
speed Animation speed in milliseconds number 500
easing Transition interpolation function name string linear
effect Transition effect scrollx | fade scrollx
afterChange Callback function called after the current index changes (current: number) => void -
beforeChange Callback function called before the current index changes (current: number, next: number) => void -
waitForAnimate Whether to wait for the animation when switching boolean false

Find more APIs in react-slick documentation.

Methods

Name Description
goTo(slideNumber, dontAnimate) Go to slide index, if dontAnimate=true, it happens without animation
next() Change current slide to next slide
prev() Change current slide to previous slide

Design Token

FAQ

How to add custom arrows?

See #12479.