ConsecutiveScrollerLayout是Android下支持多个滑动布局(RecyclerView、WebView、ScrollView等)和lView等)和普通控件(TextView、ImageView、LinearLayou、自定义View等)持续连贯滑动的容器,它使所有的子View像一个整体一样连续顺畅滑动。并且支持布局吸顶功能。

效果图

引入依赖

在Project的build.gradle在添加以下代码

allprojects {

repositories {

...

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

}

}

在Module的build.gradle在添加以下代码

// 使用了Androidx

implementation 'com.github.donkingliang:ConsecutiveScroller:2.6.2'

// 或者

// 使用Android support包

implementation 'com.github.donkingliang:ConsecutiveScroller:3.6.2'

由于Androidx和Android support包不兼容，所以ConsecutiveScroller使用两个版本分别支持使用Androidx和使用Android support包的项目。

大版本号3使用Android support包，大版本号2使用Androidx。

注意： 如果你准备使用这个库，请务必认真阅读下面的文档。它能让你了解ConsecutiveScrollerLayout可以实现的功能，以及避免不必要的错误。

基本使用

ConsecutiveScrollerLayout的使用非常简单，把需要滑动的布局作为ConsecutiveScrollerLayout的直接子View即可。

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:scrollbars="vertical">

android:id="@+id/webView"

android:layout_width="match_parent"

android:layout_height="match_parent" />

android:layout_width="match_parent"

android:layout_height="200dp"

android:background="@android:color/holo_red_dark"

android:gravity="center"

android:orientation="vertical">

android:layout_width="match_parent"

android:layout_height="match_parent">

android:id="@+id/recyclerView1"

android:layout_width="match_parent"

android:layout_height="wrap_content" />

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:scaleType="fitXY"

android:src="@drawable/temp" />

android:layout_width="match_parent"

android:layout_height="match_parent">

android:layout_width="match_parent"

android:layout_height="match_parent"

android:background="@color/design_default_color_primary">

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:padding="10dp"

android:text=""

android:textColor="@android:color/black"

android:textSize="18sp" />

android:id="@+id/recyclerView3"

android:layout_width="match_parent"

android:layout_height="match_parent" />

关于margin

ConsecutiveScrollerLayout支持左右margin，但是不支持上下margin，子View间的间距可以通过Space设置。

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:scrollbars="vertical">

android:layout_width="0dp"

android:layout_height="20dp" />

android:layout_width="match_parent"

android:layout_height="200dp"

android:layout_marginLeft="20dp"

android:layout_marginRight="20dp"

android:background="@android:color/holo_red_dark"

android:gravity="center"

android:orientation="vertical">

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="LinearLayout"

android:textColor="@android:color/black"

android:textSize="18sp" />

android:layout_width="0dp"

android:layout_height="20dp" />

布局对齐方式

ConsecutiveScrollerLayout的布局方式类似于垂直的LinearLayout，但是它没有gravity和子view layout_gravity属性。ConsecutiveScrollerLayout为它的子view提供了layout_align属性，用于设置子view和父布局的对齐方式。layout_align有三个值：左对齐(LEFT) 、右对齐(RIGHT) 和中间对齐(CENTER)。

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:scrollbars="vertical">

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:background="@android:color/white"

android:padding="10dp"

android:text="吸顶View - 1"

android:textColor="@android:color/black"

android:textSize="18sp"

app:layout_isSticky="true"

app:layout_align="LEFT"/> // 对齐方式

嵌套Fragment

要想把一个Fragment嵌套在ConsecutiveScrollerLayout里。通常我们需要一个布局容器来承载我们的Fragment，或者直接把Fragment写在activity的布局里。如果Fragment是垂直滑动的，那么承载Fragment的容器需要是ConsecutiveScrollerLayout，以及Fragment的根布局也需要是垂直滑动的。我们推荐使用ConsecutiveScrollerLayout或者其他可垂直滑动的控件(比如：RecyclerView、NestedScrollView)作为Fragment的根布局。如果你的Fragment不是垂直滑动的，则可以忽略这个限制。

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:scrollbars="vertical">

android:id="@+id/fragment_container"

