saket/InboxRecyclerView

Build expandable descendant navigation, inspired by Google Inbox

InboxRecyclerView is a library for building expandable descendant navigation inspired by Google Inbox and Reply, and is an easy drop-in into existing projects. You can take a look at the sample app for best practices or download its APK for trying it out on your phone. If you're interested in learning how it was created, here's an in-depth blog post.

implementation 'me.saket:inboxrecyclerview:3.0.0'

Usage

Layout

<me.saket.inboxrecyclerview.InboxRecyclerView
  android:layout_width="match_parent"
  android:layout_height="match_parent" />

<me.saket.inboxrecyclerview.page.ExpandablePageLayout
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:background="@color/same_as_your_list_items">

  <!--
    Your expandable content will live here. Make sure that
    your page has a higher z-index than the list by giving
    it a higher view position or a higher elevation.
  -->
</me.saket.inboxrecyclerview.page.ExpandablePageLayout>

Expanding content

recyclerView.itemExpandAnimator = ItemExpandAnimator.scale() // or split() / none()
recyclerView.dimPainter = DimPainter.listAndPage(Color.WHITE, alpha = 0.65f)

recyclerView.expandablePage = findViewById(...).also {
  it.pushParentToolbarOnExpand(toolbar)
  it.addOnPullListener(PageCollapseEligibilityHapticFeedback(it))
}

recyclerViewAdapter.onItemClick = { clickedItem ->
  // Load or update your content inside the page here.
  recyclerView.expandItem(clickedItem.adapterId)
}

How do I…

• customize item expand animations?
• control the pull-to-collapse gesture?
• change background dimming?
• listen to state changes?
• expand items without using Long based adapter IDs?

Pull collapsible activities

To maintain consistency across your whole app, a PullCollapsibleActivity is also included that brings the same animations and gesture to activities with little effort.

Step 1. Extend PullCollapsibleActivity.

Step 2. Add these attributes to the activity’s theme:

<item name="android:windowIsTranslucent">true</item>
<item name="android:colorBackgroundCacheHint">@null</item>

License

Copyright 2018 Saket Narayan.

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.