版权声明：本文为博主原创文章，未经博主允许不得转载。 https://blog.csdn.net/liyi1009365545/article/details/78135394
ImageViewer
关于
图片预览器，支持图片手势缩放、拖拽等操作，自定义View的模式显示，自定义图片加载方式，更加灵活，易于扩展，同时也适用于RecyclerView、ListView的横向和纵向列表模式，最低支持版本为Android 3.0及以上…
功能
- 图片的基本缩放、滑动
- 微信朋友圈图片放大预览
- 微信朋友圈图片拖拽效果
- 今日头条图片拖拽效果
- 图片加载进度条
传送门
推荐
- AutoGridView 宫格控件，QQ空间九宫格、普通宫格模式、点击添加照片…
项目演示
点我看完整版演示
apk体验
点我
自定义属性
| 属性名 | 描述 |
|---|---|
| ivr_show_index | 是否显示图片位置 |
| ivr_do_enter | 是否开启进场动画 |
| ivr_do_exit | 是否开启退场动画 |
| ivr_duration | 进场与退场动画的执行时间 |
| ivr_do_drag | 是否允许图片拖拽 |
| ivr_drag_type | 拖拽模式（classic：今日头条效果 |
自定义方法
| 方法名 | 描述 |
|---|---|
| setStartPosition(int position) | 设置开始展示的图片的位置 |
| setImageData(List list) | 设置图片资源 |
| setViewData(List list) | 设置目标 view 的相关数据 |
| setImageLoader(ImageLoader loader) | 设置图片加载类 |
| showIndex(boolean show) | 是否显示图片索引 |
| doDrag(boolean isDo) | 是否允许图片被拖拽 |
| setDragType(@ImageDraggerType int type) | 设置拖拽模式 |
| doEnterAnim(boolean isDo) | 是否开启进场动画 |
| doExitAnim(boolean isDo) | 是否开启退场动画 |
| setDuration(int duration) | 设置打开和关闭的动画执行时间 |
| setOnImageChangedListener(OnImageChangedListener listener) | 设置图片切换监听 |
| setOnItemClickListener(OnItemClickListener listener) | 设置图片的单击击监听 |
| setOnItemLongClickListener(OnItemLongClickListener listener) | 设置图片的长按击监听 |
| setOnPreviewStatusListener(OnPreviewStatusListener listener) | 设置图片预览状态监听 |
| watch() | 开启图片预览 |
| close() | 关闭图片预览 |
| clear() | 清除所有数据 |
| getViewState() | 获取图片预览器的当前状态 |
| setImageScaleable(boolean scaleable) | 是否允许图片缩放 |
| isImageScaleable() | 图片是否可缩放 |
| getImageScale() | 获取图片当前的缩放等级 |
| setImageMaxScale | 设置图片的最大缩放等级 |
| getImageMaxScale() | 获取图片的最大缩放等级 |
| setImageMinScale(float minScale) | 设置图片的最小缩放等级 |
| getImageMinScale() | 获取图片的最小缩放等级 |
| getCurrentView() | 获取当前 Item 的视图 |
| getCurrentPosition() | 获取当前图片的位置 |
| onKeyDown(int keyCode, KeyEvent event) | 返回键监听（使用方法见demo） |
添加依赖
- Gradle
Step 1:
allprojects {
repositories {
...
// 此句maven是为因为项目中使用了jitpack上的开源项目PhotoView
maven { url 'https://jitpack.io' }
// 如果添加依赖时，报找不到项目时（项目正在审核），可以添加此句maven地址，如果找到项目，可不必添加
maven { url "https://dl.bintray.com/albertlii/android-maven/" }
}
}
Step 2:
dependencies {
compile 'com.liyi.view:image-viewer:2.1.2'
}- Maven
<dependency>
<groupId>com.liyi.view</groupId>
<artifactId>image-viewer</artifactId>
<version>2.1.2</version>
<type>pom</type>
</dependency>简单实例
XML 中添加 ImageViewer
<com.liyi.viewer.widget.ImageViewer
android:id="@+id/imagePreivew"
android:layout_width="match_parent"
android:layout_height="match_parent" />代码中设置 ImageViewer
// 图片浏览的起始位置
imageViewer.setStartPosition(position);
// 图片的数据源
imageViewer.setImageData(mImageList);
// 目标 View 的位置以及尺寸等信息
imageViewer.setViewData(mViewDatas);
// 自定义图片的加载方式
imageViewer.setImageLoader(new ImageLoader() {
@Override
public void displayImage(final int position, Object src, final ImageView view) {
Glide.with(SimplePreviewActivity.this)
.load(src)
.into(new SimpleTarget<Drawable>() {
@Override
public void onLoadStarted(@Nullable Drawable placeholder) {
super.onLoadStarted(placeholder);
view.setImageDrawable(placeholder);
}
@Override
public void onLoadFailed(@Nullable Drawable errorDrawable) {
super.onLoadFailed(errorDrawable);
view.setImageDrawable(errorDrawable);
}
@Override
public void onResourceReady(Drawable resource, Transition<? super Drawable> transition) {
view.setImageDrawable(resource);
mViewDatas.get(position).setImageWidth(resource.getIntrinsicWidth());
mViewDatas.get(position).setImageHeight(resource.getIntrinsicHeight());
}
});
}});
// 开启图片浏览
imageViewer.watch();超巨图解决方案（进退场动画需重写，且不支持微信朋友圈拖拽，今日头条效果仍然支持）
- 使用 SubsamplingScaleImageView 代替 PhotoView（推荐）
- 或者使用 BigImageView 代替 ScaleImageView
github传送门
https://github.com/albert-lii/ImageViewer