zhang-yuehuan / swiperecyclerview

RecyclerView侧滑菜单，长按拖拽，滑动删除，自动加载更多，和ViewPager结合使用，和任何下拉刷新框架结合使用。

SwipeRecyclerView

严振杰的主页：http://www.yanzhenjie.com
严振杰的博客：http://blog.yanzhenjie.com
技术交流群：547839514，加群前请务必阅读群行为规范。

---

演示Demo apk下载

1. 需要说明的是，本库没有对RecyclerView做大的修改，只是ItemView的封装。看起来是对RecyclerView的修改，其实仅仅是为RecyclerView添加了使用的方法API而已。

2. 本库已经更新了三个版本了，会一直维护下去，根据小伙伴的要求，以后也会添加一些其它功能。

SwipeRecyclerView将完美解决这些问题：

1. 以下功能全部支持：竖向ListView、横向ListView、Grid、StaggeredGrid四种形式。

2. RecyclerView 左右两侧 侧滑菜单。
3. 菜单横向排布、菜单竖向排布。
4. RecyclerView长按拖拽Item。
5. RecyclerView侧滑删除item。
6. 指定RecyclerView的某一个Item不能滑动删除或长按拖拽。
7. 某一个Item显示的不同的菜单（类似QQ）。
8. 用SwipeMenuLayout在任何地方都可以实现你自己的侧滑菜单。
9. 使用SwipeRecyclerView下拉刷新、自动加载更多。
10. 可以和ViewPager嵌套使用（兼容滑动冲突）。

引用方法

• Eclipse 请自行下载源码。
• AndroidStudio使用Gradle构建添加依赖（推荐）

compile 'com.yanzhenjie:recyclerview-swipe:1.0.2'

Or Maven:

<dependency>
  <groupId>com.yanzhenjie</groupId>
  <artifactId>recyclerview-swipe</artifactId>
  <version>1.0.2</version>
  <type>pom</type>
</dependency>

我在开发SwipeRecyclerView时引用的RecyclerView版本如下：

compile 'com.android.support:recyclerview-v7:23.4.0'

效果图

gif有一些失真，且网页加载速度慢，可以下载demo的apk看效果。

侧滑菜单

1. 左右两侧都有菜单，主动调出第几个菜单或者手指滑动出现。
2. 根据ViewType某一个Item显示的不同的菜单（类似QQ）
   

和ViewPager嵌套 下拉刷新、自动加载更多

1. 和ViewPager嵌套使用，兼容了滑动冲突。
2. 可以和任何下拉刷新的框架结合，滑动到底部自动加载更多。
   

长按拖拽 侧滑菜单结合使用

1. 一直按住Item进行拖拽排序，支持List、Grid形式。
2. 长按拖拽并且和侧滑菜单结合使用。
   

直接滑动删除 长按拖拽Item排序

1. 侧滑直接删除，也可以长按拖拽排序。
2. 可以指定某个Item不能被侧滑删除、不能被长按拖拽。
   

直接滑动删除 长按拖拽Item排序

1. 给菜单设置排列方向，支持横向、竖向。
2. 开发者用库中的SwipeMenuLayout开发自己的侧滑菜单。
   

使用介绍

这里列出关键实现，具体请参考demo，或者加最上面的交流群一起讨论。 更多教程请进入我的博客查看。

启用SwipeReyclerView的长按Item拖拽功能和侧滑删除功能

recyclerView.setLongPressDragEnabled(true);// 开启长按拖拽
recyclerView.setItemViewSwipeEnabled(true);// 开启滑动删除。
recyclerView.setOnItemMoveListener(onItemMoveListener);// 监听拖拽和侧滑删除，更新UI和数据。

添加Item侧滑菜单

侧滑菜单支持自动打开某个Item的菜单，并可以指定是左边还是右边的：

// 打开第一个Item的左侧菜单。
recyclerView.openLeftMenu(0);

// 打开第一个Item的右侧菜单。
recyclerView.openRightMenu(0);

• 第一步，引用自定义View：SwipeMenuReyclerView：

<com.yanzhenjie.recyclerview.swipe.SwipeMenuRecyclerView
    android:id="@+id/recycler_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:layout_behavior="@string/appbar_scrolling_view_behavior" />

• 第二步，设置菜单创建器、菜单点击监听：

SwipeMenuRecyclerView swipeMenuRecyclerView = findViewById(R.id.recycler_view);
// 设置菜单创建器。
swipeMenuRecyclerView.setSwipeMenuCreator(swipeMenuCreator);
// 设置菜单Item点击监听。
swipeMenuRecyclerView.setSwipeMenuItemClickListener(menuItemClickListener);

• 第三步，菜单创建器创建菜单：

/**
 * 菜单创建器。在Item要创建菜单的时候调用。
 */
private SwipeMenuCreator swipeMenuCreator = new SwipeMenuCreator() {
    @Override
    public void onCreateMenu(SwipeMenu swipeLeftMenu, SwipeMenu swipeRightMenu, int viewType) {

        SwipeMenuItem addItem = new SwipeMenuItem(mContext)
            .setBackgroundDrawable(R.drawable.selector_green)// 点击的背景。
            .setImage(R.mipmap.ic_action_add) // 图标。
            .setWidth(size) // 宽度。
            .setHeight(size); // 高度。
        swipeLeftMenu.addMenuItem(addItem); // 添加一个按钮到左侧菜单。

        SwipeMenuItem deleteItem = new SwipeMenuItem(mContext)
            .setBackgroundDrawable(R.drawable.selector_red)
            .setImage(R.mipmap.ic_action_delete) // 图标。
            .setText("删除") // 文字。
            .setTextColor(Color.WHITE) // 文字颜色。
            .setTextSize(16) // 文字大小。
            .setWidth(size)
            .setHeight(size);
        swipeRightMenu.addMenuItem(deleteItem);// 添加一个按钮到右侧侧菜单。.
        
        // 上面的菜单哪边不要菜单就不要添加。
    }
};

更多使用方法请参考Demo，或者加最上方的QQ群来交流。

• 第四步，继承SwipeMenuAdapter，和正常的Adapter一样使用：

public class MenuAdapter extends SwipeMenuAdapter<MenuAdapter.DefaultViewHolder> {

    @Override
    public int getItemCount() {
        return 0;
    }

    @Override
    public View onCreateContentView(ViewGroup parent, int viewType) {
        return null;
    }

    @Override
    public ViewHolder onCompatCreateViewHolder(View realContentView, int viewType) {
        return null;
    }

    @Override
    public void onBindViewHolder(MenuAdapter.DefaultViewHolder holder, int position) {
    }
}

Thanks

SwiepRecyclerView的侧滑功能绝大部分代码参考了SwipeMenu，并改了部分代码，修复了几个bug：
SwipeMenu

SwiepRecyclerView的菜单创建监器参考了SwipeMenuListView，如果是想ListView使用侧滑菜单功能，请使用SwipeMenuListView：
SwipeMenuListView

#License

Copyright 2016 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.