Awesome Open Source
Awesome Open Source

AlphabetIndex Fast Scroll RecyclerView

A Powerful AlphabetIndex FastScroller for Android's RecyclerView!

AlphabetIndex-Fast-Scroll-RecyclerView - Example1 AlphabetIndex-Fast-Scroll-RecyclerView - Example2 AlphabetIndex-Fast-Scroll-RecyclerView - Example3

Kindly use the following links to use this library:

In build.gradle (Project)

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

And then in the other gradle file(may be your app gradle or your own module library gradle, but never add in both of them to avoid conflict.)

dependencies {
    // AppCompat version
       implementation 'com.github.myinnos:AlphabetIndex-Fast-Scroll-RecyclerView:1.0.92'
	or
    // AndroidX version
       implementation 'com.github.myinnos:AlphabetIndex-Fast-Scroll-RecyclerView:1.0.95'
}

How to use

Step 1: add this to your xml:

<in.myinnos.alphabetsindexfastscrollrecycler.IndexFastScrollRecyclerView
    android:id="@+id/fast_scroller_recycler"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Step 2: implement SectionIndexer to RecyclerViewAdapter.

public class RecyclerViewAdapter extends RecyclerView.Adapter<ViewHolder> implements SectionIndexer {

private List<String> mDataArray;
private ArrayList<Integer> mSectionPositions;
    
.....
    
@Override
public int getSectionForPosition(int position) {
    return 0;
}
 
@Override
public Object[] getSections() {
    List<String> sections = new ArrayList<>(26);
    mSectionPositions = new ArrayList<>(26);
    for (int i = 0, size = mDataArray.size(); i < size; i++) {
        String section = String.valueOf(mDataArray.get(i).charAt(0)).toUpperCase();
        if (!sections.contains(section)) {
            sections.add(section);
            mSectionPositions.add(i);
        }
    }
    return sections.toArray(new String[0]);
}
 
@Override
public int getPositionForSection(int sectionIndex) {
    return mSectionPositions.get(sectionIndex);
}
    
}

Note: mDataArray: this is your recycler data array model.

Features

  • Change IndexTextSize:
 mRecyclerView.setIndexTextSize(12);
  • Change IndexBarTextColor:
 mRecyclerView.setIndexBarTextColor("#FFFFFF");

 mRecyclerView.setIndexBarTextColor(R.color.index_bar_text_color);
  • Change IndexBarColor:
 mRecyclerView.setIndexBarColor("#33334c");

 mRecyclerView.setIndexBarColor(R.color.index_bar_color);
  • Change IndexBarCornerRadius:
 mRecyclerView.setIndexBarCornerRadius(3);
  • Change IndexBarTransparentValue:
mRecyclerView.setIndexBarTransparentValue((float) 0.4);
  • Change IndexbarMargin:
 mRecyclerView.setIndexbarMargin(4);
  • Change IndexbarWidth:
 mRecyclerView.setIndexbarWidth(40);
  • Change PreviewPadding:
 mRecyclerView.setPreviewPadding(2);
  • Change PreviewVisibility:
 mRecyclerView.setPreviewVisibility(false);
  • Change Typeface:
 Typeface typeface = Typeface.createFromAsset(context.getAssets(), "Custom-Font.ttf");
 mRecyclerView.setTypeface(typeface);
  • To hide/show Fast Scroll IndexBar:
mRecyclerView.setIndexBarVisibility(true);
  • Change IndexBarHighLateTextColor:
mRecyclerView.setIndexbarHighLightTextColor("#33334c);

mRecyclerView.setIndexbarHighLightTextColor(R.color.index_bar_highlight_text_color);
  • To hide/show IndexBarHighLightText:
mRecyclerView.setIndexBarHighLightTextVisibility(true);
  • To hide/show IndexBarStroke:
mRecyclerView.setIndexBarStrokeVisibility(true);
  • Change IndexBarStrokeWidth:
mRecyclerView.setIndexBarStrokeWidth(1);
  • Change IndexBarStrokeColor:
mRecyclerView.setIndexBarStrokeColor("#000000");

Compatibility

This library works with any layout manager but is optimized for the use with a LinearLayoutManager.

Any Queries? or Feedback, please let me know by opening a new issue!

Contact

Prabhakar Thota

If you appreciate my work, consider buying me a cup of ☕️ to keep me recharged 🤘 by PayPal

Special Contributors

@jonas-arkulpa
@MFlisar
@RaphaelMarion
@appspell
@Libernys
@IvanAbacumov

License

Copyright 2017 - 2019 MyInnos

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.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Java (697,034) 
Android (41,609) 
Recyclerview (1,337) 
Indexing (295) 
Related Projects
Advertising 📦 9
All Projects
Application Programming Interfaces 📦 120
Applications 📦 181
Artificial Intelligence 📦 72
Blockchain 📦 70
Build Tools 📦 111
Cloud Computing 📦 79
Code Quality 📦 28
Collaboration 📦 30
Command Line Interface 📦 48
Community 📦 81
Companies 📦 60
Compilers 📦 60
Computer Science 📦 74
Configuration Management 📦 39
Content Management 📦 167
Control Flow 📦 197
Data Formats 📦 77
Data Processing 📦 266
Data Storage 📦 132
Economics 📦 60
Frameworks 📦 198
Games 📦 122
Graphics 📦 103
Hardware 📦 148
Integrated Development Environments 📦 47
Learning Resources 📦 147
Legal 📦 28
Libraries 📦 119
Lists Of Projects 📦 21
Machine Learning 📦 336
Mapping 📦 61
Marketing 📦 15
Mathematics 📦 55
Media 📦 228
Messaging 📦 97
Networking 📦 304
Operating Systems 📦 84
Operations 📦 120
Package Managers 📦 52
Programming Languages 📦 229
Runtime Environments 📦 96
Science 📦 42
Security 📦 375
Social Media 📦 26
Software Architecture 📦 70
Software Development 📦 68
Software Performance 📦 57
Software Quality 📦 127
Text Editors 📦 45
Text Processing 📦 131
User Interface 📦 310
User Interface Components 📦 465
Version Control 📦 29
Virtualization 📦 68
Web Browsers 📦 38
Web Servers 📦 25
Web User Interface 📦 194