Features

• Alphabet bar in a side of the screen, this bar can be edited as a RecyclerView, so feel free to customize it :)
• Methods:
  onSectionIndexClickListener( ) launches when user clicks on a letter.
  setAlphabet( ) developer can set up a custom alphabet.
  setLetterToBold( ) you can change letter typeface to bold.

Usage

Implement in your Activity as follows:

Alphabetik alphabetik = (Alphabetik) findViewById(R.id.alphSectionIndex);
        alphabetik.onSectionIndexClickListener(new Alphabetik.SectionIndexClickListener() {
            @Override
            public void onItemClick(View view, int position, String character) {
                String info = " Position = " + position + " Char = " + character;
                Log.i("View: ", view + "," + info);
                //Toast.makeText(getBaseContext(), info, Toast.LENGTH_SHORT).show();
                listView.smoothScrollToPosition(getPositionFromData(character));
            }
        });

If you want to set a custom alphabet:

 private String[] customAlphabet = {"A", "E", "I", "O","U"};
 
 Alphabetik alphabetik = (Alphabetik) findViewById(R.id.alphSectionIndex);
 alphabetik.setAlphabet(customAlphabet);

Set selected letter to bold:

Alphabetik alphabetik = (Alphabetik) findViewById(R.id.alphSectionIndex);
//After scroll, get the first letter of the desired position, and then set it bold.
alphabetik.setLetterToBold(letter);

Set up your Layout as follows:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- You can use a RecyclerView or another "List" instead -->
    <ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_weight="1"
        android:scrollbarStyle="outsideOverlay" />

   <com.alphabetik.Alphabetik
        android:id="@+id/alphSectionIndex"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginRight="5dp"
        android:padding="3dp"
        app:fontSize="16sp"
        app:itemsColor="@color/colorBlue" />

</LinearLayout>

Customize style:

<com.alphabetik.Alphabetik
        android:id="@+id/alphSectionIndex"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginRight="5dp"
        android:padding="3dp"
        app:fontSize="16sp"
        app:itemsColor="@color/colorBlue" />

Installation

Add to gradle file, to the root gradle file (the one outside the "app" directory):

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

Current version: Add the dependency to gradle file (build.gradle inside "app"):

dependencies {
	 compile 'com.github.richimf:Alphabetik:1.0.3'
}

If you always want the latest version, add the dependency to gradle file (build.gradle inside "app"):

dependencies {
   compile 'com.github.richimf:Alphabetik:+'
}

TODO

Swipe gesture along the index bar.

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

Credits

Developed by Ricardo Montesinos /o.o/

License

This code is distributed under the terms and conditions of the MIT license.