Skip to main content

Carousel

The carousel component is designed to showcase a large amount of visual content in a dynamic and engaging manner. It enables you to display images, videos, or other multimedia content in a rotating carousel format, allowing users to view multiple items in a slideshow-like fashion.

This component is particularly useful for creating interactive galleries, image sliders, or promotional banners within your application.

info

For more details about Vuetify’s usage of Carousel component, click Carousel page.
For more prop explanations, click Vuetify Carousel API page.

image

Props

AttributeDescriptionTypeDefault
classProp that determines the class to add to the Carousel.stringundefined
continuousDetermines whether carousel is continuous.Booleanfalse
cycleDetermines if the carousel should cycle through images.Booleanfalse
darkApplies the dark theme variant to the component.Booleanfalse
delimiterIconSets icon for carousel delimiter.string'$delimiter'
hideDelimiterBackgroundHides the bottom delimiter background.Booleanfalse
hideDelimitersHides the carousel’s bottom delimiters.Booleanfalse
intervalThe duration between image cycles. Requires the cycle prop.number | string6000
lightApplies the light theme variant to the component.Booleanfalse
mandotoryBooleantrue
maxnumber | stringundefined
multipleBooleanfalse
nextIconThe displayed icon for forcing pagination to the next item.boolean | string$next
prevIconThe displayed icon for forcing pagination to the previous item.boolean | string$prev
progressDisplays a carousel progress bar. Requires the cycle prop and interval.booleanfalse
progressColorApplies specified color to progress bar.stringundefined
reverseReverse the normal transition direction.booleanfalse
showArrowsDisplays arrows for next/previous navigation.booleantrue
showArrowsOnHoverDisplays navigation arrows only when the carousel is hovered over.booleanfalse
tabIndexIt determines the order of switching from one component to another with the tab key.stringundefined
touchProvide a custom left and right function when swiped left or right.objectundefined
touchlessDisable touch support.booleanfalse
valueThe designated model value for the component.anyundefined
verticalUses a vertical transition when changing windows.booleanfalse
verticalDelimitersDisplays carousel delimiters vertically.stringundefined
visibleVisibility of Carousel component.booleantrue

Events

AttributeDescription
changeEmitted when the component value is changed by user interaction

CarouselItem

The CarouselItem component is used as a child element within the Carousel component to represent individual items or slides within the carousel.

Props

AttributeDescriptionTypeDefault
activeClassConfigure the active CSS class applied when the link is active.stringundefined
eagerWill force the components content to render on mounted. This is useful if you have content that will not be rendered in the DOM that you want crawled for SEO.booleantrue
disabledRemoves the ability to click or target the component.booleanfalse
appendSetting append prop always appends the relative path to the current path.booleanfalse
exactExactly match the link. Without this, ‘/’ will match every route.booleanfalse
hrefDesignates the component as anchor and applies the href attribute.stringundefined
linkDesignates that the component is a link. This is automatic when using the href or to prop.booleanfalse
replaceSetting replace prop will call router.replace() instead of router.push() when clicked, so the navigation will not leave a history record. You can find more information about the replace prop on the vue-router documentation.booleanfalse
targetDesignates the target attribute. This should only be applied when using the href prop.stringundefined
toDenotes the target route of the link. You can find more information about the to prop on the vue-router documentation.stringundefined
transitionThe transition used when the component progressing through items.stringundefined
valueThe designated model value for the component.anyundefined
visibleVisibility of CarouselItem componentbooleantrue
Note

The default value of the eager prop of CarouselItem component is now set to true. However, if there is a large amount of data, the eager prop can be set to false. This can be useful for working with large datasets.

For Mobile Usage

In the web version, CarouselItem has a src prop, which is not used in mobile. Therefore, instead of using src prop in mobile, you must place a VImg component within a Row-Col structure to display images.

Samples Qjson

Carousel