146 lines
4.8 KiB
Markdown
146 lines
4.8 KiB
Markdown
# MultiImageSelector
|
||
仿微信实现多图选择。支持单选和多选两种模式
|
||
|
||
[English Doc](README.md)
|
||
|
||
###截图
|
||
   
|
||
|
||
-------------------
|
||
|
||
###运行DEMO
|
||
|
||
>./gradlew installDebug
|
||
|
||
###快速开始
|
||
* 第0步
|
||
把模块 `multi-image-selector` 作为你的项目依赖添加到工程中.
|
||
|
||
* 第1步
|
||
在你的 `AndroidManifest.xml` 文件中添加权限 `android.permission.READ_EXTERNAL_STORAGE`.
|
||
别忘了同时在 `AndroidManifest.xml` 中声明 `MultiImageSelectorActivity` 这个Activity.
|
||
```xml
|
||
<activity
|
||
android:configChanges="orientation|screenSize"
|
||
android:name="me.nereo.multi_image_selector.MultiImageSelectorActivity" />
|
||
```
|
||
|
||
* 第2步
|
||
代码中调用，例如:
|
||
```java
|
||
Intent intent = new Intent(mContext, MultiImageSelectorActivity.class);
|
||
|
||
// 是否显示调用相机拍照
|
||
intent.putExtra(MultiImageSelectorActivity.EXTRA_SHOW_CAMERA, true);
|
||
|
||
// 最大图片选择数量
|
||
intent.putExtra(MultiImageSelectorActivity.EXTRA_SELECT_COUNT, 9);
|
||
|
||
// 设置模式 (支持 单选/MultiImageSelectorActivity.MODE_SINGLE 或者 多选/MultiImageSelectorActivity.MODE_MULTI)
|
||
intent.putExtra(MultiImageSelectorActivity.EXTRA_SELECT_MODE, MultiImageSelectorActivity.MODE_MULTI);
|
||
|
||
startActivityForResult(intent, REQUEST_IMAGE);
|
||
```
|
||
|
||
* 第3步
|
||
在你的 `onActivityResult` 方法中接受结果. 例如:
|
||
```java
|
||
@Override
|
||
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
|
||
super.onActivityResult(requestCode, resultCode, data);
|
||
if(requestCode == REQUEST_IMAGE){
|
||
if(resultCode == RESULT_OK){
|
||
// 获取返回的图片列表
|
||
List<String> path = data.getStringArrayListExtra(MultiImageSelectorActivity.EXTRA_RESULT);
|
||
// 处理你自己的逻辑 ....
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
* 第4步
|
||
没第4步了，就这样就OK啦~ :)
|
||
|
||
-------------------
|
||
|
||
###自定义显示
|
||
* 自定义Activity
|
||
```java
|
||
class CustomerActivity extends Activity implements MultiImageSelectorFragment.Callback{
|
||
@Override
|
||
protected void onCreate(Bundle savedInstanceState) {
|
||
// 你自己的逻辑...
|
||
Bundle bundle = new Bundle();
|
||
bundle.putInt(MultiImageSelectorFragment.EXTRA_SELECT_COUNT, mDefaultCount);
|
||
bundle.putInt(MultiImageSelectorFragment.EXTRA_SELECT_MODE, mode);
|
||
<bundle class="putBo"></bundle>olean(MultiImageSelectorFragment.EXTRA_SHOW_CAMERA, isShow);
|
||
// 添加主Fragment到Activity
|
||
getSupportFragmentManager().beginTransaction()
|
||
.add(R.id.image_grid, Fragment.instantiate(this, MultiImageSelectorFragment.class.getName(), bundle))
|
||
.commit();
|
||
}
|
||
@Override
|
||
public void onSingleImageSelected(String path) {
|
||
// 当选择模式设定为 单选/MODE_SINGLE, 这个方法就会接受到Fragment返回的数据
|
||
}
|
||
|
||
@Override
|
||
public void onImageSelected(String path) {
|
||
// 一个图片被选择是触发，这里可以自定义的自己的Actionbar行为
|
||
}
|
||
|
||
@Override
|
||
public void onImageUnselected(String path) {
|
||
// 一个图片被反选是触发，这里可以自定义的自己的Actionbar行为
|
||
}
|
||
|
||
@Override
|
||
public void onCameraShot(File imageFile) {
|
||
// 当设置了使用摄像头，用户拍照后会返回照片文件
|
||
}
|
||
}
|
||
```
|
||
* 具体可以参考`MultiImageSelectorActivity.java`的实现
|
||
|
||
-------------------
|
||
|
||
###更新日志
|
||
|
||
* 2015-5-5
|
||
1. 修复. 某些图片无法显示. (Issue by[sd6352051](https://github.com/sd6352051), [larry](https://github.com/18611480882))
|
||
2. 修复. `ListPopupWindow` 无法填充父控件
|
||
3. 新增. 选中的遮罩效果.
|
||
|
||
* 2015-4-16
|
||
1. 修复. 旋转设备时，程序会崩溃. (Issue by [@Leminity](https://github.com/Leminity))
|
||
2. 修复. 文件夹PopupListView位置错误. (Issue by [@Slock](https://github.com/Slock))
|
||
3. 更改. 演示程序截图.
|
||
4. 更改. Readme 文件.
|
||
|
||
* 2015-4-9
|
||
1. 修复. 当设置 `EXTRA_SHOW_CAMERA` 为 `true` 时, 点击第一个Item会混乱的问题.
|
||
2. 新增. 支持初始化图片选择设定。
|
||
|
||
|
||
-------------------
|
||
|
||
###感谢
|
||
|
||
* [square-picasso](https://github.com/square/picasso) A powerful image downloading and caching library for Android
|
||
|
||
-------------------
|
||
|
||
###License
|
||
>The MIT License (MIT)
|
||
|
||
>Copyright (c) 2015 Nereo
|
||
|
||
>Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
of this software and associated documentation files (the "Software"), to deal
|
||
in the Software without restriction, including without limitation the rights
|
||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
copies of the Software, and to permit persons to whom the Software is
|
||
furnished to do so, subject to the following conditions:
|
||
|
||
>The above copyright notice and this permission notice shall be included in all
|
||
copies or substantial portions of the Software. |