android:layout_width="match_parent"

android:layout_height="match_parent"/>

android:layout_width="match_parent"

android:layout_height="match_parent"

android:name="com.donkingliang.consecutivescrollerdemo.MyFragment"/>

布局吸顶

要实现布局的吸顶效果，在以前，我们可能会写两个一摸一样的布局，一个隐藏在顶部，一个嵌套在ScrollView下，通过监听ScrollView的滑动来显示和隐藏顶部的布局。这种方式实现起来既麻烦也不优雅。ConsecutiveScrollerLayout内部实现了子View吸附顶部的功能，只要设置一个属性，就可以实现吸顶功能。而且支持设置多个子View吸顶，后面的View要吸顶时会把前面的吸顶View推出屏幕。

xmlns:app="http://schemas.android.com/apk/res-auto"

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:scrollbars="vertical">

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:background="@android:color/white"

android:padding="10dp"

android:text="吸顶View - 1"

android:textColor="@android:color/black"

android:textSize="18sp"

app:layout_isSticky="true" />

android:id="@+id/webView"

android:layout_width="match_parent"

android:layout_height="match_parent" />

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:background="@android:color/white"

android:orientation="vertical"

app:layout_isSticky="true">

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:padding="10dp"

android:text="吸顶View - 2 我是个LinearLayout"

android:textColor="@android:color/black"

android:textSize="18sp" />

android:id="@+id/recyclerView1"

android:layout_width="match_parent"

android:layout_height="wrap_content" />

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:background="@android:color/white"

android:padding="10dp"

android:text="吸顶View - 3"

android:textColor="@android:color/black"

android:textSize="18sp"

app:layout_isSticky="true" />

android:layout_width="match_parent"

android:layout_height="match_parent">

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:background="@android:color/white"

android:padding="10dp"

android:text="吸顶View - 4"

android:textColor="@android:color/black"

android:textSize="18sp"

app:layout_isSticky="true" />

android:id="@+id/recyclerView2"

android:layout_width="match_parent"

android:layout_height="wrap_content" />

常驻吸顶

如果你不希望吸顶的view被后面的吸顶view顶出屏幕，而且多个吸顶view排列吸附在顶部，你可以设置常驻吸顶模式：app:isPermanent="true"。

xmlns:app="http://schemas.android.com/apk/res-auto"

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

app:isPermanent="true" // 常驻吸顶

android:scrollbars="vertical">

关于吸顶功能的其他方法

// 设置吸顶到顶部的距离，在距离顶部一定距离时开始悬停吸顶

scrollerLayout.setStickyOffset(50);

// 监听吸顶变化(普通模式)

scrollerLayout.setOnStickyChangeListener(OnStickyChangeListener);

// 监听吸顶变化(常驻模式)

scrollerLayout.setOnPermanentStickyChangeListener(OnPermanentStickyChangeListener);

// 获取当前吸顶view(普通模式)

scrollerLayout.getCurrentStickyView();

// 获取当前吸顶view(常驻模式)

scrollerLayout.getCurrentStickyViews();

局部滑动

ConsecutiveScrollerLayout将所有的子View视作一个整体，由它统一处理页面的滑动事件，所以它默认会拦截可滑动的子View的滑动事件，由自己来分发处理。并且会追踪用户的手指滑动事件，计算调整ConsecutiveScrollerLayout滑动偏移。如果你希望某个子View自己处理自己的滑动事件，可以通过设置layout_isConsecutive属性来告诉父View不要拦截它的滑动事件，这样就可以实现在这个View自己的高度内滑动自己的内容，而不会作为ConsecutiveScrollerLayout的一部分来处理。

xmlns:app="http://schemas.android.com/apk/res-auto"

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:scrollbars="vertical">

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:orientation="vertical"

app:layout_isConsecutive="false">

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:padding="10dp"

android:text="下面的红色区域是个RecyclerView，它在自己的范围内单独滑动。"

android:textColor="@android:color/black"

android:textSize="18sp"

app:layout_isSticky="true" />

android:id="@+id/recyclerView1"

android:layout_width="match_parent"

android:layout_height="300dp"

