Skip to content

数字输入框 InputNumber


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

何时使用

  • 当需要获取标准数值时

基本使用

Show Code
vue
<script setup lang="ts">
import { ref, watchEffect } from 'vue'
const value = ref(3)
watchEffect(() => {
  console.log('value:', value.value)
})
</script>
<template>
  <InputNumber v-model:value="value" />
</template>

步长为小数

Show Code
vue
<script setup lang="ts">
import { ref, watchEffect } from 'vue'
const value = ref(3)
watchEffect(() => {
  console.log('value:', value.value)
})
</script>
<template>
  <InputNumber :step="0.1" v-model:value="value" />
</template>

设置数值精度

Show Code
vue
<script setup lang="ts">
import { ref, watchEffect } from 'vue'
const value = ref(3)
watchEffect(() => {
  console.log('value:', value.value)
})
</script>
<template>
  <InputNumber :step="0.3" :precision="2" v-model:value="value" />
</template>

格式化展示

Show Code
vue
<script setup lang="ts">
import { ref, watchEffect } from 'vue'
import { formatNumber } from 'vue-amazing-ui'
const formatValue = ref(1000)
watchEffect(() => {
  console.log('formatValue:', formatValue.value)
})
function formatter (num: string): string {
  return formatNumber(num, 2)
}
</script>
<template>
  <InputNumber :width="120" :step="10" :formatter="formatter" v-model:value="formatValue" />
</template>

自定义最大最小值

Show Code
vue
<script setup lang="ts">
import { ref, watchEffect } from 'vue'
const value = ref(3)
watchEffect(() => {
  console.log('value:', value.value)
})
</script>
<template>
  <InputNumber :min="0" :max="10" v-model:value="value" />
</template>

添加前缀图标

$
Show Code
vue
<script setup lang="ts">
import { ref, watchEffect } from 'vue'
const value = ref(3)
watchEffect(() => {
  console.log('value:', value.value)
})
</script>
<template>
  <InputNumber prefix="$" v-model:value="value" />
</template>

APIs

参数说明类型默认值必传
width输入框宽度,单位pxstring | number90false
min最小值number-Infinityfalse
max最大值numberInfinityfalse
step每次改变步数,可以为小数number1false
precision数值精度number0false
prefix前缀图标string | slot''false
formatter指定展示值的格式Funtion(value: string) => valuefalse
keyboard是否启用键盘快捷键行为(上方向键增,下方向键减)booleantruefalse
value
v-model
当前值number | nullnullfalse

Events

事件名称说明参数
change变化回调(value: number) => void

Released under the MIT License.