代码拉取完成，页面将自动刷新
我的主页：http://www.yanzhenjie.com
欢迎关注我的微博：http://weibo.com/yanzhenjieit
QQ技术交流群：547839514
本库是基于RecyclerView的封装。
注意：本库在1.1.0版做了全新升级，没有最1.0.x版本做向下兼容，但是新版在API使用和功能方面都是个全新的升级。使用旧版本的同学升级时需要把ReadMe和Demo认真看一遍。
List/Grid/StaggeredGrid等LayoutManager的Item侧滑菜单。Item两侧侧滑菜单支持水平分布、垂直分布。Item拖拽排序、侧滑删除。HeaderView和FooterView。SwipeMenuLayout在任何地方都可以实现你自己的侧滑菜单。ViewPager、DrawerLayout等滑动布局嵌套使用。Sticky普通布局黏贴和ReyclerView分组黏贴。注意：使用本库只需要使用
SwipeMenuRecyclerView即可，可是使用任何第三方的Adapter，比如BaseRecyclerViewAdapterHelper。
对上面提到的效果都例举演示，但不是全部，更多效果可以下载Demo查看。
首先引入SwipeRecyclerView到你的项目中，然后就可以进行开发工作了。
compile 'com.yanzhenjie:recyclerview-swipe:1.1.3'
<dependency>
<groupId>com.yanzhenjie</groupId>
<artifactId>recyclerview-swipe</artifactId>
<version>1.1.3</version>
<type>pom</type>
</dependency>
在xml中引用SwipeRecyclerView：
<com.yanzhenjie.recyclerview.swipe.SwipeMenuRecyclerView
.../>
注意：
SwipeMenuAdapter了，只需要使用SwipeMenuRecyclerView即可。HeaderView，凡是通过ViewHolder拿到的position都要减掉HeaderView的数量才能得到正确的item position。也就是分割线，支持Grid形式和Linear形式，可以选择某个ViewType不画分割线：
// 默认构造，传入颜色即可。
new DefaultDecoration(color);
// 颜色，宽，高，最后一个参数是不画分割线的ViewType，可以传入多个。
new DefaultDecoration(color, width, height, excludeViewType);
// 例如下面的123都是不画分割线的ViewType：
new DefaultDecoration(color, width, height, 1, 2, 3);
recyclerView.setSwipeItemClickListener(new SwipeItemClickListener() {
@Override
public void onItemClick(View view, int position) {
// TODO，搞事情...
}
});
// 设置监听器。
swipeRecyclerView.setSwipeMenuCreator(mSwipeMenuCreator);
// 创建菜单：
SwipeMenuCreator mSwipeMenuCreator = new SwipeMenuCreator() {
@Override
public void onCreateMenu(SwipeMenu leftMenu, SwipeMenu rightMenu, int viewType) {
SwipeMenuItem deleteItem = new SwipeMenuItem(mContext)
...; // 各种文字和图标属性设置。
leftMenu.addMenuItem(deleteItem); // 在Item左侧添加一个菜单。
SwipeMenuItem deleteItem = new SwipeMenuItem(mContext)
...; // 各种文字和图标属性设置。
leftMenu.addMenuItem(deleteItem); // 在Item右侧添加一个菜单。
// 注意：哪边不想要菜单，那么不要添加即可。
}
};
// 菜单点击监听。
swipeRecyclerView.setSwipeMenuItemClickListener(mMenuItemClickListener);
SwipeMenuItemClickListener mMenuItemClickListener = new SwipeMenuItemClickListener() {
@Override
public void onItemClick(SwipeMenuBridge menuBridge) {
// 任何操作必须先关闭菜单，否则可能出现Item菜单打开状态错乱。
menuBridge.closeMenu();
int direction = menuBridge.getDirection(); // 左侧还是右侧菜单。
int adapterPosition = menuBridge.getAdapterPosition(); // RecyclerView的Item的position。
int menuPosition = menuBridge.getPosition(); // 菜单在RecyclerView的Item中的Position。
}
};
注意：菜单需要设置高度，关于菜单高度：
MATCH_PARENT，自动适应Item高度，保持和Item一样高，比较推荐;WRAP_CONTENT，自身高度，极不推荐;拖拽和侧滑删除的功能默认关闭的，所以先要打开功能：
recyclerView.setLongPressDragEnabled(true); // 拖拽排序，默认关闭。
recyclerView.setItemViewSwipeEnabled(true); // 策划删除，默认关闭。
只需要设置上面两个属性就可以进行相应的动作了，如果不需要哪个，不要打开就可以了。
然后监听拖拽和侧滑的动作，进行数据更新：
recyclerView.setOnItemMoveListener(mItemMoveListener);// 监听拖拽，更新UI。
OnItemMoveListener mItemMoveListener = new OnItemMoveListener() {
@Override
public boolean onItemMove(ViewHolder srcHolder, ViewHolder targetHolder) {
int fromPosition = srcHolder.getAdapterPosition();
int toPosition = targetHolder.getAdapterPosition();
// Item被拖拽时，交换数据，并更新adapter。
Collections.swap(mDataList, fromPosition, toPosition);
adapter.notifyItemMoved(fromPosition, toPosition);
return true;
}
@Override
public void onItemDismiss(ViewHolder srcHolder) {
int position = srcHolder.getAdapterPosition();
// Item被侧滑删除时，删除数据，并更新adapter。
mDataList.remove(position);
adapter.notifyItemRemoved(position);
}
};
特别注意：如果LayoutManager是List形式，那么Item拖拽时只能从1-2-3-4这样走，如果你的LayoutManager是Grid形式的，那么Item可以从1直接到3或者5或者6...，这样数据就会错乱，所以当LayoutManager是Grid形式时这里要特别注意转换数据位置的算法：
@Override
public boolean onItemMove(ViewHolder srcHolder, ViewHolder targetHolder) {
int fromPosition = srcHolder.getAdapterPosition();
int toPosition = targetHolder.getAdapterPosition();
if (fromPosition < toPosition)
for (int i = fromPosition; i < toPosition; i++)
Collections.swap(mDataList, i, i + 1);
else
for (int i = fromPosition; i > toPosition; i--)
Collections.swap(mDataList, i, i - 1);
mMenuAdapter.notifyItemMoved(fromPosition, toPosition);
return true;
}
我们还可以监听用户的侧滑删除和拖拽Item时的手指状态：
recyclerView.setOnItemStateChangedListener(mStateChangedListener);
...
private OnItemStateChangedListener mStateChangedListener = (viewHolder, actionState) -> {
if (actionState == OnItemStateChangedListener.ACTION_STATE_DRAG) {
// 状态：正在拖拽。
} else if (actionState == OnItemStateChangedListener.ACTION_STATE_SWIPE) {
// 状态：滑动删除。
} else if (actionState == OnItemStateChangedListener.ACTION_STATE_IDLE) {
// 状态：手指松开。
}
};
想用户触摸到某个Item时就开始拖拽或者侧滑删除时，只需要调用startDrag()和startSwipe()并转入当前Item的ViewHoler即可。
触摸拖拽：
swipeRecyclerView.startDrag(ViewHolder);
触摸侧滑删除：
swipeRecyclerView.startSwipe(ViewHolder);
主要方法：
addHeaderView(View); // 添加HeaderView。
removeHeaderView(View); // 移除HeaderView。
addFooterView(View); // 添加FooterView。
removeFooterView(View); // 移除FooterView。
getHeaderItemCount(); // 获取HeaderView个数。
getFooterItemCount(); // 获取FooterView个数。
getItemViewType(int); // 获取Item的ViewType，包括HeaderView、FooterView、普通ItemView。
添加/移除HeaderView/FooterView喝setAdapter()的调用不分先后顺序。
特别注意：
HeaderView，凡是通过ViewHolder拿到的position都要减掉HeaderView的数量才能得到正确的item position。本库默认提供了加载更多的动画和View，开发者也可以自定义；默认支持RecyclerView自带的三种布局管理器。
默认加载更多：
RecyclerView recyclerView = ...；
...
recyclerView.useDefaultLoadMore(); // 使用默认的加载更多的View。
recyclerView.setLoadMoreListener(mLoadMoreListener); // 加载更多的监听。
LoadMoreListener mLoadMoreListener = new LoadMoreListener() {
@Override
public void onLoadMore() {
// 该加载更多啦。
... // 请求数据，并更新数据源操作。
mMainAdapter.notifyDataSetChanged();
// 数据完更多数据，一定要调用这个方法。
// 第一个参数：表示此次数据是否为空。
// 第二个参数：表示是否还有更多数据。
mRecyclerView.loadMoreFinish(false, true);
// 如果加载失败调用下面的方法，传入errorCode和errorMessage。
// errorCode随便传，你自定义LoadMoreView时可以根据errorCode判断错误类型。
// errorMessage是会显示到loadMoreView上的，用户可以看到。
// mRecyclerView.loadMoreError(0, "请求网络失败");
}
};
自定义加载更多View也很简单，自定义一个View，并实现一个接口即可：
public class DefineLoadMoreView extends LinearLayout
implements SwipeMenuRecyclerView.LoadMoreView,
View.OnClickListener {
private LoadMoreListener mLoadMoreListener;
public DefineLoadMoreView(Context context) {
super(context);
...
setOnClickListener(this);
}
/**
* 马上开始回调加载更多了，这里应该显示进度条。
*/
@Override
public void onLoading() {
// 展示加载更多的动画和提示信息。
...
}
/**
* 加载更多完成了。
*
* @param dataEmpty 是否请求到空数据。
* @param hasMore 是否还有更多数据等待请求。
*/
@Override
public void onLoadFinish(boolean dataEmpty, boolean hasMore) {
// 根据参数，显示没有数据的提示、没有更多数据的提示。
// 如果都不存在，则都不用显示。
}
/**
* 加载出错啦，下面的错误码和错误信息二选一。
*
* @param errorCode 错误码。
* @param errorMessage 错误信息。
*/
@Override
public void onLoadError(int errorCode, String errorMessage) {
}
/**
* 调用了setAutoLoadMore(false)后，在需要加载更多的时候，此方法被调用，并传入listener。
*/
@Override
public void onWaitToLoadMore(SwipeMenuRecyclerView.LoadMoreListener loadMoreListener) {
this.mLoadMoreListener = loadMoreListener;
}
/**
* 非自动加载更多时mLoadMoreListener才不为空。
*/
@Override
public void onClick(View v) {
if (mLoadMoreListener != null) mLoadMoreListener.onLoadMore();
}
}
-keepclasseswithmembers class android.support.v7.widget.RecyclerView$ViewHolder {
public final View *;
}
其它类都是可以混淆的，如果添加了上述规则后还是存在问题，那么再追加：
-dontwarn com.yanzhenjie.recyclerview.swipe.**
-keep class com.yanzhenjie.recyclerview.swipe.** {*;}
加载更多的灵感来自cube-sdk，侧滑菜单参考了SwipeMenu，添加HeaderView参考了HeaderAndFooterWrapper类，特别感谢上述开源库及其作者。
Copyright 2017 Yan Zhenjie
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.
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。