Gesture Recycler

This library provides swipe & drag and drop support for RecyclerView. Based on great example from Android-ItemTouchHelper-Demo.

Demo

Features

item click/long press/double tap listener
empty view
undo
swipe
long press drag
manual mode drag
support for different layout managers
predefined drag & swipe flags for RecyclerView's layout managers

Dependency

To use this library in your android project, just simply add the following dependency into your build.gradle

dependencies {
    compile 'com.thesurix.gesturerecycler:gesture-recycler:1.3.1'
}

How to use?

// Define your RecyclerView and adapter as usually
final LinearLayoutManager manager = new LinearLayoutManager(getContext());
recyclerView.setHasFixedSize(true);
recyclerView.setLayoutManager(manager);

// Extend GestureAdapter and write your own
// ViewHolder items must extend GestureViewHolder
final MonthsAdapter adapter = new MonthsAdapter(getContext(), R.layout.linear_item);
adapter.setData(getMonths());
recyclerView.setAdapter(adapter);

Swipe and drag & drop support:

GestureManager gestureManager = new GestureManager.Builder(mRecyclerView)
                 // Enable swipe
                .setSwipeEnabled(true)
                 // Enable long press drag and drop 
                .setLongPressDragEnabled(true)
                 // Enable manual drag from the beginning, you need to provide View inside your GestureViewHolder
                .setManualDragEnabled(true)
                 // Use custom gesture flags
                 // Do not use this method if you want predefined flags for RecyclerView layout manager 
                .setGestureFlags(ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT, ItemTouchHelper.UP | ItemTouchHelper.DOWN)
                .build();

Data callbacks:

adapter.setDataChangeListener(new GestureAdapter.OnDataChangeListener<MonthItem>() {
            @Override
            public void onItemRemoved(final MonthItem item, final int position) {
            }

            @Override
            public void onItemReorder(final MonthItem item, final int fromPos, final int toPos) {
            }
        });

Data animations:

// Support for data animations
adapter.add(month);
adapter.insert(month, 5);
adapter.remove(5);

// This will interrupt pending animations
adapter.setData(months)

Item click events:

// Attach DefaultItemClickListener or implement RecyclerItemTouchListener.ItemClickListener
recyclerView.addOnItemTouchListener(new RecyclerItemTouchListener(getActivity(), new DefaultItemClickListener() {
            @Override
            public boolean onItemClick(final View view, final int position) {
                // return true if the event is consumed
                return false;
            }

            @Override
            public void onItemLongPress(final View view, final int position) {
            }

            @Override
            public boolean onDoubleTap(final View view, final int position) {
                // return true if the event is consumed
                return false;
            }
        }));

Empty view:

<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.v7.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
    
    <!-- Define your empty view in layout -->
    <TextView
        android:id="@+id/empty_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:textAppearance="@android:style/TextAppearance.Large"
        android:text="No data"/>
</FrameLayout>

// Pass null to disable empty view
final View emptyView = view.findViewById(R.id.empty_view);
adapter.setEmptyView(emptyView);

Undo:

// Undo last data transaction (add, insert, remove, swipe, reorder)
adapter.undoLast();

// Set undo stack size
adapter.setUndoSize(2);

Old way (v1.0.0):

To enable swipe/drag and drop support:

final GestureTouchHelperCallback touchHelperCallback = new GestureTouchHelperCallback(adapter);
// Enable swipe
touchHelperCallback.setSwipeEnabled(true);
// Enable long press drag and drop 
touchHelperCallback.setLongPressDragEnabled(true);

// Sets predefined swipe & drag and drop flags based on layout manager type
touchHelperCallback.setGestureFlagsForLayout(manager);

//or use your own
touchHelperCallback.setDragFlags(ItemTouchHelper.UP | ItemTouchHelper.DOWN);
touchHelperCallback.setSwipeFlags(ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT);

final ItemTouchHelper touchHelper = new ItemTouchHelper(touchHelperCallback);
touchHelper.attachToRecyclerView(recyclerView);

To enable manual drag:

// Enable manual drag, you need to provide View inside your GestureViewHolder
touchHelperCallback.setManualDragEnabled(true);
// Attach default listener for drag triggering
adapter.setGestureListener(new GestureListener(touchHelper));

Help

See examples.

To do

background view for swipeable items
tests?

Licence

Copyright 2016 thesurix

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.

createS0ftware/experiment