InputNumber 数字输入框

通过鼠标或键盘，输入范围内的数值。

何时使用

当需要获取标准数值时。

代码演示

基本用法

数字输入框。

<template>
  <div>
    <a-input-number id="inputNumber" v-model:value="value" :min="1" :max="10" />
    当前值：{{ value }}
  </div>
</template>
<script lang="ts">
import { defineComponent, ref } from 'vue';
export default defineComponent({
  setup() {
    const value = ref<number>(3);
    return {
      value,
    };
  },
});
</script>

不可用

点击按钮切换可用状态。

<template>
  <div>
    <a-input-number :min="1" :max="10" :disabled="disabled" v-model:value="value" />
    <div style="margin-top: 20px">
      <a-button type="primary" @click="toggle">Toggle disabled</a-button>
    </div>
  </div>
</template>
<script lang="ts">
import { defineComponent, ref } from 'vue';
export default defineComponent({
  setup() {
    const value = ref<number>(3);
    const disabled = ref<boolean>(true);
    const toggle = () => {
      disabled.value = !disabled.value;
    };
    return {
      value,
      disabled,
      toggle,
    };
  },
});
</script>

格式化展示

通过 formatter 格式化数字，以展示具有具体含义的数据，往往需要配合 parser 一起使用。

<template>
  <div>
    <a-input-number
      v-model:value="value1"
      :formatter="value => `$ ${value}`.replace(/\B(?=(\d{3})+(?!\d))/g, ',')"
      :parser="value => value.replace(/\$\s?|(,*)/g, '')"
    />
    <a-input-number
      v-model:value="value2"
      :min="0"
      :max="100"
      :formatter="value => `${value}%`"
      :parser="value => value.replace('%', '')"
    />
  </div>
</template>
<script lang="ts">
import { defineComponent, ref } from 'vue';
export default defineComponent({
  setup() {
    const value1 = ref<number>(1000);
    const value2 = ref<number>(100);
    return {
      value1,
      value2,
    };
  },
});
</script>

三种大小

三种大小的数字输入框，当 size 分别为 large 和 small 时，输入框高度为 40px 和 24px ，默认高度为 32px。

<template>
  <div>
    <a-input-number size="large" :min="1" :max="100000" v-model:value="value1" />
    <a-input-number :min="1" :max="100000" v-model:value="value2" />
    <a-input-number size="small" :min="1" :max="100000" v-model:value="value3" />
  </div>
</template>
<script lang="ts">
import { defineComponent, ref } from 'vue';
export default defineComponent({
  setup() {
    const value1 = ref<number>(3);
    const value2 = ref<number>(3);
    const value3 = ref<number>(3);
    return {
      value1,
      value2,
      value3,
    };
  },
});
</script>
<style scoped>
.ant-input-number {
  margin-right: 10px;
}
</style>

小数

和原生的数字输入框一样，value 的精度由 step 的小数位数决定。

<template>
  <a-input-number v-model:value="value" :min="0" :max="10" :step="0.1" />
</template>
<script lang="ts">
import { defineComponent, ref } from 'vue';
export default defineComponent({
  setup() {
    const value = ref<number>();
    return {
      value,
    };
  },
});
</script>

API

属性如下

事件

方法