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/input-number.md.
v0.0.57
  • 简体中文
  • InputNumber

    数据录入@rockshin/tao-ui

    输入并格式化货币、百分比及其他数值。

    何时使用

    数值需要范围、小数位、前后缀或本地化分隔符时使用 InputNumber。

    推荐

    • 明确展示单位与格式。
    • 范围限制应与错误提示一致。

    避免

    • 普通文本或编号标识不要使用数值输入。

    代码演示

    基础用法

    $USD
    TSX

    货币与百分比

    €
    %
    TSX

    尺寸、变体与范围

    TSX

    货币格式

    千位分隔符、两位小数和前缀只改变展示,输出值便于业务计算。

    €
    actual value: "150000"
    TSX

    前后缀

    用前后缀表达单位,避免将单位混入业务数值。

    $USD
    actual value: ""
    TSX

    三种尺寸

    比较三种输入尺寸,数值处理规则保持一致。

    ¥
    ¥
    ¥
    TSX

    外观变体

    在不同外观下使用相同的受控输入逻辑。

    ¥
    ¥
    ¥
    TSX

    百分比

    配置小数精度和百分号后缀,本例不自动换算百分比与小数。

    %
    actual value: ""
    TSX

    数值上下限

    设置允许的范围,输入和失焦后的值应遵循范围配置。

    actual value: ""
    TSX

    地区格式

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

    API

    InputNumber

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