@cicko/react-native-image-viewing

中文文档
0.2.12发布于 2025/04/04MITTypeScriptCommonJS零依赖近 30 天下载 3618

将图像作为滑动画廊查看的本地模式组件

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 道具
  4. 捐款
  5. 许可证

反应-内生-图像-查看

反应原生模式组件,用于将图像作为滑动画廊来查看.

npm version styled with prettier

  • iOS 和 Android 的缩放
  • iOS 和 Android 的双接相放大
  • 支持刷新到关闭动画
  • QQCustom 页眉和页脚组件
  • 虚拟化 列表以优化图像加载和渲染

试看博览会:https://expo.io/@antonkalinin/react-inative-image-viewing

安装

yarn add react-native-image-viewing

或者说

npm install --save react-native-image-viewing

使用量

import ImageView from "react-native-image-viewing";

const images = [
  {
    uri: "https://images.unsplash.com/photo-1571501679680-de32f1e7aad4",
  },
  {
    uri: "https://images.unsplash.com/photo-1573273787173-0eb81a833b34",
  },
  {
    uri: "https://images.unsplash.com/photo-1569569970363-df7b6160d111",
  },
];

const [visible, setIsVisible] = useState(false);

<ImageView
  images={images}
  imageIndex={0}
  visible={visible}
  onRequestClose={() => setIsVisible(false)}
/>

见示例

道具

专利名称说明类型需求
images要显示的图像阵列图像来源 []真实
keyExtractor任意识别每个图像(图像Src:图像来源,索引:数字)QQ字符串虚假
imageIndex当前要显示的图像索引编号真实
visible是否显示模式布尔真实
onRequestClose关闭模式的函数函数真实
onImageIndexChange当图像索引被更改时调用的函数函数虚假
onLongPress图像按久时调用函数函数( 事件: GestureResponderEvent, 图像: 图像来源)虚假
delayLongPress延迟 ms, 在 LongPress 上出现前叫做: 默认 800编号虚假
animationType显示的动画模式: 默认 fadenone, (中文(简体) ), fade, (中文(简体) ), slide虚假
presentationStyle模块演示文稿样式: 默认 : fullScreen 机器人: 使用 overFullScreen 隐藏状态栏fullScreen, (中文(简体) ), pageSheet, (中文(简体) ), formSheet, (中文(简体) ), overFullScreen虚假
backgroundColorHEX 模式的背景颜色 (# 000000EE)字符串虚假
swipeToCloseEnabled关闭上下刷新模式: 默认 true布尔虚假
doubleTapToZoomEnabled用双拍放大图像: 默认 true布尔虚假
HeaderComponent页眉组件, 获取当前 imageIndex 作为道具组件, 函数虚假
FooterComponent页脚组件, 获取当前 imageIndex 作为道具组件, 函数虚假
  • 类型 图像来源 = 图像 URI 来源 = 图像需求来源

捐款

要开始复制这个 repo 然后在内部运行 react-native-image-viewing 文件夹 :

yarn

那就进去吧 example 文件夹并运行 :

yarn & yarn start

这将启动 expo 的包装器, 以便您更改 /src/ImageViewing 并查看 expo 示例应用程序的更改.

许可证

麻省理工学院

版本与发布记录

@cicko/react-native-image-viewing 共发布 11 个版本,首次发布于 2025/03/31;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.2.12latest2025/04/041.6 年前
0.2.112025/04/041.6 年前
0.2.102025/04/041.6 年前
0.2.92025/04/041.6 年前
0.2.82025/04/041.6 年前
0.2.72025/04/041.6 年前

关于 @cicko/react-native-image-viewing 的常见问题

@cicko/react-native-image-viewing 是什么?

将图像作为滑动画廊查看的本地模式组件

如何安装 @cicko/react-native-image-viewing?

在项目目录运行 npm install @cicko/react-native-image-viewing,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@babel/runtime(7.7.4)、@types/react(^18.3.20)、react(>=18.3.1)、react-native(>=0.74.5)、typescript(^5.6.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cicko/react-native-image-viewing 支持 TypeScript 吗?

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

@cicko/react-native-image-viewing 支持 ESM 还是 CommonJS?

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

@cicko/react-native-image-viewing 可以商用吗?

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

@cicko/react-native-image-viewing 的下载量有多少?

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

@cicko/react-native-image-viewing 还在维护吗?

最新版本 0.2.12 发布于 2025/04/04(1.6 年前);至今共发布 11 个版本,其中过去 12 个月发布了 0 个;首次发布于 2025/03/31。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。