AlphabetIndex Fast Scroll RecyclerView

A Powerful AlphabetIndex FastScroller Library for Android's RecyclerView!

Description

A Powerful AlphabetIndex FastScroller for Android's RecyclerView!

Code Quality Rank: L5

Programming language: Kotlin

License: Apache License 2.0

Tags: RecyclerView     Recyclerview Widget     Data binding     RecyclerView Adapter     Scrolling    

Latest version: v1.0.95

README

AlphabetIndex Fast Scroll RecyclerView

A Powerful AlphabetIndex FastScroller for Android's RecyclerView!

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: java mRecyclerView.setIndexTextSize(12);
• Change IndexBarTextColor: ```java mRecyclerView.setIndexBarTextColor("#FFFFFF");

mRecyclerView.setIndexBarTextColor(R.color.index_bar_text_color);

- Change IndexBarColor:
```java
 mRecyclerView.setIndexBarColor("#33334c");

 mRecyclerView.setIndexBarColor(R.color.index_bar_color);

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

mRecyclerView.setIndexbarHighLightTextColor(R.color.index_bar_highlight_text_color);

- To hide/show IndexBarHighLightText:
```java
mRecyclerView.setIndexBarHighLightTextVisibility(true);

• To hide/show IndexBarStroke: java mRecyclerView.setIndexBarStrokeVisibility(true);
• Change IndexBarStrokeWidth: java mRecyclerView.setIndexBarStrokeWidth(1);
• Change IndexBarStrokeColor: java 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

• :globe_with_meridians: Website: myinnos.in
• :email: e-mail: [email protected]
• :mag_right: LinkedIn: PrabhakarThota
• :thumbsup: Twitter: @myinnos
  
• :camera: Instagram: @prabhakar_t_
  

⚡ If you appreciate my work, consider buying me a cup of :coffee: to keep me recharged :metal: by GitHub or PayPal

Contributing

Thanks to all the people who contributed to AlphabetIndex Fast Scroll RecyclerView

<!--- @jonas-arkulpa
@MFlisar
@RaphaelMarion
@appspell
@Libernys
@IvanAbacumov
@benniebotha @AbandonedCart @Hamza417 -->

License

Copyright 2017 - 2022 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.