Merge remote-tracking branch 'origin/master'

Author: wkp111

README.md

@@ -1,21 +1,25 @@
 # StickLayout [ ![Download](https://api.bintray.com/packages/wkp/maven/StickLayout/images/download.svg) ](https://bintray.com/wkp/maven/StickLayout/_latestVersion)
-粘性控件，其任意一个子控件都可滑动停留，无论是View，还是ViewGroup. 
+粘性控件，其任意一个子控件都可滑动停留，无论是View，还是ViewGroup；用该控件可以轻松实现支付宝"全部应用"界面。
 ## 演示图
 ![DragGridView](https://github.com/wkp111/StickLayout/blob/master/StickLayout.gif "演示图")
+![DragGridView](https://github.com/wkp111/StickLayout/blob/master/StickLayout1.gif "演示图1")<br/>
+Note：图1为设置属性wkp_canScrollToEndViewTop=true，图2没有。
 ## Gradle集成
 ```groovy
 dependencies{
-      compile 'com.wkp:StickLayout:1.0.1'
+      compile 'com.wkp:StickLayout:1.0.3'
       //Android Studio3.0+可用以下方式
-      //implementation 'com.wkp:StickLayout:1.0.1'
+      //implementation 'com.wkp:StickLayout:1.0.3'
 }
 ```
 Note：可能存在Jcenter还在审核阶段，这时会集成失败！
 ## 使用详解
 > 属性讲解
 ```xml
-        <!--是否粘性停留-->
+        <!--是否粘性停留(用于直接子控件)-->
         <attr name="wkp_stick" format="boolean"/>
+        <!--是否开启滑动到最后一个控件的顶部，默认不开启(用于控件本身)-->
+        <attr name="wkp_canScrollToEndViewTop" format="boolean"/>
 ```
 Note：每个属性都有对应的java设置代码！
 > 布局
@@ -38,6 +42,7 @@ Note：每个属性都有对应的java设置代码！
         android:layout_width="match_parent"
         android:layout_height="wrap_content"/>
 
+        <!--app:wkp_canScrollToEndViewTop="true"-->
     <com.wkp.sticklayout_lib.widget.StickLayout
         android:id="@+id/sl"
         android:layout_width="match_parent"
@@ -58,32 +63,36 @@ Note：每个属性都有对应的java设置代码！
             android:layout_height="40dp">
 
             <TextView
-                android:background="@android:color/holo_green_light"
-                android:text="NUM1"
+                android:onClick="scrollTo"
+                android:background="@android:color/holo_blue_light"
+                android:text="NUM2"
                 android:gravity="center"
                 android:layout_weight="1"
                 android:layout_width="0dp"
                 android:layout_height="match_parent"/>
 
             <TextView
-                android:background="@android:color/holo_blue_light"
-                android:text="NUM2"
+                android:onClick="scrollTo3"
+                android:background="@android:color/holo_green_light"
+                android:text="NUM3"
                 android:gravity="center"
                 android:layout_weight="1"
                 android:layout_width="0dp"
                 android:layout_height="match_parent"/>
 
             <TextView
+                android:onClick="scrollTo4"
                 android:background="@android:color/holo_red_light"
-                android:text="NUM3"
+                android:text="NUM4"
                 android:gravity="center"
                 android:layout_weight="1"
                 android:layout_width="0dp"
                 android:layout_height="match_parent"/>
 
             <TextView
+                android:onClick="scrollTo7"
                 android:background="@android:color/holo_orange_light"
-                android:text="NUM4"
+                android:text="NUM7"
                 android:gravity="center"
                 android:layout_weight="1"
                 android:layout_width="0dp"
@@ -109,6 +118,7 @@ Note：每个属性都有对应的java设置代码！
             android:layout_height="200dp"/>
 
         <TextView
+            android:background="@android:color/holo_red_light"
             android:id="@+id/tv4"
             android:text="第4行"
             android:gravity="center"
@@ -130,6 +140,7 @@ Note：每个属性都有对应的java设置代码！
             android:layout_height="200dp"/>
 
         <TextView
+            android:background="@android:color/holo_orange_light"
             android:id="@+id/tv7"
             android:text="第7行"
             android:gravity="center"
@@ -147,14 +158,23 @@ Note：ScrollView嵌套StickLayout时事件被拦截，无效果！
 public class MainActivity extends AppCompatActivity {
 
     private StickLayout mSl;
+    private TextView mTv2;
+    private View mTv3;
+    private View mTv7;
+    private View mTv4;
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         mSl = findViewById(R.id.sl);
+        mTv2 = findViewById(R.id.tv2);
+        mTv3 = findViewById(R.id.tv3);
+        mTv4 = findViewById(R.id.tv4);
+        mTv7 = findViewById(R.id.tv7);
 //        mSl.setStickView(findViewById(R.id.tv2));
 //        mSl.setStickView(findViewById(R.id.tv3));
+//        mSl.canScrollToEndViewTop(true);
     }
 
     public void addView(View view) {
@@ -168,7 +188,25 @@ public class MainActivity extends AppCompatActivity {
     public void click(View view) {
         Toast.makeText(this, "第1行", Toast.LENGTH_SHORT).show();
     }
+
+    public void scrollTo(View view) {
+        //滑动到指定子控件
+        mSl.scrollToView(mTv2);
+    }
+
+    public void scrollTo3(View view) {
+        mSl.scrollToView(mTv3);
+    }
+
+    public void scrollTo4(View view) {
+        mSl.scrollToView(mTv4);
+    }
+
+    public void scrollTo7(View view) {
+        mSl.scrollToView(mTv7);
+    }
 }
+
 ```
 Note：还有其他API请根据需要自行参考！ 
 ## 寄语
@@ -180,6 +218,8 @@ QQ邮箱：[email protected]<br/>
 Gmail邮箱：[email protected]<br/>
 
 ## 版本更新
+* v1.0.3<br/>
+新增滑动到指定子控件API<br/><br/>
 * v1.0.1<br/>
 新创建子可粘性停留控件库
 ## License