搜索插件、代码仓与 APP 分类

插件详情v0.6.0

interactiveviewer_gallery

支持缩放和拖动的图像和视频预览组件

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
1300
喜欢数
68
Pub 分数
135

安装插件

flutter pub add interactiveviewer_gallery

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个 Flutter 包,提供用于图像和视频的交互式查看器,支持流畅的缩放和拖动手势。专为在多个平台上预览高分辨率媒体而设计,具有直观的触摸控制。该组件在同一交互界面中支持静态图像和视频播放,非常适合画廊、产品展示或详细视觉内容探索。注重性能和响应性,可无缝集成到现有的 Flutter 应用中。

适合场景

  • 画廊中的图像缩放和平移
  • 交互式视频预览
  • 产品详情页
  • 高分辨率图像浏览
  • 数字艺术或文档查看

主要特点

  • 缩放和拖动手势
  • 支持图片和视频
  • 跨平台兼容性
  • 流畅的动画过渡
  • 内置手势处理

适合对象

  • 媒体丰富的应用程序
  • 电子商务产品展示
  • 教育或技术文档
  • 艺术与设计作品集
  • 互动式学习工具

使用建议

  • 可能需要对非常大的文件进行优化
  • 性能取决于设备功能
  • 手势行为的自定义有限
  • 不适用于全屏视频播放
  • 需要适当的资源加载策略

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

interactiveviewer_gallery

pub package

中文文档

A flutter library to show picture and video preview gallery support

  1. two-finger gesture zoom
  2. double-click to zoom
  3. switch left and right
  4. gesture back: scale, transfer, opacity of background
  5. video auto paused when miss focus

Preview

video for youtube

video for qiniu

apk download

Setup

because the library is base on InteractiveViewer so require flutter verion above or equal 1.20.0

interactiveviewer_gallery: ${last_version}

How to use

  1. Wrap Hero in your image gridview item:
Hero(
    tag: source.url,
    child: ${gridview item}
)
  1. gridview item's GestureDetector add jumping to interactiveviewer_gallery:
// DemoSourceEntity is your data model
// itemBuilder is gallery page item
void _openGallery(DemoSourceEntity source) {
  Navigator.of(context).push(
    HeroDialogRoute<void>(
      // DisplayGesture is just debug, please remove it when use
      builder: (BuildContext context) => InteractiveviewerGallery<DemoSourceEntity>(
          sources: sourceList,
          initIndex: sourceList.indexOf(source),
          itemBuilder: itemBuilder,
          onPageChanged: (int pageIndex) {
            print("nell-pageIndex:$pageIndex");
          },
      ),
    ),
  );
}
  1. edit itemBuilder: you can reference the example/lib/main.dart then customize
Widget itemBuilder(BuildContext context, int index, bool isFocus) {
  DemoSourceEntity sourceEntity = sourceList[index];
  if (sourceEntity.type == 'video') {
    return DemoVideoItem(
      sourceEntity,
      isFocus: isFocus,
    );
  } else {
    return DemoImageItem(sourceEntity);
  }
}

Other

Comments and pr are welcome

所属分类

源码仓库

使用此插件的项目

暂无相关数据。