035 RangeSlider · 范围滑块
用途
用两个菱形滑块选择一个区间,如价格范围。两端不会交叉(允许相等)。
最小示例
low, high := 20.0, 80.0
view := func(c *ui.Context) {
core.Use(c, core.Settings{})
input.RangeSlider(c, &low, &high, input.RangeSliderOptions{Step: 10, Label: "Price"})
}
ui.Render(view, 400, 300, 1)参数
func RangeSlider(c *ui.Context, low, high *float64, opts RangeSliderOptions) ChoiceResult。*low > *high 时两者交换;超出范围的值被夹回并对齐步长。
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
Min, Max | float64 | 0, 0 → 0–100 | 范围。 |
Step | float64 | 0 | 步长,0 为连续。 |
Marks | []SliderMark | nil | 刻度与文字。 |
ShowValue | bool | false | 悬停、拖动或聚焦时显示两端数值;低端提示向左、高端向右,互不遮挡。 |
Format | func(float64) string | 按 Min、Step 所需小数位(连续时至少 1 位) | 数值文字。 |
Disabled | bool | false | 禁用。 |
Label | string | "" | 区间名称;两个滑块分别名为“Label 最小值”“Label 最大值”,数值与范围由 Slider 角色报告。 |
状态
默认、悬停、拖动、聚焦(各滑块独立焦点环)、禁用。
事件
Changed() 在任一端变化的那一帧返回 true。
键盘操作
- Tab:依次聚焦低端、高端滑块。
- ←/↓、→/↑:一个步长;不能越过另一端。
- Home / End:到范围端点或另一端所在位置。
- 指针按下轨道任意处:移动较近的一端,并把焦点交给它。
限制
- MyGo 自带的
ui.RangeSlider使用玻璃质感滑块(ui/widgets.go:419),不符合本库风格;MyGo 也没有双滑块 Base,故每个滑块各是一个SliderBase(报告 Slider 角色、范围与当前值,ui/base.go:128),拖动由外层的Dragged、PointerPosition处理。 - 两个滑块的范围都报告为整条轨道
Min–Max;“不能越过另一端”这一动态上下限无法告诉辅助技术。 - 按键处理与 Slider 相同:方向取自松开的键,在松开时移动(见 034 限制)。

