chakra-any-carousel
v1.0.8
Published
A carousel animating any element
Downloads
18
Maintainers
Readme
Chakra UI React Any Carousel
Carousel animation for any provided React component
Usage
Interfaces
CarouselItem
export interface CarouselItem {
title: string;
description: string;
image: CarouselImage;
link: CarouselLink;
onClick: () => void; // A function associated to the onClick event of the carousel component
}
Represent the data accessible inside the single carousel item which will be provided by the user.
CarouselProps
export interface CarouselProps {
id: string; // Id of the carousel element
interval: number; // Animation delay
direction: Direction; // Direction of the animation
repetitions: number; // Number of element visualized at once
items?: Partial<CarouselItem>[]; // Data for the elements
children: JSX.Element; // The component to be cloned
}
As items
is an array of Partial
, data integrity is in the hands of the user.
The children
component must implement the following:
(props: Partial<CarouselItem>) => JSX.Element
Example
const CarouselCard = ({ image }: Partial<CarouselItem>) => (
<Image src={image?.imageUrl} />
);
<Carousel
id="homeCarousel-1"
direction="right"
interval={2000}
repetitions={1}
items={getCarouselItems()}
>
<CarouselCard />
</Carousel>
Styling
The only elements that at the moment can be styled are the arrows. The style can be modified by implementing a ChakraUI theme component as follows:
const carouselHelpers = createMultiStyleConfigHelpers(['arrows']);
const Carousel = carouselHelpers.defineMultiStyleConfig({
baseStyle: {
arrows: {
borderRadius: '10px',
},
},
});
Always specify a single value for borderRadius
as the component will handle the differences between left and right arrow.