Slider 滑块选择器
Slider 滑块选择器,用于在一个区间内选择特定值。
# 支持平台
| App(vue) | App(nvue) | H5 | 小程序 |
|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ |
温馨提示
字节小程序边缘侧滑返回事件与 touch 事件有冲突(设置tt.setSwipeBackMode(0)也不行),所以在字节小程序中组件不要靠屏幕边缘太近。
# 代码演示
部分示例演示,完整使用请参考文档API。
# 基础使用
通过 @change 事件得到选择结果,@changing 事件为实时返回选择数据。
<wui-slider @change="onChange" @changing="onChanging"></wui-slider>
const onChange = e => {
console.log(e);
if (!init.value || e.value !== 0) {
Toast(`您选择的值为:${e.value}`);
}
init.value = false;
};
//需要实时数据时使用
const onChanging = e => {
//console.log(e)
};
# 初始值/显示value
通过 value 属性设置初始值,showValue 属性设置是否显示 value 值。
# 区间选择
通过 showValue 属性设置是否显示 value 值,section 属性设置是否为区间选择。
<wui-slider showValue section @change="sectionChange"></wui-slider>
const sectionChange = e => {
console.log(e);
};
# Slots
| 插槽名称 | 说明 |
|---|---|
| - | - |
# Props
| 属性名 | 类型 | 说明 | 默认值 | 平台差异说明 |
|---|---|---|---|---|
| width | Number, String | slider宽度,单位px | 240 | - |
| height | Number, String | slider高度,单位px | 2 | - |
| radius | Number, String | slider圆角值,单位px | 2 | - |
| min | Number, String | 最小值 | 0 | - |
| max | Number, String | 最大值 | 100 | - |
| step | Number, String | 步长,取值必须大于 0,并且可被(max - min)整除 | 1 | - |
| value | Number, String | 当前取值(起始值) | 0 | - |
| section | Boolean | 是否为区间选择 | false | - |
| endValue | Number, String | 当前取值(结束值),section为true时生效 | 100 | - |
| background | String | slider未选择时背景颜色 | #e1e1e1 | - |
| activeColor | String | slider已选择部分背景颜色 | #465CFF | 非Nvue端默认为空,可使用css变量(--wui-color-primary)来改变颜色值 |
| blockWidth | Number, String | 滑块宽度,单位px | 24 | - |
| blockHeight | Number, String | 滑块高度,单位px | 24 | - |
| blockColor | String | 滑块背景颜色 | #fff | - |
| blockRadius | Number, String | 滑块圆角值,单位px | 12 | - |
| disabled | Boolean | 是否禁止滑动选择/仅展示 | false | - |
| showValue | Boolean | 是否显示value值 | false | - |
| valueWidth | Number, String | value框宽度,单位px | 32 | - |
| valueSize | Number, String | value字体大小,单位px | 14 | - |
| valueColor | String | value字体颜色 | #333 | - |
# Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| @change | 滑动结束时触发 | { value : 选择值/起始值 endValue : 结束值,section为true时返回 } |
| @changing | 滑动时触发,实时数据 | { value : 选择值/起始值 endValue : 结束值,section为true时返回 } |