# @futurejj/react-native-checkbox 中文文档 规范地址：https://npmcn.com/package/%40futurejj/react-native-checkbox/ 版本：1\.0\.10 npm 元数据更新时间：2026-10-25T11:32:24.730Z 中文译文更新时间：2026-11-15T18:56:39.208Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40futurejj/react-native-checkbox 原文对照：https://npmcn.com/package/%40futurejj/react-native-checkbox/?lang=original 项目主页：https://github.com/JairajJangle/react-native-checkbox#readme 源码仓库：https://github.com/JairajJangle/react-native-checkbox ## 关键信息（来自 npm 元数据） - 包体积（解压后）：32.7 kB，25 个文件 - 模块格式：CommonJS - TypeScript 类型：包内自带 - 运行依赖：0 个 - peer 依赖：react \*，react-native \*，react-native-vector-icons \* - 首次发布：2025-05-10T14:17:10.995Z - 最新版本发布：2026-10-25T11:32:24.321Z - 近 30 天下载量：70522（2026-10-16 至 2026-11-14，npm 官方下载统计） - 已发布版本数：14（近 12 个月 5 个） ## 中文简介 用于本地反应的纸质复选框 ## 安装 ```sh npm install @futurejj/react-native-checkbox ``` 也可以使用：`pnpm add @futurejj/react-native-checkbox`、`yarn add @futurejj/react-native-checkbox`、`bun add @futurejj/react-native-checkbox` ## README # @futurejj/反应- native-检查框 用于本地反应的纸质复选框 [![npm version](https://img.shields.io/npm/v/%40futurejj%2Freact-native-checkbox)](https://badge.fury.io/js/%40futurejj%2Freact-native-checkbox) ![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg) [![Workflow Status](https://github.com/JairajJangle/react-native-checkbox/actions/workflows/ci.yml/badge.svg)](https://github.com/JairajJangle/react-native-checkbox/actions/workflows/ci.yml) ![Android](https://img.shields.io/badge/-Android-555555?logo=android&logoColor=3DDC84) ![iOS](https://img.shields.io/badge/-iOS-555555?logo=apple&logoColor=white) ![Web](https://img.shields.io/badge/-Web-555555?logo=google-chrome&logoColor=0096FF) [![GitHub issues](https://img.shields.io/github/issues/JairajJangle/react-native-checkbox)](https://github.com/JairajJangle/react-native-checkbox/issues?q=is%3Aopen+is%3Aissue) ![TS](https://img.shields.io/badge/TypeScript-strict_%F0%9F%92%AA-blue) [![Expo Snack](https://img.shields.io/badge/Expo%20Snack-555555?style=flat&logo=expo&logoColor=white)](https://snack.expo.dev/@futurejj/react-native-checkbox-example) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40futurejj%2Freact-native-checkbox) [![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-ea4aaa?style=flat&logo=github-sponsors)](https://github.com/sponsors/JairajJangle) 一个美丽的,可自定义的,和动画的复选框组件,用于React Industrial应用程序. 这个组件在iOS,Android,和Web平台之间工作,具有平滑动画和可访问性支持. ![React Native Animated Checkbox Demo](https://media0.giphy.com/media/v1.Y2lkPTc5MGI3NjExZnl6dG1mOXJ5bGd6bTVrMWV5YnAzMmkzYTRvbWFjZ2RkMjh4eHl3dyZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/Pegf3CERuvAllv0dxv/giphy.gif) ## 特征 - 关于状态变化的美丽动画 - 完全自定义的颜色和样式 - • 跨平台(iOS、Android、Web) - 3个州:检查、检查和不确定 - \* 内置无障碍支持 - 适应各种设计需要的自定义大小 - QQ 与 Expo 和标准 React 本地工作 - QQ TypeScript 支持完整类型定义 ## 安装 ```bash yarn add @futurejj/react-native-checkbox # or npm install @futurejj/react-native-checkbox ``` ### 图标依赖性 这个组件使用物质社区图标. 你需要安装任一: - `@expo/vector-icons` (如果使用博览会-内置) - `react-native-vector-icons` (如果使用 React 本地 CLI - 遵循安装指令 `react-native-vector-icons`(中文(简体) ) ## 使用量 ### 基本示例 ```jsx import React, { useState } from 'react'; import { View } from 'react-native'; import { Checkbox } from '@futurejj/react-native-checkbox'; export default function CheckboxExample() { const [checked, setChecked] = useState(false); const toggleCheckbox = () => { setChecked(!checked); }; return ( ); } ``` ### 自定义 ```jsx {}} // handle press events color="#6200ee" // color when checked uncheckedColor="#757575" // color when unchecked size={32} // customize size (default: 24) style={{ marginRight: 8 }} // additional styles for the container /> ``` ## API 参考 ### 道具 | Prop | 类型 | 默认 | 说明 | | --- | --- | --- | --- | | `status` | `'checked' OR 'unchecked' OR 'indeterminate'` | 需求 | 复选框当前状态 | | `disabled` | `boolean` | `false` | 复选框是否被禁用 | | `onPress` | `(e: GestureResponderEvent) => void` | 需求 | 按下复选框时打回 | | `color` | `string` | `'#2196F3'` | 选中时复选框的颜色 | | `uncheckedColor` | `string` | `'#757575'` | 未选中的复选框颜色 | | `size` | `number` | `24` | 复选框图标的大小 | | `testID` | `string` | \- 说吧 | 测试框架的测试ID | | `style` | `StyleProp` | \- 说吧 | 容器的额外样式 | ## 动画 复选框包括平滑动画 : - 在状态间过渡时缩放动画 - 自定义更多互动的边框动画 ## 无障碍 这一组成部分是在无障碍的基础上建立的: - 适当的角色分配`checkbox`(中文(简体) ) - 向屏幕阅读器报告的正确状态 - 动态变化实时区域更新 ## 捐款 见 [贡献指南](https://npmcn.com/package/%40futurejj/react-native-checkbox/CONTRIBUTING.md) 学习如何为储存库和发展工作流程作出贡献. ## 许可证 麻省理工学院 * * * ## \* 支持项目 [![LiberPay\_Donation\_Button](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/FutureJJ/donate)          [![Paypal\_Donation\_Button](https://npmcn.com/package/%40futurejj/react-native-checkbox/.github/assets/upi.png) ](https://npmcn.com/package/%40futurejj/react-native-checkbox/.github/assets/Jairaj_Jangle_Google_Pay_UPI_QR_Code.jpg)          [![Paypal\_Donation\_Button](https://npmcn.com/package/%40futurejj/react-native-checkbox/.github/assets/paypal_donate.png)](https://www.paypal.com/paypalme/jairajjangle001/usd) ## 谢谢 - 模块使用 [创建- 反应- 本土- 图书馆](https://github.com/callstack/react-native-builder-bob) - 受到重创 [反应原生纸的复选框. 机器人](https://callstack.github.io/react-native-paper/docs/components/Checkbox/CheckboxAndroid) 组件 - Readme 编辑时使用 [泰波拉语Name](https://typora.io/) ## 常见问题 ### @futurejj/react-native-checkbox 是什么？ 用于本地反应的纸质复选框 ### 如何安装 @futurejj/react-native-checkbox？ 在项目目录运行 npm install @futurejj/react-native-checkbox，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\*）、react-native（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @futurejj/react-native-checkbox 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @futurejj/react-native-checkbox 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @futurejj/react-native-checkbox 可以商用吗？ @futurejj/react-native-checkbox 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @futurejj/react-native-checkbox 的下载量有多少？ 根据 npm 官方下载统计，@futurejj/react-native-checkbox 在 2026/10/16 – 2026/11/14 这 30 天内被下载 70,522 次，日均约 2,351 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @futurejj/react-native-checkbox 还在维护吗？ 最新版本 1\.0\.10 发布于 2026/10/25（21 天前）；至今共发布 14 个版本，其中过去 12 个月发布了 5 个；首次发布于 2025/05/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。