# @aramir/react-native-barcode 中文文档

规范地址：https://npmcn.com/package/%40aramir/react-native-barcode/

版本：1\.1\.2
npm 元数据更新时间：2026-07-25T18:16:29.498Z
中文译文更新时间：2026-11-08T03:17:46.910Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aramir/react-native-barcode
原文对照：https://npmcn.com/package/%40aramir/react-native-barcode/?lang=original
项目主页：https://github.com/aramir/react-native-barcode#readme
源码仓库：https://github.com/aramir/react-native-barcode

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

- 包体积（解压后）：14.3 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19\.4
- 运行依赖：1 个
- peer 依赖：react \>=19，react-native \>=0\.81，react-native-svg \>=15
- 首次发布：2025-07-20T02:04:24.064Z
- 最新版本发布：2026-07-25T18:16:29.330Z
- 近 30 天下载量：1919（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 3 个）

## 中文简介

用途 [js条码](https://github.com/lindell/JsBarcode) 通过本地 svg 渲染生成条码二进制数据 [反应-内生-svg](https://github.com/software-mansion/react-native-svg)。 。 。 .

## 安装

```sh
npm install @aramir/react-native-barcode
```

也可以使用：`pnpm add @aramir/react-native-barcode`、`yarn add @aramir/react-native-barcode`、`bun add @aramir/react-native-barcode`

## README

# 反应原生条码生成器

用途 [js条码](https://github.com/lindell/JsBarcode) 用本地 svg 渲染生成条码二进制数据 通过 [反应-内生-svg](https://github.com/software-mansion/react-native-svg)。 。 。 .

## 安装

```sh
npm install react-native-svg @aramir/react-native-barcode
```

## 使用量

```js
<Barcode format="CODE128" value={"HelloWorld"} />
```

## 属性

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| 价值 | `string` | `""` | 要编码的文本 |
| 宽度 | `number` | `2` | 单行宽度 |
| 最大宽度 | `number` | \- 说吧 | 条码的最大宽度 |
| 高度 | `number` | `100` | 条码的高度 |
| 格式 | `Format` | `CODE128` | 条码格式(下面所支持格式的型号) |
| 线条颜色 | `string` | `#000000` | 设置单个栏的颜色 |
| 背景情况 | `string` | `#ffffff` | 容器背景 (`rgba(0,0,0,0)` 透明度) |
| 文本 | `React.ReactNode` | \- 说吧 | 将在条码下渲染的可选文本 |
| 文本样式 | `TextStyle` | \- 说吧 | 用于文本组件的样式 |
| 样式 | `ViewStyle` | \- 说吧 | 用于容器的样式 |
| 错误 | `(error: Error) => void` | \- 说吧 | 可选错误处理器 |

## 支持的条码格式

-   [CODE128 (英语)](https://github.com/lindell/JsBarcode/wiki/CODE128) - 高密度线性条码符号学定义 ISO/IEC 15417:2007 (英语). 支持所有128个ASCII字符,并高效地编码数字.
    -   CODE128(自动模式切换)
    -   CODE128 A/B/C(部队模式)
-   [东 南](https://github.com/lindell/JsBarcode/wiki/EAN) - 欧洲条款编号是一项全球标准,它界定了 条码格式和零售和贸易中使用的独特编号系统.
    -   欧安-13
    -   欧安-8
    -   东5区
    -   东亚-2
    -   刚果爱国者联盟(A)
    -   刚果爱国者联盟(英)
-   [CODE39 (英语)](https://github.com/lindell/JsBarcode/wiki/CODE39) - ISO/IEC16388:2023中定义的离散条码符号学. 规格定义了43个字符,包括大写字母、数字和一些特殊的 字符键.
-   [机构间工作组](https://github.com/lindell/JsBarcode/wiki/ITF-14) - 相隔5的2个是连续的两相间条码 符号编码数字。 在135个胶片、ITF-14条形码和一些产品的纸箱上商业使用 内部产品被贴上刚果爱国者联盟或EAN标签.
    -   机构间工作组
    -   东帝汶
-   [毛里求斯](https://github.com/lindell/JsBarcode/wiki/MSI) - 被修改的Plessey是由MSI开发的条码符号 数据公司(Data Corporation),以原始的普莱西代码符号为主. 它是一个连续的象征 而不是 自我检查。 主要用于库存控制、在仓库环境中对储存容器和货架作标记.
    -   毛里求斯10
    -   毛里求斯11
    -   《毛里求斯战略》10
    -   《毛里求斯战略》1110
-   [药典](https://github.com/lindell/JsBarcode/wiki/pharmacode) - 药品二进制码,是条码 标准,在制药业用作包装控制系统。 设计为尽管打印但仍可读 错误.
-   [科达巴](https://github.com/lindell/JsBarcode/wiki/codabar) - 线性条码符号设计,以便准确读取 即使是被打印在点矩阵打印机上,用于多部分形式,如FedEx Airbells和血库表格.
-   CODE93 - 由Intermec于1982年设计,以提供更高密度和数据的字母,可变长度符号 安全增强到代码39.

## 常见问题

### @aramir/react-native-barcode 是什么？

用途 js条码 通过本地 svg 渲染生成条码二进制数据 反应-内生-svg。 。 。 \.

### 如何安装 @aramir/react-native-barcode？

在项目目录运行 npm install @aramir/react-native-barcode，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19）、react-native（\>=0\.81）、react-native-svg（\>=15）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aramir/react-native-barcode 支持 TypeScript 吗？

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

### @aramir/react-native-barcode 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aramir/react-native-barcode 需要什么版本的 Node\.js？

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

### @aramir/react-native-barcode 可以商用吗？

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

### @aramir/react-native-barcode 的下载量有多少？

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

### @aramir/react-native-barcode 还在维护吗？

最新版本 1\.1\.2 发布于 2026/07/26（3 个月前）；至今共发布 6 个版本，其中过去 12 个月发布了 3 个；首次发布于 2025/07/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。