Stepper 步进器

步进器由增加按钮、减少按钮和输入框组成,用于在一定范围内输入、调整数字。

代码演示

样式风格

直角风格

<hd-stepper shape="square" v-model="value0"></hd-stepper>

直角风格

<hd-stepper shape="circle" v-model="value1"></hd-stepper>

基础功能

步长设置

<hd-stepper step="3" shape="circle" v-model="value2"></hd-stepper>

限制范围

<hd-stepper :max="20" :min="0" shape="circle" v-model="value3"></hd-stepper>

限制输入整数

<hd-stepper :integer="true" shape="circle" v-model="value4"></hd-stepper>

扩展功能

折叠减号

<hd-stepper shape="square" v-model="value5" :collapsible="true"></hd-stepper>

长按加减

<hd-stepper shape="circle" v-model="value6" :longPress="true"></hd-stepper>

异步更新

<hd-loading ref="loading"></hd-loading>
<hd-button @click="onClick">打开loading(2s后自动关闭)</hd-button>
<hd-loading ref="loading"></hd-loading>
<hd-stepper shape="circle" v-model="value7" :asyncChange="true" @change="onChange"></hd-stepper>
const loading = ref<Loading>() // loading ref

function onChange(val) {
  loading.value?.showLoading({
    title: '改变中'
  })
  setTimeout(() => {
    this.value7 = val
    loading.value?.hideLoading()
  }, 4000)
}

禁用状态

禁止输入

<hd-stepper shape="square" v-model="value8" readonly></hd-stepper>

禁止操作

<hd-stepper shape="square" v-model="value10" disabled></hd-stepper>

Props

NameDescriptionTypeRequiredDefault
value输入值Number / Stringfalse0
min最小值Number / Stringfalse0
max最大值Number / StringfalseNumber.MAX_SAFE_INTEGER
step步长Number / Stringfalse1
disabled是否禁用Booleanfalsefalse
readonly是否禁用输入框Booleanfalsefalse
asyncChange是否开启异步变更,开启后需要手动控制输入值Booleanfalsefalse
collapsible是否可以折叠Booleanfalsefalse
shape样式风格'square' / 'circle'false默认值是:circle
decimalLength显示的小数位数Numberfalse4
longPress是否开启长按Booleanfalsefalse
integer是否只允许输入整数Booleanfalsefalse

Events

Event NameDescriptionParameters
focus输入框聚焦时触发event: Event
blur输入框失焦时触发event: Event
input输入框内容发生变化时触发value:输入框的内容,建议通过v-model双向绑定输入值,而不是监听此事件的形式
change当绑定值变化时触发的事件value:输入框的内容

Slots

NameDescriptionDefault Slot Content
minus自定义减小按钮-
plus自定义增加按钮-