-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
c80a39d
commit 1d65fbd
Showing
3 changed files
with
164 additions
and
17 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,159 @@ | ||
# React Micro Carousel | ||
|
||
![example workflow](https://github.com/pstachula-dev/react-micro-carousel/actions/workflows/main.yml/badge.svg) | ||
|
||
![bundlesize](https://badgen.net/bundlephobia/minzip/react-micro-carousel) | ||
|
||
## Component features | ||
|
||
- Extremely small package size (gzipped): | ||
- Javascript: 2.6kB | ||
- CSS: 1.5kB | ||
- 0 external dependencies | ||
- Full typescript support | ||
- Built in with Tailwind, but you can always customize the styles | ||
- Handling touch/mouse events | ||
- Lazy image loading | ||
- Responsive support | ||
|
||
## Documentation | ||
|
||
[Simple react carousel docs](https://simple-react-carousel.onrender.com/) | ||
|
||
## How to use: | ||
|
||
### If you are using Tailwind: | ||
|
||
`tailwind.config.ts` | ||
|
||
```js | ||
export default { | ||
content: [ | ||
"./src/**/*.{js,ts,jsx,tsx}", | ||
"./node_modules/react-micro-carousel/**/*.js", | ||
], | ||
} satisfies Config; | ||
``` | ||
|
||
### ...other way? | ||
|
||
```js | ||
import 'react-micro-carousel/styles.min.css'; | ||
``` | ||
|
||
### Components markup: | ||
|
||
```js | ||
import { | ||
Carousel, | ||
CarouselProvider, | ||
Counter, | ||
DotsGroup, | ||
NextButton, | ||
PrevButton, | ||
Slide, | ||
} from 'react-micro-carousel'; | ||
|
||
<CarouselProvider total={2}> | ||
<Carousel> | ||
<Slide> | ||
<img src="..." /> | ||
</Slide> | ||
<Slide> | ||
<img src="..." /> | ||
</Slide> | ||
</Carousel> | ||
|
||
<DotsGroup /> | ||
<NextButton>Next<NextButton /> | ||
<PrevButton>Prev</PrevButton> | ||
</CarouselProvider> | ||
``` | ||
|
||
## Props documentation: | ||
|
||
### `<CarouselProvider />` | ||
|
||
Component is used to initialize the carousel context with configuration options and wrap the other components. | ||
|
||
| Prop | Type | Default | Required | | ||
| ------------- | --------- | ------- | -------- | | ||
| children | ReactNode | | Yes | | ||
| slideHeight | number | 0 | Yes | | ||
| total | number | 0 | Yes | | ||
| autoPlayDelay | number | false | No | | ||
| slidesVisible | number | 1 | No | | ||
| step | number | 1 | No | | ||
| threshold | number | 0.25 | No | | ||
| infinite | boolean | false | No | | ||
| disableTouch | boolean | false | No | | ||
| lazy | boolean | true | No | | ||
| autoPlay | boolean | false | No | | ||
|
||
### `<Carousel />` | ||
|
||
A carousel that wraps the slides and provides the core functionality, such as scrolling to the next or previous slide. | ||
|
||
| Prop | Type | Default | Required | | ||
| ----------------- | --------- | ------- | -------- | | ||
| children | ReactNode | | Yes | | ||
| wrapperClassName | string | | No | | ||
| carouselClassName | string | | No | | ||
|
||
### `<Slide />` | ||
|
||
A single slide in a carousel. | ||
|
||
| Prop | Type | Default | Required | | ||
| --------- | --------- | ------- | -------- | | ||
| children | ReactNode | | Yes | | ||
| index | number | | Yes | | ||
| className | string | | No | | ||
|
||
### `<Dot />` | ||
|
||
A single dot. | ||
|
||
| Prop | Type | Default | Required | | ||
| ------------- | -------- | ------- | -------- | | ||
| className | string | | No | | ||
| colorActive | string | | No | | ||
| colorInactive | string | | No | | ||
| index | number | | Yes | | ||
| disabled | boolean | | No | | ||
| onClick | Function | | No | | ||
|
||
### `<DotsGroup />` | ||
|
||
A component that renders a group of dots, representing the slides in the carousel. | ||
It provides auto generated dots for the carousel. | ||
|
||
| Prop | Type | Default | Required | | ||
| ------------- | -------- | ------- | -------- | | ||
| className | string | | No | | ||
| dotClassName | string | | No | | ||
| colorActive | string | | No | | ||
| colorInactive | string | | No | | ||
| onClick | Function | | No | | ||
|
||
### `<NextButton />` | ||
|
||
| Prop | Type | Default | Required | | ||
| --------- | --------- | ------- | -------- | | ||
| className | string | | No | | ||
| children | ReactNode | | Yes | | ||
| onClick | Function | | No | | ||
|
||
### `<PrevButton />` | ||
|
||
| Prop | Type | Default | Required | | ||
| --------- | --------- | ------- | -------- | | ||
| className | string | | No | | ||
| children | ReactNode | | Yes | | ||
| onClick | Function | | No | | ||
|
||
### `<Counter />` | ||
|
||
| Prop | Type | Default | Required | | ||
| --------- | ------ | ------- | -------- | | ||
| className | string | | No | |