Stepper 步进器
优质
小牛编辑
129浏览
2023-12-01
使用指南
组件介绍
Stepper 步进器由增加按钮、减少按钮和输入框组成,用于在一定范围内输入、调整数字
引入方式
import { Stepper } from 'feart';
components: {
"fe-stepper": Stepper,
}
代码演示
基础用法
通过 v-model 绑定输入值
<fe-stepper title="基础用法" v-model="value" />
export default {
data() {
return {
value: 10,
};
},
};
限制输入范围
通过 min 和 max 属性限制输入值的范围,min 默认是 1,max 默认是 Infinity
<fe-stepper title="限制输入范围" :min="0" :max="10" />
步长设置
设置 step 属性可设置每次点击增加或减少按钮时变化的值,默认是 1
<fe-stepper title="步长设置" :step="2" />
输入框只读模式
设置 readonly-input 属性后,输入框将变成可读模式,不能输入
<fe-stepper title="输入框只读模式" readonly-input />
固定小数位数
设置 fixed-decimal-length 属性后,限制输入的值小数点位数固定几位
<fe-stepper title="固定小数位数" :fixed-decimal-length="2" />
只允许输入整数
设置 integer 属性后,输入框将限制只能输入整数
<fe-stepper title="只允许输入整数" integer />
禁用
通过设置 disabled 属性来禁用步进器,禁用状态下无法点击按钮或修改输入框
<fe-stepper title="禁用" disabled />
样式风格
设置 radius ,icon-style , width 属性后,可以修改样式风格
<fe-stepper
title="自定义风格"
:value="8"
radius="50%"
:icon-style="{
size: '32px',
color: '#333',
}"
width="30px"
/>
标题 slot
通过 slot=title 设置标题插槽内容
<fe-stepper>
<span slot="title" class="demo-title">我是的标题<i>自带风格</i></span>
</fe-stepper>
事件
<fe-stepper
title="事件"
v-model="value"
:min="minValue"
:max="maxValue"
:step="stepValue"
integer
@focus="onFocus"
@blur="onBlur"
@change="onChange"
@plus="onPlus"
@minus="onMinus"
@overlimit="onOverlimit"
/>
API
Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
value | 表单值,使用 v-model 绑定 | Number | 1 | - |
min | 最小值 | Number | 1 | - |
max | 最大值 | Number | Infinity | - |
step | 步长 | Number | 1 | - |
title | 步进器标题 | String | - | - |
disabled | 是否禁用步进器 | Boolean | false | true ,false |
disabledColor | 禁用以后的颜色 | String | #ccc | - |
readonly-input | 输入框是否可填写 | Boolean | false | true ,false |
radius | 圆角大小 | String Boolean | 3px | - |
width | input 宽度 | String | 85px | - |
align | 对齐方式 | String | right | left ,right |
icon-style | 步进器加减 icon 大小和颜色 | Object | {color:'#000',size:'24px'} | - |
fixed-decimal-length | 固定显示的小数位数 | Number | - | - |
integer | 是否只允许输入整数 | Boolean | false | true ,false |
Slots
通过组件调用 Stepper
时,支持以下 Slots
Slot 名 | 说明 | 备注 |
---|---|---|
title | 标题内容插槽 | - |
Events
事件名 | 参数 | 说明 | 备注 |
---|---|---|---|
change | event | 绑定值 value 发生变化的时候触发 | - |
focus | event | 输入框聚焦的时触发 | - |
blur | event | 输入框失焦时触发 | - |
plus | - | 点击增加按钮触发 | - |
minus | - | 点击减少按钮触发 | - |
overlimit | - | 不可点击时触发 | - |