图片预览器，支持图片手势缩放、拖拽等操作，自定义View的模式显示，自定义图片加载方式，更加灵活，易于扩展，同时也适用于RecyclerView、ListView的横向和纵向列表模式，最低支持版本为Android 3.0及以上...
- 图片的基本缩放、滑动
- 微信朋友圈图片放大预览
- 微信朋友圈图片拖拽效果
- 今日头条图片拖拽效果
- 图片加载进度条
- AutoGridView 宫格控件，QQ空间九宫格、普通宫格模式、点击添加照片...
| 属性名 | 描述 |
|---|---|
| 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> <com.liyi.viewer.widget.ImageViewer
android:id="@+id/imagePreivew"
android:layout_width="match_parent"
android:layout_height="match_parent" />
// 图片浏览的起始位置
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
如果你感觉 ImageViewer 帮助到了你，可以点右上角 "Star" 支持一下哦！:blush:
Copyright 2017 liyi
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.