volx-recyclerview-fast-scroll

An easy to use implementation for fast scroll recyclerview

Usage

Minimal working example

In your adapter file implement IVolxAdapter and return your data as a list of objects:

public class UsersOwnAdapter extends RecyclerView . Adapter< UsersOwnAdapter .ViewHolder > implements IVolxAdapter< UserModel > { private List< UserModel > mDataset; @Override public List< UserModel > getList () { return mDataset; }

In your model file add @ValueArea annotation for the field that be rendered as a fast-scroll list

public class UserModel { private int example; @ValueArea private String name; }

In your activity/fragment or wherever you have reference of your parent frame layout and your recyclerview:

new Volx . Builder () .setUserRecyclerView(mRecyclerView) .setParentLayout(parentLayout) .build();

Don't forget to sort your list before building Volx

More On Customization

If you want to customize colors, text sizes and layout sizes you can call it like:

new Volx . Builder () .setUserRecyclerView(mRecyclerView) .setParentLayout(parentLayout) .setActiveColor( Color . CYAN ) // the lightened color of right bar .setBackgroundColor( Color . BLACK ) // the color of right bar .setTextColor( Color . WHITE ) // the color of right bar letters .setBarWidth( 24 ) // the width of right bar in dp .setBarHeightRatio( 1f ) // the height of right bar between 0 and 1 according to screen height .setTextSize( Volx . FIT_NICELY ) // the size of letters in right bar, FIT_NICELY handles it well , other values are also ok .setMiddleTextSize( 16 ) // the size of the letter in center circle .setMiddleLayoutSize( 48 ) // the size of the center circle in dp .setMiddleBackgroundColor( Color . rgb( 67 , 67 , 67 )) // the color of the center circle .setMiddleTextColor( Color . WHITE ) // the color of the letter in center circle .setMiddleStrokeWidth( 4 ) // the width of center circle stroke in dp .setMiddleStrokeColor( Color . BLACK ) // the color of right bar stroke .setRightStrokeWidth( 3 ) // the width of right bar stroke in dp .setRightStrokeColor( Color . rgb( 204 , 204 , 204 )) // the color of middle circle stroke .setMinItem( 0 ) // the min amount of item required to show right bar .setDelayMillis( 3000 ) // the amount of time if there is no interaction on right bar, Volx.NEVER_CLOSE for never close .build();

If you want to make volx invisible and remove it's listeners you can call method with your object:

volx . setInactive( true );

Later you can activate volx again:

if (volx . isInactive()) volx . setInactive( false );

If your data updated , sort your data again and call the notifyValueDataChanged method:

volx . notifyValueDataChanged();

Apps in volx-fast-scroll use

General Mobile Music Player

A nice featured cool music player from General Mobile. You can download it from here

Download

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

allprojects { repositories { .. . maven { url ' https://jitpack.io ' } } }

Step 2. Add the dependency

dependencies { compile ' com.github.volsahin:volx-recyclerview-fast-scroll:v1.0.8 ' }

License