Skip to content

BbSlider

Choose an approximate bounded value, paired with exact entry when precision matters.

import { BbSlider } from 'bitboss-ui';

On this page

Use it for

Use BbSlider when position within a known interval carries meaning.

Use something else when

Pass Through

Hover or tap a part to outline it. Toggles flip loading, errors and warnings when the component has them — only parts highlight.

Guidance while the control is focused.

Set an exact spending limit

When the amount has consequences, bind the slider and number field to the same ref.

/ month

min, max, and step are hard invariants. Invalid bounds or a non-positive step throw at mount. A value from an API must be converted to a number before binding.

Filter a range

Set range and bind a two-element array; the component keeps it sorted.

Price €100 – €500
MinimumMaximum

17 of 26 products in this range

range with a scalar throws. The reverse mismatch is silent: an array without range renders one thumb and ignores later entries.

Readout, ticks, and keyboard

The component has no built-in numeric readout. Show the model beside the track or through the thumb slot.

12345

ticks positions the tick slot and draws no marks by itself. Raise max-precision when step is finer than 0.01.

60% — the buttons and the arrow keys move the same step.

Arrow keys move one step, Page keys ten, and Home/End reach the bounds. Stepper callbacks work only in single-value mode. Save on inactive when persistence should wait for release.

Coming from v2thumb-translate → disable-thumb-translate

:thumb-translate="false" became disable-thumb-translate with inverted polarity.

Invalid and locked configurations

floating labels are unsupported: an explicit value warns and falls back, while the global floating default degrades silently to outside.

Production services need at least two.
Set by your plan. Upgrade to raise it.

Prefer readonly for a locked value that people still need to inspect. disabled removes the thumb from the tab order. The v2 color prop moved to local track custom properties.