Slider 滑动输入条
允许用户在一个区间中选择特定值,eg:控制屏幕的显示亮度。规则
默认状态下,左边为最小值,右边为最大值。
一般水平放置。
代码演示
Basic slider. Whendisabled
is true
, the slider will not be interactable
/* eslint arrow-body-style: 0 */
import { Slider, WingBlank, WhiteSpace } from 'antd-mobile';
class App extends React.Component {
log = (name) => {
return (value) => {
console.log(`${name}: ${value}`);
};
}
render() {
return (
<div className="am-slider-example">
<WhiteSpace size="lg" />
<WingBlank size="lg">
<p className="sub-title">Slider</p>
<Slider
style={{ marginLeft: 30, marginRight: 30 }}
defaultValue={26}
min={0}
max={30}
onChange={this.log('change')}
onAfterChange={this.log('afterChange')}
/>
</WingBlank>
<WhiteSpace size="lg" />
<WingBlank size="lg">
<p className="sub-title">Disabled slider</p>
<Slider
style={{ marginLeft: 30, marginRight: 30 }}
defaultValue={26}
min={0}
max={30}
disabled
onChange={this.log('change')}
onAfterChange={this.log('afterChange')}
/>
</WingBlank>
<WhiteSpace size="lg" />
<WingBlank size="lg">
<p className="sub-title">Slider with customized color</p>
<Slider
style={{ marginLeft: 30, marginRight: 30 }}
defaultValue={26}
min={0}
max={30}
trackStyle={{
backgroundColor: 'red',
height: '5px',
}}
railStyle={{
backgroundColor: 'blue',
height: '5px',
}}
handleStyle={{
borderColor: 'blue',
height: '14px',
width: '14px',
marginLeft: '-7px',
marginTop: '-4.5px',
backgroundColor: 'blue',
}}
/>
</WingBlank>
</div>
);
}
}
ReactDOM.render(<App />, mountNode);
.demo-preview-item .am-slider-wrapper {
margin-bottom: 15px;
}
.demo-preview-item .am-slider-example {
overflow: hidden;
}
.am-wingblank.am-wingblank-lg {
margin-bottom: 30px;
}
.demo-preview-item .am-slider-wrapper:last-child {
margin-bottom: 10px;
}
.sub-title {
color: #888;
font-size: 14px;
padding: 30px 0 18px 0;
margin: 0;
}
API
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
min | Number | 0 | 最小值 |
max | Number | 100 | 最大值 |
step | Number or null | 1 | 步长,取值必须大于 0,并且可被 (max - min) 整除。当 marks 不为空对象时,可以设置 step 为 null ,此时 Slider 的可选值仅有 marks 标出来的部分。 |
value | Number | 设置当前取值。 | |
defaultValue | Number | 0 | 设置初始取值。 |
disabled | Boolean | false | 值为 true 时,滑块为禁用状态 |
onChange | Function | Noop | 当 Slider 的值发生改变时,会触发 onChange 事件,并把改变后的值作为参数传入。 |
onAfterChange | Function | Noop | 与 ontouchend 触发时机一致,把当前值作为参数传入。 |
marks | Object{Number:String} | { } | 刻度标记,key 的类型必须为 Number 且取值在闭区间 min, max 内 |
dots | Boolean | false | 是否只能拖拽到刻度上 |
included | Boolean | true | marks 不为空对象时有效,值为 true 时表示值为包含关系,false 表示并列 |
maximumTrackStyle | Object | 未选中 track 的样式(将被废弃,请使用 railStyle 代替 ) | |
minimumTrackStyle | Object | 选中部分的 track 样式 (将被废弃,请使用 trackStyle 代替 ) | |
handleStyle | Object | 滑块的样式 | |
trackStyle | Object | 选中部分滑动条的样式 | |
railStyle | Object | 未选中部分 |