@futurejj/react-native-checkbox

中文文档
1.0.10发布于 2026/10/25MITTypeScriptCommonJS零依赖构建来源已验证近 30 天下载 7.1万

用于本地反应的纸质复选框

中文使用文档
文档目录14 节
  1. 特征
  2. 安装
  3. 图标依赖性
  4. 使用量
  5. 基本示例
  6. 自定义
  7. API 参考
  8. 道具
  9. 动画
  10. 无障碍
  11. 捐款
  12. 许可证
  13. * 支持项目
  14. 谢谢

@futurejj/反应- native-检查框

用于本地反应的纸质复选框

npm version GitHub license Workflow Status Android iOS Web GitHub issues TS Expo Snack npm bundle size Sponsor

一个美丽的,可自定义的,和动画的复选框组件,用于React Industrial应用程序. 这个组件在iOS,Android,和Web平台之间工作,具有平滑动画和可访问性支持.

React Native Animated Checkbox Demo

特征

  • 关于状态变化的美丽动画
  • 完全自定义的颜色和样式
  • • 跨平台(iOS、Android、Web)
  • 3个州:检查、检查和不确定
  • * 内置无障碍支持
  • 适应各种设计需要的自定义大小
  • QQ 与 Expo 和标准 React 本地工作
  • QQ TypeScript 支持完整类型定义

安装

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(中文(简体) )

使用量

基本示例

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 (
    <View style={{ padding: 20 }}>
      <Checkbox
        status={checked ? 'checked' : 'unchecked'}
        onPress={toggleCheckbox}
      />
    </View>
  );
}

自定义

<Checkbox
  status="checked" // 'checked', 'unchecked', or 'indeterminate'
  disabled={false} // disable the checkbox
  onPress={() => {}} // 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'需求复选框当前状态
disabledbooleanfalse复选框是否被禁用
onPress(e: GestureResponderEvent) => void需求按下复选框时打回
colorstring'#2196F3'选中时复选框的颜色
uncheckedColorstring'#757575'未选中的复选框颜色
sizenumber24复选框图标的大小
testIDstring- 说吧测试框架的测试ID
styleStyleProp<ViewStyle>- 说吧容器的额外样式

动画

复选框包括平滑动画 :

  • 在状态间过渡时缩放动画
  • 自定义更多互动的边框动画

无障碍

这一组成部分是在无障碍的基础上建立的:

  • 适当的角色分配checkbox(中文(简体) )
  • 向屏幕阅读器报告的正确状态
  • 动态变化实时区域更新

捐款

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

许可证

麻省理工学院


* 支持项目

LiberPay_Donation_Button           Paypal_Donation_Button           Paypal_Donation_Button

谢谢

版本与发布记录

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

版本发布日期距今
1.0.10latest2026/10/2521 天前
1.0.92026/09/062 个月前
1.0.82026/08/182 个月前
1.0.72026/04/047 个月前
1.0.62026/02/089 个月前
1.0.52025/08/151.3 年前

关于 @futurejj/react-native-checkbox 的常见问题

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