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 {
private List<UserModel> mDataset;
@Override
public List<Object> getList() {
return new ArrayList<Object>(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.7'
}
License
Copyright 2017 Volkan ?ahin 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.