# @dintecom/ngx-currency 中文文档

规范地址：https://npmcn.com/package/%40dintecom/ngx-currency/

版本：22\.0\.0
npm 元数据更新时间：2026-07-06T20:23:05.173Z
中文译文更新时间：2026-11-12T10:21:01.703Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dintecom/ngx-currency
原文对照：https://npmcn.com/package/%40dintecom/ngx-currency/?lang=original
项目主页：https://github.com/dintecom/ngx-currency
源码仓库：https://github.com/dintecom/ngx-currency

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：98.7 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@angular/common ^22\.0\.0，@angular/core ^22\.0\.0，@angular/forms ^22\.0\.0
- 首次发布：2025-12-09T00:56:14.738Z
- 最新版本发布：2026-07-06T20:23:04.874Z
- 近 30 天下载量：14950（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

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

## 安装

```sh
npm install @dintecom/ngx-currency
```

也可以使用：`pnpm add @dintecom/ngx-currency`、`yarn add @dintecom/ngx-currency`、`bun add @dintecom/ngx-currency`

## README

# ngx-货币

[![npm version](https://badge.fury.io/js/@dintecom%2Fngx-currency.png)](https://www.npmjs.com/package/@dintecom/ngx-currency) [![GitHub issues](https://img.shields.io/github/issues/dintecom/ngx-currency.png)](https://github.com/dintecom/ngx-currency/issues) [![GitHub stars](https://img.shields.io/github/stars/dintecom/ngx-currency.png)](https://github.com/dintecom/ngx-currency/stargazers) [![GitHub license](https://img.shields.io/badge/license-MIT-blue.png)](https://raw.githubusercontent.com/dintecom/ngx-currency/master/LICENSE)

## 演示

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

## 目录

-   [开始](https://npmcn.com/package/%40dintecom/ngx-currency/#readme-getting-started)
-   [文档](https://nbfontana.github.io/ngx-currency/docs/)
-   [发展](https://npmcn.com/package/%40dintecom/ngx-currency/#readme-development)
-   [许可证](https://npmcn.com/package/%40dintecom/ngx-currency/#readme-license)

## 开始

### 安装和导入

通过命令安装软件包 :

```sh
npm install ngx-currency --save
```

导入指令

```ts
import { NgxCurrency } from "ngx-currency";

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

### 使用

```html
<input type="text" inputmode="decimal" currencyMask formControlName="value" />
```

-   `ngModel` 类型数的属性 。 如果显示 `'$ 25.63'`,属性将是 `'25.63'`。 。 。 .

### 选项

您可以设置选项...

```html
<!-- 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'`

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

```ts
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](http://nodejs.org/) 国家防范机制
-   安装本地依赖 : `npm install` 当前目录是此 repo

### 开发服务器

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

```bash
npm start
```

### 大楼

要建立库运行 :

```bash
npm run build:lib
```

### 测试

执行单位测试 [维特](https://vitest.dev/) 测试跑道,使用以下命令:

```bash
npm test
```

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

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

## 许可证

麻省理工学院 @ Neri Bez Fontana

## 常见问题

### @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 和提交记录判断。