简体中文
FxInputNumber
约 720 字大约 2 分钟
2025-12-16
仅允许输入标准的数字值,可定义范围
参数
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| value / v-model | 绑定值 | number | — | 0 |
| min | 设置计数器允许的最小值 | number | — | -Infinity |
| max | 设置计数器允许的最大值 | number | — | Infinity |
| step | 计数器步长 | number | — | 1 |
| step-strictly | 是否只能输入 step 的倍数 | number | — | false |
| precision | 数值精度 | number | — | — |
| size | 计数器尺寸 | string | large, small | — |
| disabled | 是否禁用计数器 | boolean | — | false |
| controls | 是否使用控制按钮 | boolean | — | true |
| controls-position | 控制按钮位置 | string | right | - |
| name | 原生属性 | string | — | — |
| label | 输入框关联的label文字 | string | — | — |
| placeholder | 输入框默认 placeholder | string | - | - |
Events
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| change | 绑定值被改变时触发 | currentValue, oldValue |
| blur | 在组件 Input 失去焦点时触发 | (event: Event) |
| focus | 在组件 Input 获得焦点时触发 | (event: Event) |
Methods
| 方法名 | 说明 | 参数 |
|---|---|---|
| focus | 使 input 获取焦点 | - |
| select | 选中 input 中的文字 | — |
基础用法
<template>
<fx-input-number v-model="num" @change="handleChange" :min="1" :max="10" label="描述文字"></fx-input-number>
</template>
<script>
export default {
data() {
return {
num: 1
};
},
methods: {
handleChange(value) {
console.log(value);
}
}
};
</script>禁用状态
<template>
<fx-input-number v-model="num" :disabled="true"></fx-input-number>
</template>
<script>
export default {
data() {
return {
num: 1
}
}
};
</script>步数
允许定义递增递减的步数控制
<template>
<fx-input-number v-model="num" :step="2"></fx-input-number>
</template>
<script>
export default {
data() {
return {
num: 5
}
}
};
</script>严格步数
<template>
<fx-input-number v-model="num" :step="2" step-strictly></fx-input-number>
</template>
<script>
export default {
data() {
return {
num: 2
}
}
};
</script>精度
<template>
<fx-input-number v-model="num" :precision="2" :step="0.1" :max="10"></fx-input-number>
</template>
<script>
export default {
data() {
return {
num: 1
}
}
};
</script>提示
precision 的值必须是一个非负整数,并且不能小于 step 的小数位数。
尺寸
额外提供了 medium、small、mini 三种尺寸的数字输入框
<template>
<fx-input-number v-model="num1"></fx-input-number>
<fx-input-number size="medium" v-model="num2"></fx-input-number>
<fx-input-number size="small" v-model="num3"></fx-input-number>
<fx-input-number size="mini" v-model="num4"></fx-input-number>
</template>
<script>
export default {
data() {
return {
num1: 1,
num2: 1,
num3: 1,
num4: 1
}
}
};
</script>按钮位置
<template>
<fx-input-number v-model="num" controls-position="right" @change="handleChange" :min="1" :max="10"></fx-input-number>
</template>
<script>
export default {
data() {
return {
num: 1
};
},
methods: {
handleChange(value) {
console.log(value);
}
}
};
</script>