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 14 or later

Latest version

• Version 0.10.6 (May 6, 2017) (RELEASE NOTES)

Recent Breaking Change Info

• v0.11.0:

  • Since official support libraries have dropped support older API levels than v14, this library does also dropped support them since v0.11.0. If you still need to support API level v9, please continue to use v0.10.6.
  • A new callback onItemSwipeStarted() is added to SwipeableItemAdapter. Users must invoke appropriate notify*() method in this method.
  • A new callback onItemDragStarted() is added to DraggableItemAdapter. Users must invoke appropriate notify*() method in this method.
  • A new callback onItemDragFinished() is added to DraggableItemAdapter. Users must invoke appropriate notify*() method in this method.

• v0.10.4: OnGroupExpandListener and OnGroupCollapseListener takes payload parameter. (related: issue #350)

Getting started

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

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

Usage

Please check the implementation of the simple examples.

Drag & Drop related examples

• Basic
• Minimal
• Draggable grid
• Draggable staggered grid
• Draggable with section
• Drag on Long press
• Uses onCheckCanDrop()

Expandable item related examples

• Basic
• Minimal
• Add & Remove item
• Already expanded groups

Swipeable related examples

• Basic
• Minimal
• Swipeable with button
• Vertical
• Viewpager
• Swipe on long press

Headers and Footers examples

• Minimal
• Expandable with Header/Footer
• Add & Remove Header/Footer items

WrapperAdapter examples

• Composition of All Features
• Insertion items
• Filtering items

Hybrid examples

• Draggable & Swiping
• Draggable & Swiping with section
• Expandable & Draggable & Swiping

Primary classes/interfaces

WrapperAdapter related classes/interfaces

Class/Interface name	Description
WrapperAdapter	Adds several methods to RecyclerView.Adapter to manage with wrapped adapters
ItemIdComposer	Utility class for handling packed item IDs
ItemViewTypeComposer	Utility class for handling packed item view types
SimpleWrapperAdapter<VH>	Base implementation of WrapperAdapter which wraps one adapter

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
DraggableItemAnimator

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
SwipeDismissItemAnimator

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.