Rating

Star rating input

UI PrimitiveForm Inputs

Overview

Renders a row of rating items. Supports three display modes, half-precision for stars, hover preview, and read-only display.

Usage

import { Rating } from "@leanicon/web-builder-library";

Controlled:

const [value, setValue] = React.useState(0);

<Rating value={value} onValueChange={setValue} />;

Variants

Star rating (default)

Half-precision stars

Emoji mode

Numeric mode

Read-only

Notes

  • Star color uses --color-rating CSS variable; set this in your theme.
  • Emoji defaults: 😡 😕 😐 🙂 😍 (for 5-point scale).
  • Dark mode is handled via semantic tokens.

Props

NameTypeDefaultRequiredDescription
valuenumber—No
onValueChange((value: number) => void)—No
maxnumber5No
precisionenumfullNo
readOnlybooleanfalseNo
disabledbooleanfalseNo
classNamestring—No
mode"numeric" | "star" | "emoji" | nullstarNo