/RecyclerView-FastScroll

A simple FastScroller for Android's RecyclerView

Primary LanguageJava

RecyclerView-FastScroll

Maven Central API License

A simple FastScroller for Android's RecyclerView.

Supports vertical RecyclerViews using either LinearLayoutManager or GridLayoutManager (including multiple spans).

The style is loosely based on the ListView FastScroller from whatever the last version of Lollipop was. This library borrows heavily from Google's Launcher3 FastScroller

Screenshot

###Gradle### compile 'com.simplecityapps:recyclerview-fastscroll:1.0.6'

###Usage### You must use FastScrollRecyclerView as your base RecyclerView. See the sample project if you're having trouble.

Via xml:

 <com.simplecityapps.recyclerview_fastscroll.views.FastScrollRecyclerView
         android:id="@+id/recycler"
         android:layout_width="match_parent"
         android:layout_height="match_parent"
         app:fastScrollAutoHide="true"
         app:fastScrollAutoHideDelay="1500"
         app:fastScrollPopupBgColor="@color/colorAccent"
         app:fastScrollPopupTextColor="@android:color/primary_text_dark"
         app:fastScrollThumbColor="@color/colorAccent" />

To display the FastScrollPopup, your adapter must implement FastScrollRecyclerView.SectionedAdapter and override getSectionName().

#####Customisation#####

You can enable/disable autohide using the fastScrollAutoHide & fastScrollAutoHideDelay attributes in xml:

 <com.simplecityapps.recyclerview_fastscroll.views.FastScrollRecyclerView
         app:fastScrollAutoHide="true"
         app:fastScrollAutoHideDelay="1500"
         ...

Or programmatically via setAutoHideDelay(int hideDelay) and setAutoHideEnabled(boolean autoHideEnabled)

The popup background, popup text, track background and thumb color can all be styled via xml:

  <com.simplecityapps.recyclerview_fastscroll.views.FastScrollRecyclerView
              app:fastScrollPopupBgColor="@color/colorAccent"
              app:fastScrollPopupTextColor="@android:color/primary_text_dark"
              app:fastScrollThumbColor="@color/colorAccent" />
              app:fastScrollTrackColor="#1f000000"/>
              ...

Or programmatically via setThumbColor(@ColorInt int color), setTrackColor(@ColorInt int color), setPopupBgColor(@ColorInt int color)& setPopupTextColor(@ColorInt int color)

###Updates### Note: as of v1.0.6, the FastScrollPopup no longer requires your adapter to implement SectionIndexer, but rather FastScrollRecyclerView.SectionedAdapter, which is much easier to use.

###Licenses###

RecyclerView-FastScroll

 Copyright (C) 2016 Tim Malseed

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.

Launcher 3:

 Copyright (C) 2010 The Android Open Source Project

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.