PullZoomView

###类似QQ空间，新浪微博个人主页下拉头部放大的布局效果，支持ListView，GridView，ScrollView，WebView，RecyclerView，以及其他的任意View和ViewGroup。支持头部视差动画和阻尼下拉放大。

欢迎大家下载体验本项目，如果使用过程中遇到什么问题，欢迎反馈。

联系方式

邮箱地址： [email protected]
QQ群： 489873144 （建议使用QQ群，邮箱使用较少，可能看的不及时）
本群旨在为使用我的github项目的人提供方便，如果遇到问题欢迎在群里提问。个人能力也有限，希望一起学习一起进步。

演示

1.温馨提示

该项目和我github上其他的view相关的项目已经一起打包上传到jCenter仓库中（源码地址 https://github.com/jeasonlzy0216/ViewCore ），使用的时候可以直接使用compile依赖，用法如下

	compile 'com.lzy.widget:view-core:0.2.2'

或者使用

    compile project(':pullzoom')

2.实现原理

PullZoomView 继承至 ScrollView，通过布局设置 Tag 和重写滑动事件，达到 PullZoomView 与其他子View嵌套使用，同时增加了外部监听器。

3.自定义属性

自定义属性名字	参数含义
pzv_sensitive	图片放大效果相对于手指滑动距离的敏感度，越小越敏感，默认值 1.5
pzv_isZoomEnable	是否允许下拉时头部放大效果，默认 true，即为允许
pzv_isParallax	滑动时，是否头部具有视差动画，默认 true，即为有
pzv_zoomTime	松手时，缩放头部还原到原始大小的时间，单位毫秒，默认 500毫秒

4.使用注意事项

PullZoomView 使用时，需要三个Tag同时设置才能正常工作，否者会抛出异常，即在xml布局中对应的View中，加入如下tag，详细请参看Demo。

    android:tag="header"
	android:tag="zoom"
	android:tag="content"

与ListView嵌套使用时，ListView需要使用本库中提供的 ExpandListView
与GridView嵌套使用时，GridView需要使用本库中提供的 ExpandGridView
与RecyclerView嵌套使用时，RecyclerView使用v7包中原生的即可，但是LayoutManager需要使用本库中提供的三个管理者，分别是 ExpandLinearLayoutManager, ExpandGridLayoutManager, ExpandStaggeredGridLayoutManager
其他例如 ScrollView，WebView，View子类，ViewGroup子类均使用原生类即可，不用做任何改动。

5.代码参考

对外提供了滑动监听器PullZoomView.OnScrollListener，其中有三个方法

onScroll(int l, int t, int oldl, int oldt): 表示PullZoomView滑动全程的监听
onHeaderScroll(int currentY, int maxY): 表示头部从完全展现，到完全滑出的监听过程
onContentScroll(int l, int t, int oldl, int oldt)：表示除了头部外，内容布局从最顶部滑动到最底部的监听过程

同时提供了下拉放大的监听器PullZoomView.OnPullZoomListener,其中有两个方法

onPullZoom(int originHeight, int currentHeight):表示下拉头部时,头部的的当前大小,单位px
onZoomFinish():表示头部恢复原始大小,即放大结束后的回调

此外允许通过代码对滑动行为动态控制

	pzv.setIsParallax(true);    //允许视差动画
    pzv.setIsZoomEnable(true);  //允许头部放大
    pzv.setSensitive(1.5f);     //敏感度1.5
    pzv.setZoomTime(500);       //头部缩放时间500毫秒

以上四个方法不是必须设置的，根据需要，可以使用自定义属性设置，也可以使用以上代码动态设置。

完整代码参考如下：

	PullZoomView pzv = (PullZoomView) findViewById(R.id.pzv);
        pzv.setIsParallax(true);    //允许视差动画
        pzv.setIsZoomEnable(true);  //允许头部放大
        pzv.setSensitive(1.5f);     //敏感度1.5
        pzv.setZoomTime(500);       //头部缩放时间500毫秒
        pzv.setOnScrollListener(new PullZoomView.OnScrollListener() {
            @Override
            public void onScroll(int l, int t, int oldl, int oldt) {
                System.out.println("onScroll   t:" + t + "  oldt:" + oldt);
            }

            @Override
            public void onHeaderScroll(int currentY, int maxY) {
                System.out.println("onHeaderScroll   currentY:" + currentY + "  maxY:" + maxY);
            }

            @Override
            public void onContentScroll(int l, int t, int oldl, int oldt) {
                System.out.println("onContentScroll   t:" + t + "  oldt:" + oldt);
            }
        });
        pzv.setOnPullZoomListener(new PullZoomView.OnPullZoomListener() {
            @Override
            public void onPullZoom(int originHeight, int currentHeight) {
                System.out.println("onPullZoom  originHeight:" + originHeight + "  currentHeight:" + currentHeight);
            }

            @Override
            public void onZoomFinish() {
                System.out.println("onZoomFinish");
            }
        });

jeasonlzy/PullZoomView

jeasonlzy

Reviews

Repository Details