Android开源项目QuickReturnHeader分析

最近项目开发，碰到一个ListView的需求。
向上滑动，隐藏Header。向下滑动，迅速显示Header。
在GitHub中，找到了QuickReturnHeader项目，虽然最终因为我们的特殊需求，没有采用这个开源项目，但觉得这个项目不错，就对其进行了分析。
项目地址:https://github.com/ManuelPeinado/QuickReturnHeader
项目的使用方式很简单，下载master工程下来，将library目录倒入到eclipse中（我用的eclipse），其他项目使用的使用，作为library引用即可。
使用方式如下：
这是本项目中的给出的例子：



在要使用的的Activity中onCreate方法中

QuickReturnHeaderHelper helper = new QuickReturnHeaderHelper(this, R.layout.activity_listview, R.layout.header);
View view = helper.createView();
setContentView(view);

R.layout.activity_listview 就是我们的ListView布局，代码如下，

项目中使用了系统默认的ListView的id：@android:id/list。并且在QuickReturnHeader源码中，固定的使用了这个id。这应该是项目需要改进的地方。

<ListView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@android:id/list"
android:layout_width="match_parent"
android:layout_height="match_parent" />

R.layout.header 就是我们的header布局文件，下面是例子中的布局文件

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="@dimen/abs__action_bar_default_height"
android:background="@color/abs__background_holo_light" >

<LinearLayout
android:id="@+id/frame"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_gravity="center"
android:orientation="horizontal" >

<ImageButton
style="@style/actionBarButton"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:src="@drawable/ic_navigation_accept" />

<ImageButton
style="@style/actionBarButton"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:src="@drawable/ic_navigation_cancel" />

<ImageButton
style="@style/actionBarButton"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:src="@drawable/ic_navigation_refresh" />

<ImageButton
style="@style/actionBarButton"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:src="@drawable/ic_action_help" />
</LinearLayout>

<View
android:layout_width="match_parent"
android:layout_height="1dp"
android:layout_gravity="bottom"
android:background="#3333" />

</FrameLayout>

以上就是，这个开源项目的使用，很简单。下面就实现的的原理，进行分析。
简单总结就是一句话，QuickRetrunHeaderHelper，将我们的ListView布局和Header布局，放在了一个FrameLayout中。同时为ListView提供一个Header布局同样高度的空白的ListViewHeader。
用一张图来说明



下面是开源库中的关键代码：
构造函数：

public QuickReturnHeaderHelper(Context context, int contentResId, int headerResId) {
this.context = context;
this.contentResId = contentResId;
this.headerResId = headerResId;
}

createView方法：

public View createView() {
inflater = LayoutInflater.from(context);
content = inflater.inflate(contentResId, null);

realHeader = inflater.inflate(headerResId, null);
realHeaderLayoutParams = new FrameLayout.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
realHeaderLayoutParams.gravity = Gravity.TOP;

// Use measured height here as an estimate of the header height, later on after the layout is complete
// we'll use the actual height
int widthMeasureSpec = MeasureSpec.makeMeasureSpec(LayoutParams.MATCH_PARENT, MeasureSpec.EXACTLY);
int heightMeasureSpec = MeasureSpec.makeMeasureSpec(LayoutParams.WRAP_CONTENT, MeasureSpec.EXACTLY);
realHeader.measure(widthMeasureSpec, heightMeasureSpec);
headerHeight = realHeader.getMeasuredHeight();

listView = (ListView) content.findViewById(android.R.id.list);
if (listView != null) {
createListView();
} else {
createScrollView();
}
return root;
}

createListView方法（此开源库同样适用于ScrollView，通过createScrollView创建，代码类似）:

private void createListView() {
root = (FrameLayout) inflater.inflate(R.layout.qrh__listview_container, null);
root.addView(content);

listView.getViewTreeObserver().addOnGlobalLayoutListener(this);
ListViewScrollObserver observer = new ListViewScrollObserver(listView);
//        listView.setOnScrollListener(this);
observer.setOnScrollUpAndDownListener(new OnListViewScrollListener() {
@Override
public void onScrollUpDownChanged(int delta, int scrollPosition, boolean exact) {
onNewScroll(delta);
snap(headerTop == scrollPosition);
}

@Override
public void onScrollIdle() {
QuickReturnHeaderHelper.this.onScrollIdle();
}
});

root.addView(realHeader, realHeaderLayoutParams);

dummyHeader = new View(context);
AbsListView.LayoutParams params = new AbsListView.LayoutParams(LayoutParams.MATCH_PARENT, headerHeight);
dummyHeader.setLayoutParams(params);
listView.addHeaderView(dummyHeader);
}

添加好布局以后，监听ListView的onScroll，向上滑动就逐渐隐藏我们自定义的Header，向下滑动就将Header显示出来。

以上就是全部分析了，大家看了源码，估计很快就能明白。
我认为项目可能还有很多改进的地方，也不一定适合大家的需求，（好多时候我们自定义的ListView，已经使用了ListView的HeadView，这样再增加空白HeadView就不合适了）
但项目提供了一种可以借鉴的思路，相信再很多时候还是很有用的。