Files
2025-10-01 10:01:52 +08:00

3.3 KiB
Raw Permalink Blame History

title, description, spline, isComponent
title description spline isComponent
Stepper 步进器 用于数量的增减。 form true

引入

全局引入,在 miniprogram 根目录下的app.json中配置,局部引入,在需要引入的页面或组件的index.json中配置。

"usingComponents": {
  "t-stepper": "tdesign-miniprogram/stepper/stepper"
}

代码演示

在开发者工具中预览效果

Tips: 请确保开发者工具为打开状态。导入开发者工具后依次执行npm i > 构建npm包 > 勾选 "将JS编译成ES5"

组件类型

基础步进器

{{ base }}

组件状态

最大最小状态

{{ min-max }}

禁用状态

{{ status }}

组件样式

步进器样式

{{ theme }}

步进器尺寸

{{ size }}

API

Stepper Props

名称 类型 默认值 描述 必传
style Object - 样式 N
custom-style Object - 样式,一般用于开启虚拟化组件节点场景 N
disable-input Boolean false 禁用输入框 N
disabled Boolean undefined 禁用全部操作 N
input-width Number - 输入框宽度,默认单位 px N
integer Boolean true 是否整型 N
max Number 100 最大值 N
min Number 0 最小值 N
size String medium 组件尺寸。可选项small/medium/large。TS 类型:SizeEnum通用类型定义 N
step Number 1 步长 N
theme String normal 组件风格。可选项normal/filled/outline N
value String / Number 0 N
default-value String / Number undefined 值。非受控属性 N

Stepper Events

名称 参数 描述
blur ({ type: string | number }) 输入框失去焦点时触发
change ({ value: string | number }) 数值发生变更时触发
focus ({ value: string | number })) 输入框聚焦时触发
overlimit ({type: 'minus' | 'plus'}) 数值超出限制时触发

Stepper External Classes

类名 描述
t-class 根节点样式类
t-class-input 输入框样式类
t-class-minus 左侧递减号样式类
t-class-plus 右侧递增号样式类

CSS Variables

组件提供了下列 CSS 变量,可用于自定义样式。

名称 默认值 描述
--td-stepper-border-color @component-border -
--td-stepper-border-radius @radius-small -
--td-stepper-input-color @font-gray-1 -
--td-stepper-input-disabled-color @font-gray-4 -