Advanced RecyclerView

This RecyclerView extension library provides Google's Inbox app like swiping, Play Music app like drag-and-drop sorting and expandable item features. Works on API level 9 or later.

Download the example app

Demonstration video on YouTube

Target platforms

API level 9 or later (However, some animations are not supported on Gingerbread.)

Latest version

Version 0.9.3 (July 31, 2016) (RELEASE NOTES)

Getting started

This library is published on jCenter. Just add these lines to build.gradle.

dependencies {
    compile ('com.h6ah4i.android.widget.advrecyclerview:advrecyclerview:0.9.3@aar'){
        transitive=true
    }
}

Usage

Please check the implementation of the simple examples.

Drag & Drop related examples

Expandable item related examples

Swipeable related examples

Hybrid examples

Primary classes/interfaces

Drag & Drop related classes/interfaces

Class/Interface name	Description
`RecyclerViewDragDropManager`	Provides Drag & Drop sort operation
`DraggableItemAdapter<T>`	Implement this interface on your RecyclerView.Adapter
`DraggableItemViewHolder`	Implement this interface on your RecyclerView.ViewHolder
`DraggableItemConstants`	Constant values area decleared in this interface

Swiping related classes/interfaces

Class/Interface name	Description
`RecyclerViewSwipeManager`	Provides Swipe operation
`SwipeableItemAdapter<T>`	Implement this interface on your RecyclerView.Adapter
`SwipeableItemViewHolder`	Implement this interface on your RecyclerView.ViewHolder
`SwipeableItemConstants`	Constant values area decleared in this interface

Expandable item related classes/interfaces

Class/Interface name	Description
`RecyclerViewExpandableItemManager`	Provides Expandable item function
`ExpandableItemViewHolder`	Implement this interface on your RecyclerView.ViewHolder
`ExpandableItemAdapter<GVH, CVH>`	Implement this interface on your RecyclerView.Adapter
`ExpandableDraggableItemAdapter<GVH, CVH>`	(optional) Implement this interface on your RecyclerView.Adapter to support Drag & Drop sort operation
`ExpandableSwipeableItemAdapter<GVH, CVH>`	(optional) Implement this interface on your RecyclerView.Adapter to support Swipe operation
`ExpandableItemConstants`	Constant values area decleared in this interface

RecyclerView decorations

Class/Interface name	Description
`ItemShadowDecorator`	Drop shadow decoration for pre-Lollipop devices
`SimpleListDividerDecorator`	Simple list divider decoration

Misc.

Class name	Description
`RecyclerViewTouchActionGuardManager`	Suppress scrolling while item animations are running
`AbstractDraggableItemViewHolder`	ViewHolder class which implements boilerplate code of the `DraggableItemViewHolder` interface
`AbstractSwipeableItemViewHolder`	ViewHolder class which implements boilerplate code of the `SwipeableItemViewHolder` interface
`AbstractExpandableItemViewHolder`	ViewHolder class which implements boilerplate code of the `ExpandableItemViewHolder` interface
`AbstractDraggableSwipeableItemViewHolder`	ViewHolder class which implements boilerplate code of the `DraggableItemViewHolder` and the `SwipeableItemViewHolder` interfaces
`AbstractExpandableItemAdapter<GVH, CVH>`	Adapter class which implements boilerplate code of the `ExpandableItemAdapter` interface

Other examples

iOS Mail app like swipe action

Repository

License

This library is licensed under the Apache Software License, Version 2.0.

See LICENSE for full of the license text.

Copyright (C) 2015 Haruki Hasegawa

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.

Fuusio/android-advancedrecyclerview