For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/headless-input-number.md.
v0.0.57
  • 简体中文
  • HeadlessInputNumber

    无样式组件@rockshin/tao-ui

    提供数值输入的解析、格式化与约束逻辑,不绑定产品视觉。

    何时使用

    需要完全自定义数值输入外观,同时复用可靠的数值行为时使用 HeadlessInputNumber。

    推荐

    • 明确配置小数位与分隔符。
    • 显示值与提交值保持可预测转换。

    避免

    • 不需要自定义视觉时优先使用 InputNumber。

    代码演示

    基础用法

    $
    TSX

    格式化与前后缀

    $USD%
    TSX

    本地化分隔符与范围

    units
    TSX

    千位分隔

    配置千位与小数分隔符,同时观察显示内容和实际输出值。

    actual value: ""
    TSX

    前后缀格式

    为无样式输入配置单位或货币标识,组件仍负责数值处理。

    $USDactual value: ""
    TSX

    百分比数值

    使用百分号和小数精度;业务层自行定义百分比换算规则。

    %actual value: ""
    TSX

    允许负数

    启用负数输入,比较输入中的中间态与完整数值。

    actual value: ""
    TSX

    范围限制

    通过上下限控制可接受值,观察失焦时的处理。

    actual value: ""
    TSX

    失焦补齐小数

    输入完成后按指定精度补齐小数位。

    actual value: ""
    TSX

    本地化分隔符

    将点号作为千位分隔符、逗号作为小数分隔符。

    actual value: ""
    TSX

    地区格式

    地区分组、小数符号和数字字符继承 TaoProvider.locale.numberLocale,也可用组件 locale="fr-FR" 覆盖。显式分隔符优先;数字输入在本地化显示的同时保留规范 ASCII 字符串及精度。

    API

    HeadlessInputNumber

    属性说明类型默认值
    className节点类名string | undefined-
    localeBCP 47 locale. Defaults to the provider's number locale.string | undefined-

    NumberInput

    属性说明类型默认值
    className节点类名string | undefined-
    localeBCP 47 locale. Defaults to the provider's number locale.string | undefined-