azir-rating
v1.0.0
Published
An advance rating component that should render nicely on any platform. Supports a great level of customization.
Downloads
4
Maintainers
Readme
Azir Framwork : https://azir.io/docs
Rating
An advance Rating component that should render nicely on any platform. Supports a great level of customization.
Installation
to install the latest version of azir-rating you only need to run:
npm install azir-rating --saveor
yarn add azir-ratingExamples
Basic :
import Rating from "azir-rating" ;
---
<Rating
size={60} rating={1}
scaleSize={80} count={3}
reviews={["Okay","Good", "Great"]}
onChange={(rating,previousRating)=>{console.log(rating+" : " +previousRating)}}
/>Advance with Styles :
import Rating from "azir-rating" ;
import Icon,{ AzirIcons } from "azir-icon";
---
<Rating
reviewColor="red"
activeColor="red"
count={7}
icon={AzirIcons.ThumbUp}
starContainerStyle={ {borderWidth:1} }
inActiveColor="#990000"
reviewStyle={ {fontSize:18} }
style={ {backgroundColor:"#eee"} }
containerStyle={ {backgroundColor:"#aaeeaa"} }
showAnimation={false}
showScaleEffect={false}
/>Props
Please make sure to download the latest version of Azir icons.
icononChangeratingcountsizescaleSizeactiveColorinActiveColorshowAnimationshowScaleEffectreviewsreviewSizeshowRatingReviewdisabledstylecontainerStylestarContainerStylereviewStyle
Reference
icon
Rating Icon.
| Type | Required | Default | | ------------------------------------------------------------ | -------- | -------------- | | AzirIcons,SolidIcons, RegularIcons, BrandIcons , CustomIcons | No | AzirIcons.Star |
onChange
Handler to be called when the user change the rating .
we pass two parameters (rating :current selected index,previousRating :previous index )
| Type | Required | | -------- | -------- | | function | NO |
rating
Initial value for the rating. star rating started from zero.
| Type | Required | Default | | ------ | -------- | ------- | | Number | No | 2 |
count
Total number of ratings to display
| Type | Required | Default | | ------ | -------- | ------- | | Number | No | 5 |
size
The Size of the Rating Icon
| Type | Required | Default | | ------------------------------------ | -------- | ------- | | azir-size | No | 25 |
scaleSize
The Size of the Rating Icon when its active
| Type | Required | Default | | ------------------------------------ | -------- | ------- | | azir-size | No | 40 |
activeColor
Active Rating icon Color.
| Type | Required | Default | | ------------------------------------------ | -------- | ------- | | azir-color | No | theme |
inActiveColor
In Active Rating icon Color.
| Type | Required | Default | | ------------------------------------------ | -------- | ------- | | azir-color | No | #BDC3C7 |
showAnimation
Show Rating Icons Change Spring animation
| Type | Required | Default | | ------- | -------- | ------- | | boolean | No | true |
showScaleEffect
Show Rating Icons Change Scaling Effect
| Type | Required | Default | | ------- | -------- | ------- | | boolean | No | true |
reviews
Labels to show when each value is tapped e.g. If the first star is tapped, then value in index 0 will be used as the label
| Type | Required | Default | | -------- | -------- | -------------------------------------------- | | string[] | No | ["Terrible", "Bad", "Okay", "Good", "Great"] |
reviewSize
The font Size of the Rating Reviews
| Type | Required | Default | | ------ | -------- | ------- | | Number | No | 25 |
showRatingReview
If false, we hide rating reviews.
| Type | Required | Default | | ---- | -------- | ------- | | bool | No | true |
disabled
If true, disable all interactions for this component.
| Type | Required | Default | | ---- | -------- | ------- | | bool | No | false |
style
override Rating main Container Style
| Type | Required | | ----- | -------- | | style | No |
containerStyle
override rating icons container style
| Type | Required | | ----- | -------- | | style | No |
starContainerStyle
override Star Container Style
| Type | Required | | ----- | -------- | | style | No |
reviewStyle
override review Text style
| Type | Required | | ----- | -------- | | style | No |
