# PullZoomView

**Repository Path**: picassoSpring/PullZoomView

## Basic Information

- **Project Name**: PullZoomView
- **Description**: 类似QQ空间，新浪微博个人主页下拉头部放大的布局效果，支持ListView，GridView，ScrollView，WebView，RecyclerView，以及其他的任意View和ViewGroup。支持头部视差动画，阻尼下拉放大，滑动过程监听。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-04-21
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

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

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


## 演示
 ![image](https://github.com/jeasonlzy0216/PullZoomView/blob/master/screenshots/demo1.png)![image](https://github.com/jeasonlzy0216/PullZoomView/blob/master/screenshots/demo2.png)![image](https://github.com/jeasonlzy0216/PullZoomView/blob/master/screenshots/demo3.png)![image](https://github.com/jeasonlzy0216/PullZoomView/blob/master/screenshots/demo4.gif)![image](https://github.com/jeasonlzy0216/PullZoomView/blob/master/screenshots/demo5.gif)![image](https://github.com/jeasonlzy0216/PullZoomView/blob/master/screenshots/demo6.gif)

## 1.温馨提示
  该项目和我github上其他的view相关的项目已经一起打包上传到jCenter仓库中（源码地址 [https://github.com/jeasonlzy0216/ViewCore](https://github.com/jeasonlzy0216/ViewCore) ），使用的时候可以直接使用compile依赖，用法如下
```java
	compile 'com.lzy.widget:view-core:0.2.2'
```
或者使用
```java
    compile project(':pullzoom')
```


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

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

## 4.使用注意事项
 * `PullZoomView` 使用时，需要三个Tag同时设置才能正常工作，否者会抛出异常，即在xml布局中对应的View中，加入如下tag，详细请参看Demo。
```java
    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()`:表示头部恢复原始大小,即放大结束后的回调

此外允许通过代码对滑动行为动态控制
```java
	pzv.setIsParallax(true);    //允许视差动画
    pzv.setIsZoomEnable(true);  //允许头部放大
    pzv.setSensitive(1.5f);     //敏感度1.5
    pzv.setZoomTime(500);       //头部缩放时间500毫秒
```
以上四个方法不是必须设置的，根据需要，可以使用自定义属性设置，也可以使用以上代码动态设置。

完整代码参考如下：
```java
	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");
            }
        });
```