react-rating-star-with-type
TypeScript icon, indicating that this package has built-in type declarations

1.2.2 • Public • Published

react-stars ⭐

A simple star rating component for your React projects

React Rating stars

Get started quickly

Install react-stars package with NPM:

npm install react-rating-star-with-type --save

Install react-stars package with Yarn:

yarn add react-rating-star-with-type

Then in your project include the component:

import { useState } from "react";
import ReactStars from 'react-rating-star-with-type'

export default function app(){
    const [star, setStar] = useState(5);

    const onChange=(nextValue)=>{
        setStar(nextValue)
    }
    
    return <ReactStars 
    onChange={onChange} 
    value={4.2}  
    isEdit={true}  
    activeColors={[ "red", "orange", "#FFCE00", "#9177FF","#8568FC",]} 
    />
}


API

This a list of props that you can pass down to the component:

Property Description Default value type
className Name of wrapper class "" string
count How many total stars you want 5 number
value Set rating value 0 number
emptyIcon Which character you want to use as a star (react-icons) ReactNode
halfIcon Which character you want to use as a half star (react-icons) ReactNode
filledIcon Which character you want to use as a active star (react-icons) ReactNode
inactiveColor Color of inactive star #808080 string
activeColors Colors of active star (depend of value) [] String[]
activeColor Color of selected or active star #FED900 string
size Size of stars (if provide string you must mention unit , for example: "1rem" ) 14 number or String
style style object for component wrapper {} object
isEdit Should you be able to select rating or just see rating (for reusability) false boolean
isHalf isHalf true means you can select half star (make sure isEdit true if you set isHalf true) false boolean
valueShow Should component use valueShow, if need Rating show with stars false boolean
onChange(new_rating) Will be invoked any time the rating is changed undefined function

Help improve the component

Hit star on gitHub - https://github.com/ziaulhoque24/react-rating-star-with-type

Requirements

You will need to have React in your project in order to use the component, I didn't bundle React in the build, because it seemed like a crazy idea.

It also works perfectly with next js in client components. with the server component, you may get an error!

Package Sidebar

Install

npm i react-rating-star-with-type

Weekly Downloads

502

Version

1.2.2

License

MIT

Unpacked Size

15 kB

Total Files

10

Last publish

Collaborators

  • ziaulhoque24