Components · Data Display
Number Ticker
BetaSince v1.6.0
A number whose digits roll to new values on the spatial spring. The first render never animates.
import { NumberTicker } from '@nexub/react';Examples
Formatted number
Each digit is a 0–9 strip; separators and symbols stay still.
Amount
`Amount animate` uses the ticker and keeps the quieter symbol and minor units.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| valuerequired | number | string | NumberTickerPart[] | — | A number (formatted with format and locale), an already-formatted string, or styled parts. |
| format | Intl.NumberFormatOptions | — | Formatting for a number value. |
| locale | string | — | BCP 47 locale. Defaults to the user's. |
| aria-live | 'off' | 'polite' | 'off' | Announce changes to screen readers. Use polite only for values the user is waiting on. |
Accessibility
Screen reader
The full value is read as one string; the rolling digits are hidden from assistive tech.
Under reduced motion digits change instantly.
On iOS & Android
Web only
Number Ticker has no @nexub/react-native twin. On phones, follow the platform pattern instead, or compose it from the native components listed on the React Native page.