@ericblade/react-currency-input

中文文档
1.4.6发布于 2026/10/20MITTypeScriptESM + CJS构建来源已验证近 30 天下载 6050

输入货币金额的反应组件

中文使用文档
文档目录10 节
  1. 测试整个反应版本
  2. 代码演示
  3. 以下预叉读取
  4. 变动
  5. 页:1
  6. 安装
  7. 一体化
  8. 分离器和精度
  9. 货币
  10. 选项

@ ericblade/ react- 货币输入

Rolling Versions

货币输入的现代反应组件. 叉从 https://github.com/jsillitoe/react-货币投入

支持自定义小数和千位分隔符以及精确度.

输入时格式独特,包括小数和千分数,精度,前缀和后缀. 我还没有找到任何其他的货币投入来做这件事, 并且原作已经很久没有被触动过,所以我叉了这个.

原作以来的变化

  • 现在在类型脚本中
  • 支持反应 16、17、18、19
  • 全新的自动测试设置 齐压 Playwright (1.4.2+中新建) (中文(简体) )
  • 自动化测试设置更加彻底
  • Cart选取重装 似乎到处都行
  • 用于处理 Gboard 的问题

测试整个反应版本

此套件可在当地针对回放16至19进行测试:

npm run test:react16
npm run test:react17
npm run test:react18
npm run test:react19

全部按顺序运行 :

npm run test:matrix

代码演示

有一个代码Pen,你可以用它来观察动作中的组件, 玩它的所有参数来观察它是如何工作的。 它用React和TypeScript来写. 代码链接

有第二个 CodePen, 它在源代码的"示例"目录中反映了演示应用: 代码链接

以下预叉读取

变动

页:1

  • 被贬"上变"选取"上变". 此修改参数顺序以更好地匹配 React 默认的输入处理
  • 更新的依赖关系
  • 已添加解析Float多填充
  • 处理活动汇集问题的持久活动
  • 其他错误修正 .

安装

npm install @ericblade/react-currency-input --save

一体化

您可以存储您状态中的更改处理器所传递的值 .

import React from 'react'
import CurrencyInput from '@ericblade/react-currency-input';

const MyApp = React.createClass({
    getInitialState(){
        return ({amount: "0.00"});
    },

    handleChange(event, maskedvalue, floatvalue){
        this.setState({amount: maskedvalue});
    },
    render() {
        return (
            <div>
                <CurrencyInput value={this.state.amount} onChangeEvent={this.handleChange}/>
            </div>
        );
    }
});
export default MyApp

您也可以指定一个引用, 然后使用调用调用 MaskedValue () 访问该值 .

import React from 'react'
import CurrencyInput from '@ericblade/react-currency-input';

const MyApp = React.createClass({
    handleSubmit(event){
        event.preventDefault();
        console.log(this.refs.myinput.getMaskedValue())
    },
    render() {
        return (
            <form onSubmit={this.handleSubmit}>
                <CurrencyInput ref="myinput" />
            </form>
        );
    }
});
export default MyApp

分离器和精度

指定自定义小数和千位分隔符 :

    // 1.234.567,89
    <CurrencyInput decimalSeparator="," thousandSeparator="." />

指定具体精确度 :

    // 123,456.789
    <CurrencyInput precision="3" />
    // 123,456,789
    <CurrencyInput precision="0" />

货币

可选设置货币符号作为前缀或后缀

    // $1,234,567.89
    <CurrencyInput prefix="$" />
    // 1,234,567.89 kr
    <CurrencyInput suffix=" kr" />

在前缀之前出现负数

    // -$20.00
    <CurrencyInput prefix="$" value="-20.00" />

所有其他属性都应用于输入元素. 例如,可以集成靴子纹章:

    <CurrencyInput className="form-control" />

选项

选项默认值说明
价值0 个初始货币价值
变化事件无回调处理值变化的函数
精确度2个小数点分隔符后的数字
小数分隔符''小数分隔符
千位分隔符','"千分仪
输入类型"文字" (中文(简体) )输入字段标记类型 。 您也许想要使用 number 或者说 tel* 联合国
允许无虚假允许输入中的负数
允许虚假若无 value ,如果开始为无效(true)或“(......)false(中文(简体) )
选择全部焦点虚假选择焦点或非焦点上的所有文本
前缀''货币前缀
后缀''货币后缀
自动聚焦虚假自动聚焦
点击无通过输入
焦点无内部焦点处理后调用
布莱尔无内部模糊处理后调用
样式无通过输入
编号无通过输入
选项卡索引无通过输入

* 联合国说明: 启用任何与口罩相关的特性,例如前缀,后缀或带有输入Type="数字"或"tel"的分隔符,都可能触发出错. 在这些输入类型中,大多数字符无效.

版本与发布记录

@ericblade/react-currency-input 共发布 18 个版本,首次发布于 2022/01/09;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.4.6latest2026/10/2024 天前
1.4.52025/12/1610 个月前
1.4.42024/07/222 年前
1.4.32024/07/222 年前
1.4.12023/07/063 年前
1.4.02023/07/033 年前

关于 @ericblade/react-currency-input 的常见问题

@ericblade/react-currency-input 是什么?

输入货币金额的反应组件

如何安装 @ericblade/react-currency-input?

在项目目录运行 npm install @ericblade/react-currency-input,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.14.0 <20)、react-dom(>=16.14.0 <20)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@ericblade/react-currency-input 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@ericblade/react-currency-input 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@ericblade/react-currency-input 可以商用吗?

@ericblade/react-currency-input 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ericblade/react-currency-input 的下载量有多少?

根据 npm 官方下载统计,@ericblade/react-currency-input 在 2026/10/14 – 2026/11/12 这 30 天内被下载 6,050 次,日均约 202 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ericblade/react-currency-input 还在维护吗?

最新版本 1.4.6 发布于 2026/10/20(24 天前);至今共发布 18 个版本,其中过去 12 个月发布了 2 个;首次发布于 2022/01/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。