ListView增強組件QuickScroll

QuickScroll使用步驟

國際慣例，先看代碼。

public class Main2Activity extends AppCompatActivity {

    private ArrayList<String> mDatas;
    private ListView mListView;
    private MyAdapter mMyAdapter;

    private static final int CORAL = Color.parseColor("#f0f76541");
    private static final int CORAL_DARK = Color.parseColor("#e0e55b3c");
    private static final int CORAL_HANDLE = Color.parseColor("#80f76541");

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main2);


        initData();
        mListView = (ListView) findViewById(R.id.lv);
        mMyAdapter = new MyAdapter(mDatas, this);
        mListView.setAdapter(mMyAdapter);

        QuickScroll quickscroll = (QuickScroll) findViewById(R.id.quickscroll);

        assert quickscroll!=null;

        //樣式一 跟隨式
        quickscroll.init(QuickScroll.TYPE_INDICATOR_WITH_HANDLE, mListView, mMyAdapter, QuickScroll.STYLE_HOLO);
        quickscroll.setIndicatorColor(CORAL, CORAL_DARK, Color.WHITE);
        quickscroll.setHandlebarColor(CORAL, CORAL, CORAL_HANDLE);

//        quickscroll.setFixedSize(1);
//        quickscroll.setTextSize(TypedValue.COMPLEX_UNIT_DIP, 48);

        //樣式二 彈出式
//        quickscroll.init(QuickScroll.TYPE_POPUP, mListView, mMyAdapter, QuickScroll.STYLE_NONE);
//        quickscroll.setFixedSize(2);
//        quickscroll.setPopupColor(QuickScroll.BLUE_LIGHT, QuickScroll.BLUE_LIGHT_SEMITRANSPARENT, 1, Color.WHITE, 1);

    }

    private void initData() {
        mDatas = new ArrayList<>();
        for (int i = 0; i < 100; i++) {
            mDatas.add(i + " - ANDROID");
        }
    }
}

============華麗的分割線，下面是Adapter=============

public class MyAdapter extends BaseAdapter implements Scrollable {

    private ArrayList<String> mDatas;
    private Context mContext;

    public MyAdapter(ArrayList<String> datas, Context context) {
        mDatas = datas;
        mContext = context;
    }

//基本方法...老三樣，忽略之

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        if (convertView == null) {
            convertView = LayoutInflater.from(mContext).inflate(android.R.layout.simple_list_item_1, null);
        }

        ((TextView) convertView.findViewById(android.R.id.text1)).setText(mDatas.get(position));
        return convertView;
    }

    /**
     * 滑動時返回的預覽文字(索引)
     *
     * @param childposition
     *            equals childposition if used with ExpandableListView, position otherwise.
     * @param groupposition
     * @return
     */
    @Override
    public String getIndicatorForPosition(int childposition, int groupposition) {
        Log.i(TAG, "getIndicatorForPosition: childposition = "+childposition);

//        Log.i(TAG, "getIndicatorForPosition: groupposition = "+groupposition);
        return mDatas.get(childposition);

    }

    /**
     * 重寫該方法，響應滑動時的事件，是否跟隨、定位到當前item
     * @param childposition
     *            equals childposition if used with ExpandableListView, position otherwise.
     * @param groupposition
     * @return
     */
    @Override
    public int getScrollPosition(int childposition, int groupposition) {
        return childposition;
    }

    public static final String TAG = MyAdapter.class.getSimpleName();
}

佈局文件，有些坑，照搬了sample

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.vincyan.a1010_jni2.Main2Activity">

    <ListView
        android:id="@+id/lv"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:divider="#000000"
        android:layout_toStartOf="@+id/quickscroll"
        android:dividerHeight="1px"
        android:drawSelectorOnTop="false"
        android:overScrollMode="never"
        android:scrollbars="none"/>

    <com.andraskindler.quickscroll.QuickScroll
        android:id="@+id/quickscroll"
        android:layout_alignTop="@id/lv"
        android:layout_alignBaseline="@id/lv"
        android:layout_alignParentEnd="true"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"/>
</RelativeLayout>

步驟

使用QuickScroll，直接將源碼複製到項目的目錄下，app/src/main/java/com/…

1、定義Adapter，實現Scrollable接口，重寫下面的兩個方法（必須）

1-1 getIndicatorForPosition
返回當前位置的指示器，就是滑動時的預覽文字
1-2 getScrollPosition
同步ListView的滑動，滾動到指定的item

2、佈局文件中引入QuickScroll組件

com.andraskindler.quickscroll.QuickScroll

3、將QuickScroll跟ListView關聯，配置相關屬性；

quickscroll.init(QuickScroll.TYPE_INDICATOR_WITH_HANDLE, mListView, mMyAdapter, QuickScroll.STYLE_HOLO);
        quickscroll.setIndicatorColor(CORAL, CORAL_DARK, Color.WHITE);
        quickscroll.setHandlebarColor(CORAL, CORAL, CORAL_HANDLE);