🔍 Easy sidebar for Android RecyclerView (。>﹏<。)
Clone or download
Latest commit 97de5cf Aug 29, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app set buildToolsVersion to 23.0.3 Jun 3, 2016
easyrecyclerviewsidebar set buildToolsVersion to 23.0.3 Jun 3, 2016
gradle/wrapper gradle2.11 Apr 13, 2016
screenshots Update md Apr 14, 2016
.gitignore Update .gitignore Apr 4, 2016
LICENSE Initial commit Apr 4, 2016
README.md [Update] README.md Aug 29, 2017
build.gradle v0.1 Apr 10, 2016
gradle.properties Init project Apr 5, 2016
gradlew Init project Apr 5, 2016
gradlew.bat Init project Apr 5, 2016
settings.gradle Lower version Apr 6, 2016

README.md

EasyRecyclerViewSidebar


Easy sidebar for Android RecyclerView (。>﹏<。)

Language License Version SDK Download



Introduction

EasyRecyclerViewSidebar is a more convenient sidebar index column.

Not only can you load text, you can also load pictures.

You can also customize the floating View.



Gradle

dependencies {
	compile 'com.camnter.easyrecyclerviewsidebar:easyrecyclerviewsidebar:1.3'
}


Attributes

<declare-styleable name="EasyRecyclerViewSidebar">
    <attr name="easySidebarBackground" format="color" />
    <attr name="easySidebarFontColor" format="color" />
    <attr name="easySidebarTouchWrapArea" format="boolean" />
</declare-styleable>


Listener

You must implement the EasyRecyclerViewSidebar.OnTouchSectionListener .

  • In onTouchImageSection, using the EasyImageSection rendering images for You floating view .
  • In onTouchLetterSection, using the EasySection set letter for You floating view .

Also , you can see the SectionActivity of demo .

public interface OnTouchSectionListener {
    /**
     * On touch image section
     *
     * @param sectionIndex sectionIndex
     * @param imageSection imageSection
     */
    void onTouchImageSection(int sectionIndex, EasyImageSection imageSection);

    /**
     * On touch letter section
     *
     * @param sectionIndex sectionIndex
     * @param letterSection letterSection
     */
    void onTouchLetterSection(int sectionIndex, EasySection letterSection);
}


Easy to use

More details, you can see the xml of a demo

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.camnter.easyrecyclerview.widget.EasyRecyclerView
        android:id="@+id/section_rv"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

    <com.camnter.easyrecyclerviewsidebar.EasyRecyclerViewSidebar
        android:id="@+id/section_sidebar"
        android:layout_width="30dp"
        android:layout_height="fill_parent"
        android:layout_alignParentEnd="true"
        android:layout_alignParentRight="true"
        android:layout_gravity="center|end"/>

    <RelativeLayout
        android:id="@+id/section_floating_rl"
        android:layout_width="70dp"
        android:layout_height="60dp"
        android:layout_centerInParent="true"
        android:background="@drawable/show_float_bg"
        android:visibility="invisible">

        <com.camnter.easyrecyclerviewsidebar.EasyFloatingImageView
            android:id="@+id/section_floating_iv"
            android:layout_width="32dp"
            android:layout_height="32dp"
            android:layout_centerInParent="true"
            android:visibility="invisible"/>

        <TextView
            android:id="@+id/section_floating_tv"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:textColor="#ff444444"
            android:textSize="23sp"
            android:visibility="invisible"/>

    </RelativeLayout>

</RelativeLayout>

EasyFloatingImageView Attributes

<declare-styleable name="EasyFloatingImageView">
    <attr name="easyFloatingImageType">
        <enum name="round" value="2601" />
        <enum name="circle" value="2602" />
    </attr>
    <attr name="easyFloatingBorderRadius" format="dimension" />
</declare-styleable>

setSections

private void initData() {
    this.adapter.setList(this.getData());
    this.adapter.notifyDataSetChanged();
    this.imageSidebar.setSections(this.adapter.getSections());
}

A sample implementation of getSections

@Override public List<EasySection> getSections() {
    this.resetSectionCache();

    int itemCount = getItemCount();
    if (itemCount < 1) return this.easySections;

    String letter;

    for (int i = 0; i < itemCount; i++) {
        Contacts contacts = this.getItem(i);
        letter = contacts.getHeader();
        int section = this.easySections.size() == 0 ? 0 : this.easySections.size() - 1;
        if (contacts.top) {
            if (i != 0) section++;
            this.positionOfSection.put(section, i);
            this.easySections.add(
                    new EasyImageSection(contacts.resId, this.getEasyImageSection(), i));
        } else {
            // A B C D E F ...
            if (section < this.easySections.size()) {
                EasySection easySection = this.easySections.get(section);
                if (easySection instanceof EasyImageSection) {
                    // last section = image section
                    this.easySections.add(new EasySection(letter));
                    section++;
                    this.positionOfSection.put(section, i);
                } else {
                    // last section = letter section
                    if (!this.easySections.get(section).letter.equals(letter)) {
                        this.easySections.add(new EasySection(letter));
                        section++;
                        this.positionOfSection.put(section, i);
                    }
                }
            } else if (section == 0) {
                this.easySections.add(new EasySection(letter));
                this.positionOfSection.put(section, i);
            }
        }
        this.sectionOfPosition.put(i, section);
    }
    return this.easySections;
}


Screenshots

Style Circle Round

No Images



License

  Copyright (C) 2016 CaMnter yuanyu.camnter@gmail.com

  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.