InputNumber 数字输入框

介绍

通过点击按钮控制数字增减。

安装

  1. import { createApp } from 'vue';
  2. import { InputNumber,Icon } from '@nutui/nutui';
  3. const app = createApp();
  4. app.use(InputNumber).use(Icon);

代码演示

基础用法

初始化一个默认值

  1. <nut-inputnumber v-model="value" />
  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. const value = ref(1);
  5. return { value };
  6. },
  7. };

步长设置

设置步长 step 5

  1. <nut-inputnumber v-model="value" step="5" />

限制输入范围

minmax 属性分别表示最小值和最大值

  1. <nut-inputnumber v-model="value" min="10" max="20" />

禁用状态

disabled 禁用状态下无法点击按钮或修改输入框。

  1. <nut-inputnumber v-model="value" disabled />

只读禁用输入框

readonly 设置只读禁用输入框输入行为

  1. <nut-inputnumber v-model="value" readonly />

支持小数点

设置步长 step 0.1 decimal-places 小数保留1位

  1. <nut-inputnumber v-model="value" step="0.1" decimal-places="1" />

支持异步修改

通过 change 事件和 model-value 进行异步修改

  1. <nut-inputnumber :model-value="value" @change="onChange" />
  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. const value = ref(1);
  5. const onChange = (value: number) => {
  6. setTimeout(() => {
  7. value.value = value;
  8. }, 2000);
  9. };
  10. return { value,onChange };
  11. },
  12. };

自定义按钮大小

设置步长 step 0.1 decimal-places 小数保留1位

  1. <nut-inputnumber v-model="value" button-size="30" input-width="50" />

API

Props

参数说明类型默认值
v-model初始值String、Number-
input-width输入框宽度String40px
button-size操作符+、-尺寸String20px
min最小值限制String、Number1
max最大值限制String、Number9999
step步长String、Number1
decimal-places设置保留的小数位String、Number0
disabled禁用所有功能Booleanfalse
readonly只读状态禁用输入框操作行为Booleanfalse

Events

事件名说明回调参数
add点击增加按钮时触发event: Event
reduce点击减少按钮时触发event: Event
overlimit点击不可用的按钮时触发event: Event
change值改变时触发value: number , event : Event
blur输入框失去焦点时触发event: Event
focus输入框获得焦点时触发event: Event

InputNumber  数字输入框 - 图1