@dintecom/ngx-currency

中文文档
22.0.0发布于 2026/07/07MITTypeScriptES Module构建来源已验证近 30 天下载 1.5万

一个非常简单的货币遮盖指令,允许使用带有ngModel的数字属性.

中文使用文档
文档目录12 节
  1. 演示
  2. 目录
  3. 开始
  4. 安装和导入
  5. 使用
  6. 选项
  7. 发展
  8. 准备环境
  9. 开发服务器
  10. 大楼
  11. 测试
  12. 许可证

ngx-货币

npm version GitHub issues GitHub stars GitHub license

演示

https://nbfontana.github.io/ngx-monics/ 互联网档案馆的存檔,存档日期2013-12-21

目录

开始

安装和导入

通过命令安装软件包 :

npm install ngx-currency --save

导入指令

import { NgxCurrency } from "ngx-currency";

@Component({
  selector: "app-root",
  templateUrl: "./app.component.html",
  imports: [NgxCurrency],
})
export class App {}

使用

<input type="text" inputmode="decimal" currencyMask formControlName="value" />
  • ngModel 类型数的属性 。 如果显示 '$ 25.63',属性将是 '25.63'。 。 。 .

选项

您可以设置选项...

<!-- example for pt-BR money -->
<input [currencyMask]="{ prefix: 'R$ ', thousands: '.', decimal: ',' }" formControlName="value" />

可用的选项 :

  • align - 输入文本对齐。 (默认 : right(中文(简体) )
  • allowNegative - 狦 true 可以输入负值。 (默认 : true(中文(简体) )
  • decimal - 小数分隔符(默认: '.'(中文(简体) )
  • precision - 小数位数(默认: 2(中文(简体) )
  • prefix - 金钱前缀( 默认 ): '$ '(中文(简体) )
  • suffix - 货币后缀( 默认 ): ''(中文(简体) )
  • thousands - 千人分隔符(默认: ','(中文(简体) )
  • nullable - 当真,清洁场的价值将是 null,当值为虚假时 0
  • min - 最小值(默认值: undefined(中文(简体) )
  • max - 最大值(默认值: undefined(中文(简体) )
  • inputMode - 确定如何在用户键入时处理数字(默认: Financial(中文(简体) )

输入模式 :

  • Financial - 数字从最高精度小数开始 打入一个数字转换数字. 小数字符被忽略. 大多数现金登记都这样工作。 例如:
    • 键入 '12' 结果 '0.12'
    • 键入 '1234' 结果 '12.34'
    • 键入 '1.234' 结果 '12.34'
  • Natural -数字从小数的左边开始 在小数位移的左边打入数字 数字左; 在小数的右下键替换下一个数字。 大部分文本输入 电子表格是这样工作的。 例如:
    • 键入 '1234' 结果 '1234'
    • 键入 '1.234' 结果 '1.23'
    • 键入 '12.34' 结果 '12.34'
    • 键入 '123.4' 结果 '123.40'

您也可以在全球设置选项...

import { provideEnvironmentNgxCurrency, NgxCurrencyInputMode } from 'ngx-currency';

bootstrapApplication(App, {
  providers: [
    ...
    provideEnvironmentNgxCurrency({
      align: "right",
      allowNegative: true,
      allowZero: true,
      decimal: ",",
      precision: 2,
      prefix: "R$ ",
      suffix: "",
      thousands: ".",
      nullable: true,
      min: null,
      max: null,
      inputMode: NgxCurrencyInputMode.Financial,
    }),
    ...
  ],
}).catch((err) => console.error(err));

发展

准备环境

  • 安装 节点.js 国家防范机制
  • 安装本地依赖 : npm install 当前目录是此 repo

开发服务器

要启动本地开发服务器, 请运行 :

npm start

大楼

要建立库运行 :

npm run build:lib

测试

执行单位测试 维特 测试跑道,使用以下命令:

npm test

在Chrome浏览器中运行时,可以设置代码断点来使用这些指令来调试测试:

  • 从主虚拟浏览器页面单击 Debug 按钮打开调试窗口
  • 新闻 ctrl + shift + i 打开 Chrome 开发工具
  • 新闻 ctrl + p 查找要调试的文件
  • 输入一个文件名, 如 input.handler.ts 并单击文件
  • 在文件中,单击行号设置断点
  • 刷新浏览器窗口以重新运行测试并停止断点

许可证

麻省理工学院 @ Neri Bez Fontana

版本与发布记录

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

版本发布日期距今
22.0.0latest2026/07/074 个月前
21.0.12026/02/208 个月前
20.0.0latest-202026/02/208 个月前
21.0.02025/12/0911 个月前
0.0.02025/12/0911 个月前

关于 @dintecom/ngx-currency 的常见问题

@dintecom/ngx-currency 是什么?

一个非常简单的货币遮盖指令,允许使用带有ngModel的数字属性.

如何安装 @dintecom/ngx-currency?

在项目目录运行 npm install @dintecom/ngx-currency,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@angular/common(^22.0.0)、@angular/core(^22.0.0)、@angular/forms(^22.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@dintecom/ngx-currency 支持 TypeScript 吗?

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

@dintecom/ngx-currency 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dintecom/ngx-currency 可以商用吗?

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

@dintecom/ngx-currency 的下载量有多少?

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

@dintecom/ngx-currency 还在维护吗?

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