Meter
A measurement in a known range, such as storage or seats, as a fill on a thin track. Past its high mark, or below its low mark, the fill and the value turn red, and a notch shows where that mark is.
npx shadcn add https://kinoui.com/r/meter.jsonCopy install command
Examples
Default
Put a MeterLabel and a MeterValue inside, and they sit in a row above the track. Set high, and past it the fill and the value turn red; a notch marks where.
Several
Stack meters for the limits of a plan. Each value changes in place: the fill draws to it and never moves on its own.
Installation
Copy code
npx shadcn@latest add https://kinoui.com/r/meter.json- Files
lib/reduce-motion.tslib/track.tscomponents/kino/meter.tsx- Packages
@base-ui/react- Global CSS
- the feels, the density tokens, the shape tokens and the success and warning colours
New to Kino? Installation covers what your project needs first and the @kino namespace.
API reference
Meter
Data attributes
Accessibility
- It is a
meter, named byMeterLabelor byaria-label. Use it for a measurement, never for how far a task has got: that is a Progress. - The value in the row is for sighted users and is hidden from screen readers, which read the meter itself. Write it with
getAriaValueTextwhen a percentage would say less. - Past
highor belowlow, red is not the only sign: the fill passes the notch. Say what it means in text too, such as "Almost full". - In forced colours the fill takes the system highlight and the track gets an outline.
- When the system asks for less motion, the fill jumps to a new value.