android:layout_marginLeft="50dp"

android:layout_marginRight="50dp"

android:layout_marginBottom="30dp"

android:background="@android:color/holo_red_dark"/>

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:padding="10dp"

android:text="下面的是个NestedScrollView，它在自己的范围内单独滑动。"

android:textColor="@android:color/black"

android:textSize="18sp" />

android:layout_width="match_parent"

android:layout_height="250dp"

app:layout_isConsecutive="false">

在这个例子中NestedScrollView希望在自己的高度里滑动自己的内容，而不是跟随ConsecutiveScrollerLayout滑动，只要给它设置layout_isConsecutive="false"就可以了。而LinearLayout虽然不是滑动布局，但是在下面嵌套了个滑动布局RecyclerView，所以它也需要设置layout_isConsecutive="false"。

ConsecutiveScrollerLayout支持NestedScrolling机制，如果你的局部滑动的view实现了NestedScrollingChild接口(如：RecyclerView、NestedScrollView等)，它滑动完成后会把滑动事件交给父布局。如果你不想你的子view或它的下级view与父布局嵌套滑动，可以给子view设置app:layout_isNestedScroll="false"。它可以禁止子view与ConsecutiveScrollerLayout的嵌套滑动

滑动子view的下级view

ConsecutiveScrollerLayout默认情况下只会处理它的直接子view的滑动，但有时候需要滑动的布局可能不是ConsecutiveScrollerLayout的直接子view，而是子view所嵌套的下级view。比如ConsecutiveScrollerLayout嵌套FrameLayout,FrameLayout嵌套ScrollView，我们希望ConsecutiveScrollerLayout也能正常处理ScrollView的滑动。为了支持这种需求，ConsecutiveScroller提供了一个接口：IConsecutiveScroller。子view实现IConsecutiveScroller接口，并通过实现接口方法告诉ConsecutiveScrollerLayout需要滑动的下级view,ConsecutiveScrollerLayout就能正确地处理它的滑动事件。IConsecutiveScroller需要实现两个方法：

/**

* 返回当前需要滑动的下级view。在一个时间点里只能有一个view可以滑动。

*/

View getCurrentScrollerView();

/**

* 返回所有可以滑动的子view。由于ConsecutiveScrollerLayout允许它的子view包含多个可滑动的子view，所以返回一个view列表。

*/

List getScrolledViews();

在前面提到的例子中，我们可以这样实现：

public class MyFrameLayout extends FrameLayout implements IConsecutiveScroller {

@Override

public View getCurrentScrollerView() {

// 返回需要滑动的ScrollView

return getChildAt(0);

}

@Override

public List getScrolledViews() {

// 返回需要滑动的ScrollView

List views = new ArrayList<>();

views.add(getChildAt(0));

return views;

}

}

xmlns:app="http://schemas.android.com/apk/res-auto"

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:scrollbars="vertical">

android:layout_width="match_parent"

android:layout_height="match_parent">

android:layout_width="match_parent"

android:layout_height="match_parent">

android:layout_width="match_parent"

android:layout_height="match_parent">

这样ConsecutiveScrollerLayout就能正确地处理ScrollView的滑动。这是一个简单的例子，在实际的需求中，我们一般不需要这样做。

注意：

1、getCurrentScrollerView()和getScrolledViews()必须正确地返回需要滑动的view，这些view可以是经过多层嵌套的，不一定是直接子view。所以使用者应该按照自己的实际场景去实现者两个方法。

2、滑动的控件应该跟嵌套它的子view的高度保持一致，也就是说滑动的控件高度应该是match_parent，并且包裹它的子view和它本身都不要设置上下边距(margin和ppadding)。宽度没有这个限制。

对ViewPager的支持

如果你的ViewPager承载的子布局(或Fragment)不是可以垂直滑动的，那么使用普通的ViewPager即可。如果是可以垂直滑动的，那么你的ViewPager需要实现IConsecutiveScroller接口，并返回需要滑动的view对象。框架里提供了一个实现了IConsecutiveScroller接口自定义控件：ConsecutiveViewPager。使用这个控件，然后你的ConsecutiveViewPager的子view(或Fragment的根布局)是可垂直滑动的view，如：RecyclerView、NestedScrollView、ConsecutiveScrollerLayout即可。这样你的ViewPager就能正确地跟ConsecutiveScrollerLayout一起滑动了。

