Skip to content

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

Notifications You must be signed in to change notification settings

jeasonlzy/PullZoomView

Repository files navigation

PullZoomView

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

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

联系方式

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

演示

imageimageimageimageimageimage

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");
            }
        });

About

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages