Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jenly1314/imageviewer
:sunrise: ImageViewer是一个图片查看器（类似微信查看图片效果），一般用来查看图片详情或查看大图时使用，支持多张查看。简单易用。
https://github.com/jenly1314/imageviewer
android coil display-images glide image image-gallery image-preview imageview imageviewer load-image loader photo photo-gallery photoview picasso previewer viewer
Last synced: 8 days ago
JSON representation
:sunrise: ImageViewer是一个图片查看器（类似微信查看图片效果），一般用来查看图片详情或查看大图时使用，支持多张查看。简单易用。
- Host: GitHub
- URL: https://github.com/jenly1314/imageviewer
- Owner: jenly1314
- License: mit
- Created: 2019-11-07T08:55:33.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-12-06T01:44:01.000Z (about 2 months ago)
- Last Synced: 2025-01-17T03:07:56.006Z (15 days ago)
- Topics: android, coil, display-images, glide, image, image-gallery, image-preview, imageview, imageviewer, load-image, loader, photo, photo-gallery, photoview, picasso, previewer, viewer
- Language: Kotlin
- Homepage: https://jenly1314.github.io/ImageViewer/
- Size: 26.6 MB
- Stars: 60
- Watchers: 3
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ImageViewer
[](https://raw.githubusercontent.com/jenly1314/ImageViewer/master/app/release/app-release.apk)
[](https://repo1.maven.org/maven2/com/github/jenly1314/imageviewer)
[](https://jitpack.io/#jenly1314/ImageViewer)
[](https://circleci.com/gh/jenly1314/ImageViewer)
[](https://android-arsenal.com/api?level=21)
[](https://opensource.org/licenses/mit-license.php)
ImageViewer for Android 是一个图片查看器，一般用来查看图片详情或查看大图时使用。
## Gif 展示
> 你也可以直接下载 [演示App](https://raw.githubusercontent.com/jenly1314/ImageViewer/master/app/release/app-release.apk) 体验效果
## 引入
### Gradle:
1. 在Project的 **build.gradle** 或 **setting.gradle** 中添加远程仓库
```gradle
repositories {
//...
mavenCentral()
maven { url 'https://jitpack.io' }
}
```
2. 在Module的 **build.gradle** 里面添加引入依赖项
```gradle
implementation 'com.github.jenly1314:imageviewer:1.2.0'
```
## 使用
### 相关说明
* 使用 **ImageViewer** 时，必须配置一个实现的 **ImageLoader**。
* **ImageViewer** 一次可以查看多张图片或单张图片，支持的类型可以是 **Uri**、 **url** 、 **filePath** 、 **File**、 **DrawableRes**、 **ImageDataSource** 等。
* 目前内置默认实现 **ImageLoader** 的有 **CoilImageLoader** 、 **GlideImageLoader** 和 **PicassoImageLoader** ，三者选其一即可，如果以上都不满足您的需求，您也可以自己实现一个 **ImageLoader** 。
* 为了保证 **ImageViewer** 体积最小化，让用户有更多选择的可能性， **ImageViewer** 仅编译时用到了 **coil** 、**Glide** 和 **Picasso** 。
> 当你使用了 **CoilImageLoader** 时，则需依赖[ **COIL** ](https://github.com/coil-kt/coil)库 （v1.2.0新增）
> 当你使用了 **GlideImageLoader** 时，则需依赖[ **Glide** ](https://github.com/bumptech/glide)库
> 当你使用了 **PicassoImageLoader** 时，则需依赖[ **Picasso** ](https://github.com/square/picasso)库
### 代码示例
示例一：简单调用
```kotlin
ImageViewer.load(model)//要加载的图片数据，单张或多张
.imageLoader(GlideImageLoader())// 图片加载器，目前内置的有CoilImageLoader、GlideImageLoader和PicassoImageLoader，也可以自己实现
.start(activity,sharedElement)//activity or fragment, 跳转时的共享元素视图
```
示例二：根据需要修改一些配置
```kotlin
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新增）
```kotlin
ImageViewer.setGlobalDefaultImageLoader(imageLoader)
```
> 当设置了全局默认的图片加载器后，就可以在使用`ImageViewer`实例时，不用再单独调用`imageViewer.imageLoader(imageLoader)`去设置图片加载器了。
更多使用详情，请查看[app](app)中的源码使用示例或直接查看 [API帮助文档](https://jenly1314.github.io/ImageViewer/api/)
## 相关推荐
- [DrawBoard](https://dgithub.xyz/jenly1314/DrawBoard) 一个自定义View实现的画板；方便对图片进行编辑和各种涂鸦相关操作。
## 版本日志
#### v1.2.0：2024-12-6
* 代码全部改为使用`kotlin`
* 更新Gradle至v8.0
* 更新compileSdk至32
* 提升minSdk至21
* 新增`CoilImageLoader`
* 新增全局设置图片加载器函数 `ImageViewer.setGlobalDefaultImageLoader(imageLoader)`
#### [查看更多版本日志](CHANGELOG.md)
## 赞赏
如果您喜欢ImageViewer，或感觉ImageViewer帮助到了您，可以点右上角“Star”支持一下，您的支持就是我的动力，谢谢 :smiley:
您也可以扫描下面的二维码，请作者喝杯咖啡 :coffee:
## 关于我
| 我的博客 | GitHub | Gitee | CSDN | 博客园 |
|:------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------|
| Jenly's Blog | jenly1314 | jenly1314 | jenly121 | jenly |
## 联系我
| 微信公众号 | Gmail邮箱 | QQ邮箱 | QQ群 | QQ群 |
|:-------------|:---------------------------------------------------------------------------------|:----------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------|
| [Jenly666](http://weixin.qq.com/r/wzpWTuPEQL4-ract92-R) | jenly1314 | jenly1314 | 20867961 | 64020761 |
