Skip to content

FaNumberField 数字输入框

数字输入框组件,支持增减按钮和数值范围控制。

使用场景

  • 数字输入框组件,支持增减按钮和数值范围控制。
  • 常见用法:最小值 / 最大值 / 步长、禁用状态、带自定义宽度。

Props

参数说明类型默认值
modelValue绑定值numberrequired
min最小值numberundefined
max最大值numberundefined
step步长numberundefined
disabled是否禁用booleanfalse
class自定义类名HTMLAttributes['class']undefined

Slots

名称说明
-无插槽

Events

事件名说明回调参数
update:modelValue值更新时触发(value: number)

示例

基础用法

vue
<script setup lang="ts">
const value = ref(0)
</script>

<template>
  <FaNumberField v-model="value" />
</template>

最小值 / 最大值 / 步长

vue
<script setup lang="ts">
const value = ref(10)
</script>

<template>
  <FaNumberField v-model="value" :min="0" :max="100" :step="5" />
</template>

禁用状态

vue
<script setup lang="ts">
const value = ref(50)
</script>

<template>
  <FaNumberField v-model="value" disabled />
</template>

带自定义宽度

vue
<script setup lang="ts">
const value = ref(0)
</script>

<template>
  <FaNumberField v-model="value" class="w-[300px]" />
</template>

注意事项

  • 无特殊限制,建议按示例中的受控方式接入,并结合业务容器尺寸验证最终展示效果。