Initial commit

Author: solartcc

.gitignore

@@ -0,0 +1,7 @@
+*.iml
+.gradle
+/local.properties
+/.idea
+.DS_Store
+/build
+/captures

README.md

@@ -0,0 +1,48 @@
+WaveSideBar project
+===================
+
+一个快速跳跃分组的侧边栏控件，示例中配合RecyclerView实现。
+因为控件中使用了`path.op`，所以level>=19，如在项目中使用，请自行修改该处实现以兼容更低版本。
+
+<img src="./preview/simple.gif">
+
+波浪的实现采用了三段二次贝塞尔曲线，附一张手稿草图，仅供参考。
+
+<img src="./preview/design.png">
+
+Usage
+---
+#### **use `WaveSideBarView` in the layout file**
+
+```xml
+    <cc.solart.wave.WaveSideBarView
+        android:id="@+id/side_view"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"/>
+```
+
+#### **set `OnTouchLetterChangeListener`**
+
+```java
+    mSideBarView.setOnTouchLetterChangeListener(new WaveSideBarView.OnTouchLetterChangeListener() {
+            @Override
+            public void onLetterChange(String letter) {
+                int pos = adapter.getLetterPosition(letter);
+
+                if (pos != -1) {
+                    mRecyclerView.scrollToPosition(pos);
+                }
+            }
+        });
+```
+
+    
+Thanks
+------
+used PinnedHeaderDecoration in
+[RecyclerItemDecoration](https://github.com/dinuscxj/RecyclerItemDecoration)
+    
+License
+---
+
+    No fucking license. just enjoy it!

app/.gitignore

@@ -0,0 +1 @@
+/build

app/build.gradle

@@ -0,0 +1,29 @@
+apply plugin: 'com.android.application'
+
+android {
+    compileSdkVersion 23
+    buildToolsVersion "23.0.2"
+
+    defaultConfig {
+        applicationId "cc.solart.wavesidebar"
+        minSdkVersion 19
+        targetSdkVersion 23
+        versionCode 1
+        versionName "1.0"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+    compile fileTree(dir: 'libs', include: ['*.jar'])
+    testCompile 'junit:junit:4.12'
+    compile 'com.android.support:appcompat-v7:23.3.0'
+    compile 'cc.solart:turbo-recyclerview-helper:1.0.3-beta'
+    compile 'com.squareup.retrofit2:converter-gson:2.0.0-beta4'
+    compile project(':wave')
+}

app/proguard-rules.pro

@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in /Users/imilk/Library/Android/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}

app/src/androidTest/java/cc/solart/wavesidebar/ApplicationTest.java

@@ -0,0 +1,13 @@
+package cc.solart.wavesidebar;
+
+import android.app.Application;
+import android.test.ApplicationTestCase;
+
+/**
+ * <a href="http://d.android.com/tools/testing/testing_android.html">Testing Fundamentals</a>
+ */
+public class ApplicationTest extends ApplicationTestCase<Application> {
+    public ApplicationTest() {
+        super(Application.class);
+    }
+}

app/src/main/AndroidManifest.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.solart.wavesidebar">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:supportsRtl="true"
+        android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

app/src/main/java/cc/solart/wavesidebar/LetterComparator.java

@@ -0,0 +1,22 @@
+package cc.solart.wavesidebar;
+
+import java.util.Comparator;
+
+import cc.solart.wavesidebar.bean.City;
+
+public class LetterComparator implements Comparator<City> {
+
+    @Override
+    public int compare(City l, City r) {
+        if (l == null || r == null) {
+            return 0;
+        }
+
+        String lhsSortLetters = l.pys.substring(0, 1).toUpperCase();
+        String rhsSortLetters = r.pys.substring(0, 1).toUpperCase();
+        if (lhsSortLetters == null || rhsSortLetters == null) {
+            return 0;
+        }
+        return lhsSortLetters.compareTo(rhsSortLetters);
+    }
+}

app/src/main/java/cc/solart/wavesidebar/MainActivity.java

@@ -0,0 +1,78 @@
+package cc.solart.wavesidebar;
+
+import android.os.Bundle;
+import android.support.v7.app.AppCompatActivity;
+import android.support.v7.widget.LinearLayoutManager;
+import android.support.v7.widget.RecyclerView;
+
+import com.google.gson.Gson;
+import com.google.gson.reflect.TypeToken;
+
+import java.lang.reflect.Type;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+import cc.solart.wave.WaveSideBarView;
+import cc.solart.wavesidebar.adapter.CityAdapter;
+import cc.solart.wavesidebar.bean.City;
+
+public class MainActivity extends AppCompatActivity {
+
+    RecyclerView mRecyclerView;
+    WaveSideBarView mSideBarView;
+    CityAdapter adapter;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        mRecyclerView = (RecyclerView) findViewById(R.id.recycler_view);
+        mSideBarView = (WaveSideBarView) findViewById(R.id.side_view);
+        mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
+
+        final PinnedHeaderDecoration decoration = new PinnedHeaderDecoration();
+        decoration.registerTypePinnedHeader(1, new PinnedHeaderDecoration.PinnedHeaderCreator() {
+            @Override
+            public boolean create(RecyclerView parent, int adapterPosition) {
+                return true;
+            }
+        });
+        mRecyclerView.addItemDecoration(decoration);
+
+
+        new Thread(new Runnable() {
+            @Override
+            public void run() {
+                Type listType = new TypeToken<ArrayList<City>>() {
+                }.getType();
+                Gson gson = new Gson();
+                final List<City> list = gson.fromJson(City.DATA, listType);
+                Collections.sort(list, new LetterComparator());
+                runOnUiThread(new Runnable() {
+                    @Override
+                    public void run() {
+                        adapter = new CityAdapter(MainActivity.this, list);
+                        mRecyclerView.setAdapter(adapter);
+                    }
+                });
+            }
+        }).start();
+
+        mSideBarView.setOnTouchLetterChangeListener(new WaveSideBarView.OnTouchLetterChangeListener() {
+            @Override
+            public void onLetterChange(String letter) {
+                int pos = adapter.getLetterPosition(letter);
+
+                if (pos != -1) {
+                    mRecyclerView.scrollToPosition(pos);
+                }
+            }
+        });
+
+    }
+
+
+
+
+}