NestedWebViewRecyclerViewGroup

NestedWebViewRecyclerViewGroup 是 WebView 和 RecyclerView 的嵌套控件，用于经典的上面是 WebView 显示的文章，下面是 RecyclerView 显示的评论的文章详情页结构中，可以实现 WebView 和 RecyclerView 的无缝滑动切换，也提供 WebView 区域和 RecyclerView 区域的上下显示切换。
NestedWebViewRecyclerViewGroup 的控件高度为该控件的屏幕可见高度，内容高度为 WebView 的控件高度和 RecyclerView 的控件高度之和，占用内存小，滑动流畅。

相关技术点参考：NestedScrolling：文章详情页的实现

Gradle

 compile 'com.github.hzw:NestedWebViewRecyclerViewGroup:'DownLoad Version''

 所需依赖：com.android.support:support-v4:xxx
         com.android.support:recyclerview-v7:xxx

使用

为了使用方便定义了以下一些属性：

//WebView和RecyclerView上下切换的时间
<attr name="switchDuration" format="integer" /> 
//scrollbar是否可用
<attr name="scrollbarEnable" format="boolean" /> 
//scrollbar的颜色
<attr name="scrollbarColor" format="color" /> 
//scrollbar的最小高度
<attr name="scrollbarMinHeight" format="dimension" /> 
//scrollbar的宽度
<attr name="scrollbarWidth" format="dimension" /> 
//scrollbar距离屏幕右边的距离
<attr name="scrollbarMarginRight" format="dimension" />

xml

    <com.hzw.nested.NestedWebViewRecyclerViewGroup
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:switchDuration="300"
        app:scrollbarColor="#000000"
        app:scrollbarEnable="true">

        <com.hzw.nested.NestedScrollWebView
            android:layout_width="match_parent"
            android:layout_height="match_parent">
        </com.hzw.nested.NestedScrollWebView>

        <android.support.v7.widget.RecyclerView
            android:layout_width="match_parent"
            android:layout_height="match_parent">
        </android.support.v7.widget.RecyclerView>
        
    </com.hzw.nested.NestedWebViewRecyclerViewGroup>
    
    ***
    <也支持动态的添加 NestedScrollWebView 和 RecyclerView，具体请查看Demo>
    ***
    <也可以只添加 NestedScrollWebView 或者它的Parent>

code

//如果WebView为MatchParent并且内容存在不满一屏的情况，需要手动设置WebView的内容高度
//如果WebView为WrapContent时，通常不需要设置，如果存在高度不准确的情况，可以手动设置
//WebView的内容高度可让前端同学通过js传递给你
setWebViewContentHeight(int height) ; 

//设置滑动监听
setOnScrollListener(onScrollListener listener)

//获取当前的滑动距离
getCurrentScrollY()

//获取WebView的滑动距离
getWebViewScrollY()

//定位到指定的位置
scrollToPosition(int y)

//WebView和RecyclerView区域的上下切换
switchView(int rvPosition)


//当你的 RecyclerView 不在当前布局中时，有两种方式可以将 RecyclerView
//和 NestedWebViewRecyclerViewGroup 关联起来

//1. 在 NestedWebViewRecyclerViewGroup 的内部如果在解析布局文件时，如果没有找到 RecyclerView ，
//那么在界面显示时会尝试再次获取 RecyclerView ，这种情况不需要你再做额外的事情，通常情况下不需要此设置

//2. 如果你还有更特殊的用法，情况1 任然没有找到你的 RecyclerView
//那么可以调用setRecyclerView 方法，将两者关联
setRecyclerView(RecyclerView recyclerView)

使用时请注意：

NestedWebViewRecyclerViewGroup 最多只能包含两个子View： NestedScrollWebView 和 RecyclerView 或包含它们两者的ViewGroup，具体可查看Demo
RecyclerView 或它的ViewGroup是非必须的

License

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.

silentsword2020 / nestedwebviewrecyclerviewgroup Goto Github PK