ScrubInputRoot
ScrubInputRoot is the headless root primitive for drag-to-scrub numeric input.
It manages:
- mixed-value display
- editing vs scrubbing state
- pointer-driven numeric scrubbing
- commit semantics for finished edits
Props
| Prop | Default | Type |
|---|---|---|
modelValue*Current numeric value or mixed sentinel. | — | number | symbol |
minMinimum allowed value. | -Infinity | number | undefined |
maxMaximum allowed value. | Infinity | number | undefined |
stepScrub step multiplier. | 1 | number | undefined |
sensitivityPointer sensitivity multiplier. | 1 | number | undefined |
placeholderPlaceholder for mixed values. | Mixed | string | undefined |
Model
| Prop | Default | Type |
|---|---|---|
v-model:modelValue*Writable numeric model. | — | number |
Events
| Event | Payload | Description |
|---|---|---|
update:modelValue | value: number | Emitted while scrubbing or editing. |
commit | value: number, previous: number | Emitted when an edit interaction is committed. |
Slots
| Slot | Props | Description |
|---|---|---|
default | { modelValue: number | symbol, displayValue: string, isMixed: boolean, editing: boolean, scrubbing: boolean, startScrub: (event: PointerEvent) => void, startEdit: () => void, commitEdit: (event: Event) => void, keydown: (event: KeyboardEvent) => void, placeholder: string } | Full scrub-input render contract. |
Example
vue
<ScrubInputRoot v-model:model-value="value" @commit="commit" v-slot="ctx">
<div @pointerdown="ctx.startScrub">
<ScrubInputDisplay />
<ScrubInputField class="w-16" />
</div>
</ScrubInputRoot>