react-customizable-star-rating
v0.4.0
Published
React component to view and set rating
Downloads
21
Readme
To use React customizable star rating
Steps to use the package
- Install the package
npm i react-customizable-star-rating
this will add the package to your project - Import the package
import {StarRating} from "react-customizable-star-rating";
Basic usage
<StarRating onSetRating={onRating} />
You need to replace this onRating
with you own useState hook
Customization
You can pass these props to make sure that it's more suitable for you
| # | Prop | Type | Default value | Description | Mandatory | |---|---------------|----------|----------------|--------------------------------------------------------------------------------------|---------------------------------------| | 1 | onSetRating | Function | ----------- | useState hook to get/set the rating | ✅ | | 2 | defaultRating | Number | 0 | Initial rating to view | ❌ | | 3 | maxRating | Number | 5 | Stars Number | ❌ | | 4 | color | String | #FCC419 | The stars filing and number color | ❌ | | 5 | size | Number | 48 in pixel | The size of the stars this will impact the number size | ❌ | | 6 | borderColor | String | color= #FCC419 | The stars border color | ❌ | | 7 | className | String | '' | Class name for the stars container | ❌ | | 8 | messages | Array | [] | Array of messages to display when the user rating ex. instead of 1 => poor and so on | ❌ | | 8 | viewOnly | boolean | false | To disable the rating functionality and make it a view only component | ❌ |