API Reference

December 27, 2025 ยท View on GitHub

RmNgStarRatingComponent

The main component for displaying and collecting star ratings.

Input Properties

PropertyTypeDefaultDescription
ratingnumber0Current rating value (0-5)
readonlybooleanfalseIf true, disables user interaction
sizenumber24Size of stars in pixels
colorstring'#ffc107'Color of filled stars
emptyColorstring'#e0e0e0'Color of empty stars
spacingnumber4Spacing between stars in pixels
allowHalfbooleanfalseAllow half-star ratings
totalStarsnumber5Total number of stars to display
showLabelbooleanfalseShow numeric label next to stars
labelTextstring''Custom label text template

Output Events

EventTypeDescription
ratingChangeEventEmitter<number>Emitted when rating changes
hoverEventEmitter<number>Emitted when hovering over stars

Methods

MethodParametersReturnsDescription
setRating()rating: numbervoidProgrammatically set rating
reset()nonevoidReset rating to 0

Examples

Basic Usage:

<rm-ng-star-rating
  [rating]="3.5"
  (ratingChange)="onRatingChange($event)">
</rm-ng-star-rating>

Customized Appearance:

<rm-ng-star-rating
  [rating]="4"
  [size]="32"
  [color]="'#ff5722'"
  [emptyColor]="'#cfd8dc'"
  [spacing]="8"
  (ratingChange)="onRatingChange($event)">
</rm-ng-star-rating>

Read-Only with Half Stars:

<rm-ng-star-rating
  [rating]="4.5"
  [readonly]="true"
  [allowHalf]="true"
  [showLabel]="true">
</rm-ng-star-rating>