0.1.3 • Published 3 years ago

react-icons-rating v0.1.3

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

npm.io

React Icons Rating

Simple react component to display rating in any svg icon you want.


List of features

  • Custom number of icons
  • Custom Fill/Stroke/Background color
  • Floating point rating
  • Custom icons
  • Working in both directions (horizontal & vertical)

Code Demo

<RatingIcons
    numOfIcons={5}
    rating={4.63}
    fillColor="#f00"
    strokeWidth={0}
    size={50}
    iconPadding={5}
    direction="row"
    customIcon={{
        path: heartPath,
        viewBox: '0 0 35 28'
    }}
    backgroundColor="#d3d3d3"
/>

Download & Installation

npm i react-icons-rating
import RatingIcons from 'react-icons-rating';

Props

NAMETYPEDEFAULTDESCRIPTION
numOfIconsNumber-Number of icons to be displayed
ratingNumber-How much icons should be colored
iconPaddingNumber10Distance between icons in pixels
sizeNumber20Icon size in pixels
fillColorString#FF0000Color of a filled icon in HEX
backgroundColorString#FFFFFFColor of an unfilled icon in HEX
stokeColorStringsame as fillColorColor of an icon border in HEX
strokeWidthNumber2Stroke width in pixels
directionrow / columnrowDirection of stars
customIconObjectsee belowCustom object of path and viewbox of SVG icon

To pass a custom icon, create an object with two keys:

{
  path: string;
  viewBox: string;
}

i.e.

const customIcon = {
  path: 'M25.808 0A9.186 9.186 0 0017.5 5.3 9.18 9.18 0 000 9.27C0 22.421 17.5 28 17.5 28S35 22.421 35 9.27A9.231 9.231 0 0025.808 0',
  viewBox: '0 0 35 28',
};

License

This project is licensed under the MIT License