xmlns:app="http://schemas.android.com/apk/res-auto"

android:id="@+id/scrollerLayout"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:scrollbars="vertical">

android:id="@+id/tabLayout"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:background="@android:color/white"

app:tabGravity="fill"

app:tabIndicatorColor="@color/colorPrimary"

app:tabIndicatorHeight="3dp"

app:tabMode="scrollable"

app:tabSelectedTextColor="@color/colorPrimary" />

android:id="@+id/viewPager"

android:layout_width="match_parent"

android:layout_height="match_parent" />

布局吸顶时会覆盖在下面的布局的上面，有时候我们希望TabLayout吸顶悬浮在顶部，但是不希望它覆盖遮挡ViewPager的内容。ConsecutiveViewPager提供了setAdjustHeight调整自己的布局高度，让自己不被TabLayout覆盖。注意：只有ConsecutiveScrollerLayout是ConsecutiveScrollerLayout的最低部时才能这样做。

// 保证能获取到tabLayout的高度

tabLayout.post(new Runnable() {

@Override

public void run() {

viewPager.setAdjustHeight(tabLayout.getHeight());

}

});

使用腾讯x5的WebView

由于腾讯x5的VebView是一个FrameLayout嵌套WebView的布局，而不是一个WebView的子类，所以要在ConsecutiveScrollerLayout里使用它，需要把它的滑动交给它里面的WebView。自定义MyWebView继承腾讯的WebView,重写它的scrollBy()方法即可。

public class MyWebView extends com.tencent.smtt.sdk.WebView {

@Override

public void scrollBy(int x, int y) {

// 把滑动交给它的子view

getView().scrollBy(x, y);

}

}

通过实现IConsecutiveScroller接口同样可以实现对x5的WebView支持。

public class MyWebView extends com.tencent.smtt.sdk.WebView implements IConsecutiveScroller {

@Override

public View getCurrentScrollerView() {

return getView();

}

@Override

public List getScrolledViews() {

List views = new ArrayList<>();

views.add(getView());

return views;

}

}

另外需要隐藏它的子view的滚动条

View view = webView.getView();

view.setVerticalScrollBarEnabled(false);

view.setHorizontalScrollBarEnabled(false);

view.setOverScrollMode(OVER_SCROLL_NEVER);

其他注意事项

1、WebView在加载的过程中如果滑动的布局，可能会导致WebView与其他View在显示上断层，使用下面的方法一定程度上可以避免这个问题。

webView.setWebChromeClient(new WebChromeClient() {

@Override

public void onProgressChanged(WebView view, int newProgress) {

super.onProgressChanged(view, newProgress);

scrollerLayout.checkLayoutChange();

}

});

2、SmartRefreshLayout和SwipeRefreshLayout等刷新控件可以嵌套ConsecutiveScrollerLayout实现下拉刷新功能，但是ConsecutiveScrollerLayout内部嵌套它们来刷新子view，因为子view时ConsecutiveScrollerLayout滑动内容等一部分。除非你给SmartRefreshLayout或者SwipeRefreshLayout设置app:layout_isConsecutive="false"。

3、继承AbsListView的布局(ListView、GridView等)，在滑动上可能会与用户的手指滑动不同步，推荐使用RecyclerView代替。

4、ConsecutiveScroller的minSdkVersion是19，如果你的项目支持19以下，可以设置：

但是不要在minSdkVersion小于19的项目使用AbsListView的子类，因为ConsecutiveScrollerLayout使用了只有19以上才有的AbsListView API。

5、使用ConsecutiveScrollerLayout提供的setOnVerticalScrollChangeListener()方法监听布局的滑动事件。View所提供的setOnScrollChangeListener()方法已无效。

6、通过getOwnScrollY()方法获取ConsecutiveScrollerLayout的垂直滑动距离，View的getScrollY()方法获取的不是ConsecutiveScrollerLayout的整体滑动距离。