@alexzunik/react-native-money-input

中文文档
0.5.4发布于 2026/09/06MITTypeScriptESM + CJS零依赖近 30 天下载 3980

React 本地货币输入

中文使用文档
文档目录8 节
  1. 示例
  2. * 安装
  3. 使用量
  4. ++ Propals 软件
  5. qq限制
  6. 测试
  7. 捐款
  8. 许可证

反应-本土-资金投入

MIT license Current npm package version Downloads Total downloads

完全的本土资金投入 反应土著。 基于原始文本输入组件 .

示例

iOS系统机器人
iOS DemoAndroid Demo

* 安装

yarn add @alexzunik/react-native-money-input

npx pod-install

使用量

import { MoneyTextInput } from '@alexzunik/react-native-money-input';

// ...

const Component = () => {
  const [value, setValue] = React.useState<string>();
  return (
    <MoneyTextInput
        value={value}
        onChangeText={(formatted, extracted) => {
          console.log(formatted) // $1,234,567.89
          console.log(extracted) // 1234567.89
          setValue(extracted)
        }}
        prefix="$"
        groupingSeparator=","
        fractionSeparator="."
      />
  )
}

++ Propals 软件

该组件完全继承了文本输入道具并带来了新的道具. 见下文:

export interface MoneyTextInputProps extends TextInputProps, MaskOptions {
  /**
   * Callback with entered value
   *
   * @param formatted {string} formatted text
   * @param extracted {string} extracted text
   */
  onChangeText: (formatted: string, extracted?: string) => void;
}

interface MaskOptions {
  /**
   * Separator between integer number groups
   *
   * Default: `space`
   */
  groupingSeparator?: string;
  /**
   * Separator between integer and fraction parts.
   * Will be ignored if you set maximumFractionalDigits = 0
   *
   * Default: system separator
   */
  fractionSeparator?: string;
  /**
   * Prefix before number.
   *
   * For example: if prefix = `$` input will be `$1,234.43`
   *
   * Default: `undefined`
   */
  prefix?: string;
  /**
   * Suffix after number.
   *
   * For example: if suffix = ` EUR` input will be `1 234,43 EUR`
   *
   * Default: `undefined`
   */
  suffix?: string;
  /**
   * Maximum length in integer part, exclude separators
   * Maximum possible value is 36
   *
   * Default: `36`
   */
  maximumIntegerDigits?: number;
  /**
   * Maximum length in fractional part
   *
   * Default: `2`
   */
  maximumFractionalDigits?: number;
  /**
   * Minimum numeric value.
   * It will be set to input if user enters value less than minValue
   */
  minValue?: number;
  /**
   * Maximum numeric value.
   * It will be set to input if user enters value greater than maxValue
   */
  maxValue?: number;
}

qq限制

  • 财产的最大可能价值 maximumIntegerDigits 实值 36

测试

为了装入由反应-内在-金钱输入提供的模拟器,请在 jest.config.json 中添加以下您在 joest 配置中:

"setupFiles": ["./node_modules/@alexzunik/react-native-money-input/jest/setup.js"]

捐款

见 贡献指南 学习如何为储存库和发展工作流程作出贡献.

许可证

麻省理工学院

版本与发布记录

@alexzunik/react-native-money-input 共发布 22 个版本,首次发布于 2023/02/16;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.5.4latest2026/09/062 个月前
0.5.32025/09/301.1 年前
0.5.22025/09/281.1 年前
0.5.12025/09/211.1 年前
0.5.02025/09/201.1 年前
0.4.22025/09/201.1 年前

关于 @alexzunik/react-native-money-input 的常见问题

@alexzunik/react-native-money-input 是什么?

React 本地货币输入

如何安装 @alexzunik/react-native-money-input?

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

@alexzunik/react-native-money-input 支持 TypeScript 吗?

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

@alexzunik/react-native-money-input 支持 ESM 还是 CommonJS?

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

@alexzunik/react-native-money-input 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 16.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@alexzunik/react-native-money-input 可以商用吗?

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

@alexzunik/react-native-money-input 的下载量有多少?

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

@alexzunik/react-native-money-input 还在维护吗?

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