Skip to content

H5预览

APP下载

InputNumber 计数器 ​

cl-input-number 是一个数字输入计数器组件,支持通过加减按钮或直接输入来调整数值,并可设置数值范围和步长。

参数 ​

参数说明类型可选值默认值
pt样式穿透配置PassThrough——
modelValue当前绑定的数值number—0
step每次点击加减按钮的步长number—1
max允许输入的最大数值number—100
min允许输入的最小数值number—0
inputable是否允许手动输入数值boolean—true
size加减按钮的尺寸大小(px)number—24
disabled是否禁用组件boolean—false
inputType输入框的数值类型string"digit" | "number"'number'
placeholder输入框的占位提示文本string——

事件 ​

事件名称说明回调参数
change数值发生变化时触发的事件value: number

PassThrough ​

样式穿透配置允许您自定义组件内部各个元素的样式,实现更灵活的外观定制。

参数说明类型
className组件根元素样式string
value中间数值显示区配置ValuePassThrough
op左右加减按钮配置OpPassThrough
ts
type ValuePassThrough = {
	className?: string;
	input?: PassThroughProps;
};
ts
type OpPassThrough = {
	className?: string;
	minus?: PassThroughProps;
	plus?: PassThroughProps;
	icon?: ClIconProps;
};

示例 ​

基础用法 ​

最简单的计数器,默认值为 0,步长为 1:

html
<cl-input-number></cl-input-number>

设置步长 ​

设置每次点击按钮时的数值变化量:

html
<cl-input-number :step="5"></cl-input-number>

调整尺寸 ​

自定义加减按钮的大小:

html
<cl-input-number :size="60"></cl-input-number>

限制数值范围 ​

设置数值的最小值和最大值(4~20):

html
<cl-input-number :min="4" :max="20"></cl-input-number>

自定义样式 ​

通过 PassThrough 配置自定义组件外观,如设置圆形按钮:

vue
<cl-input-number
	:pt="{
		op: {
			className: '!rounded-full'
		},
		value: {
			className: '!rounded-full'
		}
	}"
></cl-input-number>