Odometer Field, animated React component
A number field that works like a mechanical counter: one dark housing with keys either side of a glass window, and black drums with ivory numerals behind it, rolling and carrying like an odometer, blurring when they spin fast. A ruler slides underneath; drag the window or the ruler to scrub and let go to coast to a whole number. Held steppers speed up, the ends nudge and thud, and the total counts along.
- Pro
- Inputs & Controls
- Spring
A mechanical click as each number passes the window, and a thud at either end. Sound is off on this site until you switch it on.
Play with it
Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.
Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| label | string | "Tickets" | The field's label. |
| defaultValue | number | 2 | The number it starts at. |
| min | number | 0 | The smallest number allowed. |
| max | number | 99 | The largest number allowed. |
| unitPrice | number | 24 | The price of one, used for the total underneath. Leave it out for no total. |
| currency | string | "$" | The currency sign in the total. |
| noun | [string, string] | ["ticket", "tickets"] | What one of them is called, and many, for the total line. |
| onChange | (value: number) => void | — | Called with the new number. |
| enableSound | boolean | true | A mechanical click as each number passes. They also follow the site-wide sound switch. |
| volume | number | 0.8 | Sound level, 0 to 1. |
| autoplay | boolean | false | Plays a short demo by itself until the visitor touches it. Never runs under reduced motion. |
| className | string | "" | Extra classes for the outer element. |
Add it to your project
- 1
Set up your project once
You need a Next.js project with Tailwind CSS and the
@/import alias. In its root folder, run this once. It createscomponents.jsonand thecn()helper insrc/lib/utils.ts:npx shadcn@latest init -d
Starting from nothing? The Quick Start walks through the whole thing.
- 2
Connect the registry with your API key
Odometer Field is a Pro item, so the CLI has to send your API key. Do this once per project:
- Create a key at nexus-ui.com/dashboard/api-key. Copy it straight away: it starts with
nxs_and is shown only once. - In your project root, next to
package.json, create a file named.env.localwith this line, using your own key:NEXUS_API_KEY=nxs_your_key_here
- Open
components.jsonand add this entry inside the outermost braces, next to"aliases". Leave{name}and${NEXUS_API_KEY}exactly as written; the CLI fills them in:"registries": { "@nexus-labs": { "url": "https://www.nexus-ui.com/api/registry/{name}", "headers": { "Authorization": "Bearer ${NEXUS_API_KEY}" } } }
- Create a key at nexus-ui.com/dashboard/api-key. Copy it straight away: it starts with
How Odometer Field works
A number field that works like a mechanical counter. The number sits behind a recessed window on drums, one per digit, and rolls: when the ones go from 9 to 0 the tens turn over with them, the way an odometer carries, blurring a little when they spin fast. Under it a ruler slides The steppers press in, and held down they repeat faster and faster. At the ends it won't go further: it nudges and thuds. Type a number, or use the arrow keys (Shift for ten).
The source, the install command and the build prompt come with Pro.
Odometer Field questions
Does it make sound, and how do I turn it off?
A mechanical click as each number passes the window, and a thud at either end. Sounds are synthesised with the Web Audio API, so there are no audio files, and they only play after a click or key press. Pass `enableSound={false}` to silence this component, or call `setSoundsEnabled(false)` from `@/lib/ui-sounds` to switch every sound off at once. The CLI installs `@/lib/ui-sounds` with the component.