Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

jenly1314/ImageViewer

Open more actions menu

Repository files navigation

ImageViewer

Image

MavenCentral JitPack CI Download API License

ImageViewer for Android 是一个图片查看器,一般用来查看图片详情或查看大图时使用。

效果展示

Image

你也可以直接下载 演示App 体验效果

引入

Gradle:

  1. 在Project的 build.gradlesetting.gradle 中添加远程仓库

    repositories {
        //...
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
  2. 在Module的 build.gradle 中添加依赖项

    implementation 'com.github.jenly1314:imageviewer:1.2.0'

使用

相关说明

  • 使用 ImageViewer 时,必须配置一个实现的 ImageLoader

  • ImageViewer 一次可以查看多张图片或单张图片,支持的类型可以是 UriurlfilePathFileDrawableResImageDataSource 等。

  • 目前内置默认实现 ImageLoader 的有 CoilImageLoaderGlideImageLoaderPicassoImageLoader ,三者选其一即可,如果以上都不满足您的需求,您也可以自己实现一个 ImageLoader

  • 为了保证 ImageViewer 体积最小化,让用户有更多选择的可能性, ImageViewer 仅编译时用到了 coilGlidePicasso

当你使用了 CoilImageLoader 时,则需依赖 COIL 库 (v1.2.0新增)

当你使用了 GlideImageLoader 时,则需依赖 Glide

当你使用了 PicassoImageLoader 时,则需依赖 Picasso

代码示例

示例一:简单调用

ImageViewer.load(model)//要加载的图片数据,单张或多张
    .imageLoader(GlideImageLoader())// 图片加载器,目前内置的有CoilImageLoader、GlideImageLoader和PicassoImageLoader,也可以自己实现
    .start(activity,sharedElement)//activity or fragment, 跳转时的共享元素视图

示例二:根据需要修改一些配置

ImageViewer.load(model)//要加载的图片数据,单张或多张
    .imageLoader(GlideImageLoader())// 图片加载器,目前内置的有CoilImageLoader、GlideImageLoader和PicassoImageLoader,也可以自己实现
    .selection(position)//当前选中位置,默认:0
    .showIndicator(true)//是否显示指示器,默认不显示
    .theme(R.style.ImageViewerTheme)//设置主题风格,默认:R.style.ImageViewerTheme
    .orientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT)//设置屏幕方向,默认:ActivityInfo.SCREEN_ORIENTATION_BEHIND
    .start(activity,sharedElement)//activity or fragment, 跳转时的共享元素视图

特别说明:全局设置默认的图片加载器(v1.2.0新增)

ImageViewer.setGlobalDefaultImageLoader(imageLoader)

当设置了全局默认的图片加载器后,就可以在使用ImageViewer实例时,不用再单独调用imageViewer.imageLoader(imageLoader)去设置图片加载器了。

更多使用详情,请查看app中的源码使用示例或直接查看 API帮助文档

相关推荐

  • DrawBoard 一个自定义View实现的画板;方便对图片进行编辑和各种涂鸦相关操作。
  • CircleProgressView 一个圆形的进度动画控件,动画效果纵享丝滑。
  • ArcSeekBar 一个弧形的拖动条进度控件,配置参数完全可定制化。
  • SpinCounterView 一个类似码表变化的旋转计数器动画控件。
  • CounterView 一个数字变化效果的计数器视图控件。
  • RadarView 一个雷达扫描动画后,然后展示得分效果的控件。
  • SuperTextView 一个在TextView的基础上扩展了几种动画效果的控件。
  • LoadingView 一个圆弧加载过渡动画,圆弧个数,大小,弧度,渐变颜色,完全可配。
  • WaveView 一个水波纹动画控件视图,支持波纹数,波纹振幅,波纹颜色,波纹速度,波纹方向等属性完全可配。
  • GiftSurfaceView 一个适用于直播间送礼物拼图案的动画控件。
  • FlutteringLayout 一个适用于直播间点赞桃心飘动效果的控件。
  • DragPolygonView 一个支持可拖动多边形,支持通过拖拽多边形的角改变其形状的任意多边形控件。
  • compose-component 一个Jetpack Compose的组件库;主要提供了一些小组件,便于快速使用。

版本日志

v1.2.0:2024-12-6

  • 代码全部改为使用kotlin
  • 更新Gradle至v8.0
  • 更新compileSdk至32
  • 提升minSdk至21
  • 新增CoilImageLoader
  • 新增全局设置图片加载器函数 ImageViewer.setGlobalDefaultImageLoader(imageLoader)

footer

About

🌅 ImageViewer是一个图片查看器(类似微信查看图片效果),一般用来查看图片详情或查看大图时使用,支持多张查看。简单易用。

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.