# ImageViewer
**Repository Path**: cbefore/ImageViewer
## Basic Information
- **Project Name**: ImageViewer
- **Description**: :sunrise: ImageViewer是一个图片查看器（类似微信查看图片效果），一般用来查看图片详情或查看大图时使用，支持多张查看。简单易用。
- **Primary Language**: Android
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 7
- **Created**: 2024-06-03
- **Last Updated**: 2024-06-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ImageViewer
[](https://raw.githubusercontent.com/jenly1314/ImageViewer/master/app/release/app-release.apk)
[](https://repo1.maven.org/maven2/com/github/jenly1314/imageviewer)
[](https://bintray.com/beta/#/jenly/maven/imageviewer)
[](https://jitpack.io/#jenly1314/ImageViewer)
[](https://travis-ci.org/jenly1314/ImageViewer)
[](https://circleci.com/gh/jenly1314/ImageViewer)
[](https://android-arsenal.com/api?level=16)
[](https://opensource.org/licenses/mit-license.php)
[](https://jenly1314.github.io/)
[](http://shang.qq.com/wpa/qunwpa?idkey=8fcc6a2f88552ea44b1411582c94fd124f7bb3ec227e2a400dbbfaad3dc2f5ad)
ImageViewer for Android 是一个图片查看器，一般用来查看图片详情或查看大图时使用。
## Gif 展示
## 引入
### 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.1.0'
```
## 示例
### 代码示例
```Java
//图片查看器 - 简单调用
// data 可以多张图片List或单张图片，支持的类型可以是{@link Uri}, {@code url}, {@code path},{@link File}, {@link DrawableRes resId}…等
ImageViewer.load(data)//要加载的图片数据，单张或多张
.imageLoader(new GlideImageLoader())//加载器，imageLoader必须配置，目前内置的有GlideImageLoader或PicassoImageLoader，也可以自己实现
.start(activity,sharedElement);//activity or fragment, 跳转时的共享元素视图
```
```Java
//图片查看器
// data 可以多张图片List或单张图片，支持的类型可以是{@link Uri}, {@code url}, {@code path},{@link File}, {@link DrawableRes resId}…等
ImageViewer.load(data)//要加载的图片数据，单张或多张
.selection(position)//当前选中位置，默认：0
.indicator(true)//是否显示指示器，默认不显示
.imageLoader(new GlideImageLoader())//加载器，imageLoader必须配置，目前内置的有GlideImageLoader或PicassoImageLoader，也可以自己实现
.theme(R.style.ImageViewerTheme)//设置主题风格，默认：R.style.ImageViewerTheme
.orientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT)//设置屏幕方向,默认：ActivityInfo.SCREEN_ORIENTATION_BEHIND
.start(activity,sharedElement);//activity or fragment, 跳转时的共享元素视图
```
### 相关说明
* 使用 **ImageViewer** 时，必须配置一个实现的 **ImageLoader**。
* **ImageViewer** 一次可以查看多张图片或单张图片，支持的类型可以是 **Uri**、 **url** 、 **path** 、 **File**、 **DrawableRes**、 **ImageDataSource** 等。
* 目前内置默认实现 **ImageLoader** 的有 **GlideImageLoader** 和 **PicassoImageLoader** ，二者选其一即可，如果二者不满足您的需求，您也可以自己实现一个 **ImageLoader**。
* 为了保证 **ImageViewer** 体积最小化，让用户有更多选择的可能性， **ImageViewer** 仅编译时用到了 **Glide** 和 **Picasso** 。
> 当你使用了 **GlideImageLoader** 时，则需依赖[ **Glide** ](https://github.com/bumptech/glide)库。
> 当你使用了 **PicassoImageLoader** 时，则需依赖[ **Picasso** ](https://github.com/square/picasso)库。
更多使用详情，请查看[app](app)中的源码使用示例
## 版本记录
#### v1.1.0：2023-9-16
* 更新Gradle至v7.3.3
* 更新compileSdk至30
* 优化细节
#### v1.0.4：2022-9-11
* 优化细节
#### v1.0.3：2022-9-10 (从v1.0.3开始发布至 MavenCentral)
* 看大图界面支持自定义扩展
#### v1.0.2：2020-12-3
* 加载的图片数据新增支持ImageDataSource类型，便于扩展
#### v1.0.1：2019-11-15
* 简化集成步骤
#### v1.0.0：2019-11-7
* ImageViewer初始版本
## 赞赏
如果您喜欢ImageViewer，或感觉ImageViewer帮助到了您，可以点右上角“Star”支持一下，您的支持就是我的动力，谢谢 :
smiley:
您也可以扫描下面的二维码，请作者喝杯咖啡 :coffee:
## 关于我
Name: Jenly
Email: jenly1314#gmail.com / jenly1314#vip.qq.com
CSDN: jenly121
CNBlogs: jenly
GitHub: jenly1314
Gitee: jenly1314
加入QQ群: 20867961
