SegmentedSlider
A slider for choosing one of a fixed set of discrete steps.
Usage
Basic
Loading demo...
Custom Segments
A value can be a string, and a label any text, emoji included.
Loading demo...
Release Policy
Use TxSegmentedSlider for the risk tier and TxSlider for the traffic ratio.
Loading demo...
Best Practices
- Use 3–7 stable segments; switch to
TxSelectorTxSearchSelectfor long or dynamic lists. - Keep each segment
valueprimitive and unique. - Turn off
showLabelsonly when nearby text already explains each step. - Use
TxSliderfor continuous numbers andTxSegmentedSliderfor ordered tiers such as risk, plan, or quality gates.
API Reference
Props
| Prop | Type | Default | Description |
|---|---|---|---|
modelValue | number | string | null | 0 | Selected segment value; null selects the first segment after mount. |
segments | SegmentedSliderSegment[] | [] | Segments, in order along the track. |
disabled | boolean | false | Blocks changes by click and keyboard. |
showLabels | boolean | true | Shows each segment's label, if it has one. |
vertical | boolean | false | Uses a vertical track that fills bottom-to-top. |
Events
| Event | Params | Description |
|---|---|---|
update:modelValue | (value: number | string) | Fires when a segment is chosen by click or keyboard. |
change | (value: number | string) | Fires together with update:modelValue. |
Types
export interface SegmentedSliderSegment {
value: number | string // emitted when selected
label?: string // text beside the stop
}
Overview
- The track is inset by half an active stop at each end, so the end stops sit wholly inside the box on either axis, and the fill ends at the selected stop's center.
- The row is a
radiogroupand each stop aradio. - Tab enters the row once, on the current stop; arrow keys move and stop at both ends, and Home / End jump to them. In the vertical layout, Up moves forward.
- The focus ring shows only for keyboard use; hover slightly grows an unselected stop. Both stop under reduced motion.
Technologies
- Source:
packages/tuffex/packages/components/src/segmented-slider/.
查看源码
packages/tuffex/packages/components/src/segmented-slider/index.ts