angular-star-rating

Angular Star Rating ⭐⭐⭐⭐⭐

⭐ Angular Component written in typescript, based on css only techniques. ⭐

Angular Star Rating is a >2 Angular component written in typescript.
It is based on css-sar-rating, a fully featured and customizable css only star rating component written in scss.

DEMO

• Example-App

Related Projects

Css	Angular1 (>=1.5)	Angular (>=2)
Css Star Rating	Angular1 Star Rating	Angular Star Rating

Features

This module implements all Features from CSS-STAR-RATING. It also provides callbacks for all calculation functions used in the component as well as all possible event emitters.

• id - The html id attribute of the star rating
• rating - The actual Star rating
• showHalfStars - To display half stars or not
• numOfStars - The max number of stars you can rate
• size - The different sizes of the component
• spread - Stars are spreaded over whole width or not
• color - A static color for the stars
• disabled - Component is in disabled mode
• starType - Stars can be displayed as svg, character or icon-font like fontawesome, glyphicons or ionicons
• labelText - The value of the label text
• labelPosition - The position of the label
• speed - The duration of the animation
• direction - The direction of the component i.e. right to left
• readOnly - Click event is disabled
• getColor - Custom function to calculate the color for a rating
• getHalfStarVisible - Custom function to calculate value for displaying half stars or not
• onClick - Hook for Click action
• onRatingChange - Hook for onRatingChange event

Browser support

IE	Firefox	Chrome	Safari	Opera
>11	>50	>55	>10	>41

Installation

Get Angular Star Rating:

• clone & build this repository
• download as .zip
• via npm: by running $ npm install angular-star-rating --save from your console
• via bower: by running $ bower install angular2-star-rating --save from your console

Consuming the library

Once you have published your library to npm, you can import your library in any Angular application by running:

$ npm install angular-star-rating

and then from your Angular AppModule:

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';

import { AppComponent } from './app.component';

// Import your library
import { StarRatingModule } from 'angular-star-rating';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,

    // Specify your library as an import
    StarRatingModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

Once your library is imported, you can use its components, directives and pipes in your Angular application:

<!-- You can now use your library component in app.component.html -->
<h1>
  {{title}}
</h1>
<star-rating-comp></star-rating-comp>

If you want to ust the svg style be shure to copy the image to your assets/images folder.

Component Properties

Inputs

id: string (Optional)
The html id attribute of the star rating
Default: undefined

<star-rating-comp [id]="'my-id'"></star-rating-comp>

rating: number (Optional)
The actual star rating value
Default: no

<star-rating-comp [rating]="3"></star-rating-comp>

showHalfStars: boolean (Optional) To show half stars or not
Options: true, false
Default: false

<star-rating-comp [showHalfStars]="true"></star-rating-comp>

numOfStars: number (Optional)
The possible number of stars to choose from
Default: 5

<star-rating-comp [numOfStars]="6"></star-rating-comp>

text: string (Optional)
The text next to the stars.
Default: undefined

<star-rating-comp [labelText]="'My text!'"></star-rating-comp>

labelPosition: starRatingPosition (Optional)
The position of the label
Options: top, right, bottom, left
Default: left

<star-rating-comp [labelPosition]="'top'"></star-rating-comp>

space: starRatingStarSpace (Optional)
If the start use the whole space or not. Options: no, between, around Default: no

<star-rating-comp [space]="'around'"></star-rating-comp>

size: starRatingSizes (Optional)
The height and width of the stars.
Options: small, medium, large
Default: middle

<star-rating-comp [size]="'small'"></star-rating-comp>

staticColor: starRatingColors (Optional)
Possible color names for the stars.
Options: default, negative, middle, positive
Default: undefined

<star-rating-comp [staticColor]="'positive'"></star-rating-comp>

disabled: boolean (Optional)
The click callback is disabled, colors are transparent
Default: false

<star-rating-comp [disabled]="true"></star-rating-comp>

direction: string (Optional)
The direction of the stars and label.
Options: rtl, ltr
Default: rtl

<star-rating-comp [direction]="'ltr'"></star-rating-comp>

readOnly: boolean (Optional)
The click callback is disabled
Default: false

<star-rating-comp [readOnly]="true"></star-rating-comp>

speed: starRatingSpeed (Optional)
The duration of the animation in ms.
Options: immediately, noticeable, slow
Default: noticeable

<star-rating-comp [speed]="'slow'"></star-rating-comp>

starType: starRatingStarTypes (Optional)
The type of start resource to use.
Options: svg, icon Default: svg

<star-rating-comp [starType]="'icon'"></star-rating-comp>

getColor: Function (Optional)
Calculation of the color by rating.
Params: rating, number,numOfStars and staticColor
Return: color name

<star-rating-comp [getColor]="ctrl.getColor(rating, numOfStars, staticColor)"></star-rating-comp>

getHalfStarVisible: Function (Optional)
Calculation for adding the "half" class or not, depending on the rating value.
Params: rating
Return: boolean

<star-rating-comp [getHalfStarClass]="ctrl.getHalfStarClass(rating)" rating="3.2"></star-rating-comp>

Outputs

onClick: Function (Optional)
Callback function for star click event Params: $event

<star-rating-comp (onClick)="ctrl.onClick($event)"></star-rating-comp>

onRatingChange: Function (Optional)
Callback function for rating change event Params: $event

<star-rating-comp (onRatingChange)="ctrl.onRatingChange($event)"></star-rating-comp>

License

MIT © Michael Hladky

Changelog

2.0.0-rc.0 (2017-04-12)

Bug Fixes

• examples: updated examples (b05d28e)
• examples: updated examples (a44ef30)
• fixed binding names: fixed binding names and class names (73cc7d0)
• typings: updated typings (f4a1dd7)
• versions: updated versions of libs (fc28c88)

Features

• controlValueAccessor: finished implement control value accessor (5cb28d1), closes #11
• controlValueAccessor: updated examples (2097b40)
• direction and types: added direction in component and changed type names (c9ddaf5)
• keyboard: finished keyboard implementation (ca35e8a)
• keybord interaction: progress implementing keybord interaction (b071567)
• keybord interaction: star implementing keybord interaction (a1a72ae)
• labelVisible: added labelVisible property (16412dd)
• refactoring: enable overrides for set rating (ae9749f)
• utils: implement utils and controller class (80ab369), closes #12
• valueAccessor: created new example for value accessor (20bd211)
• valueAccessor: progress implementation (ba1c664)
• valueAccessor: progress implementing the value accessor for reactive forms (059a0f9)
• valueAccessor: progress implementing the value accessor for reactive froms (cd8136d)
• valueAccessor: start implement the value accessor for reactive froms (d7adcf3)
• valueAccessor: start progress implementing the value accessor for reactive froms (5c4e9be)
• valueAccessor: start progress implementing the value accessor for reactive froms (0f27794)

<a name="2.0.0-beta2"></a>