做專案時想還原 Day One(一款 iOS 上的付費筆記應用)首頁那種「上下拉可以拉出頭部與底部區塊」的視覺效果,翻了一圈開源庫卻找不到完全合適的,於是決定自己刻一個。先來看成果:

原理其實不複雜:本質上就是控制 ListView 頭部與底部的可視高度。用 RecyclerView 也能做,只是加上頭尾與處理點擊事件都略麻煩,因此選擇直接基於 ListView 實作。
compile 'com.a520wcf.yllistview:YLListView:1.0.1
有個小細節值得注意:android:layout_height 最好設為 match_parent。若用 wrap_content,每次滑動都可能觸發重新計算每個條目的高度,白白消耗 CPU。
<com.a520wcf.yllistview.YLListView
android:divider="@android:color/transparent"
android:id="@+id/listView"
android:layout_width="match_parent"
android:layout_height="match_parent" />
private YLListView listView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
listView = (YLListView) findViewById(R.id.listView);
// 不設定也有預設的頭與底
View topView = View.inflate(this, R.layout.top, null);
listView.addHeaderView(topView);
View bottomView = new View(getApplicationContext());
listView.addFooterView(bottomView);
// 也可以固定頭尾最終高度;不固定的話就使用佈局本身的高度
listView.setFinalBottomHeight(100);
listView.setFinalTopHeight(100);
listView.setAdapter(new DemoAdapter());
// YLListView 預設帶有頭與底,處理點擊事件時位置要減掉
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
position = position - listView.getHeaderViewsCount();
}
});
}
整個元件只有一個類別,不必引入外部依賴,直接把這個類複製進專案即可。
package com.a520wcf.yllistview;
import android.content.Context;
import android.util.AttributeSet;
import android.view.MotionEvent;
import android.view.View;
import android.view.ViewTreeObserver.OnGlobalLayoutListener;
import android.view.animation.DecelerateInterpolator;
import android.widget.AbsListView;
import android.widget.ListView;
import android.widget.Scroller;
public class YLListView extends ListView implements AbsListView.OnScrollListener {
private Scroller mScroller; // 用於回弹
private float mLastY = -1;
private int mScrollBack;
private final static int SCROLLBACK_HEADER = 0;
private final static int SCROLLBACK_FOOTER = 1;
private final static int SCROLL_DURATION = 400; // 回弹時間
private final static float OFFSET_RADIO = 1.8f; // 拖動阻尼係數
private int mTotalItemCount;
private View mHeaderView; // 頂部視圖
private View mFooterView; // 底部視圖
private int finalTopHeight;
private int finalBottomHeight;
public YLListView(Context context) {
super(context);
initWithContext(context);
}
public YLListView(Context context, AttributeSet attrs) {
super(context, attrs);
initWithContext(context);
}
public YLListView(Context context, AttributeSet attrs, int defStyle) {
super(context, attrs, defStyle);
initWithContext(context);
}
private void initWithContext(Context context) {
mScroller = new Scroller(context, new DecelerateInterpolator());
super.setOnScrollListener(this);
this.getViewTreeObserver().addOnGlobalLayoutListener(new OnGlobalLayoutListener() {
@Override
public void onGlobalLayout() {
if (mHeaderView == null) {
addHeaderView(new View(getContext()));
}
if (mFooterView == null) {
addFooterView(new View(getContext()));
}
getViewTreeObserver().removeGlobalOnLayoutListener(this);
}
});
}
@Override
public boolean onTouchEvent(MotionEvent ev) {
if (mLastY == -1) {
mLastY = ev.getRawY();
}
switch (ev.getAction()) {
case MotionEvent.ACTION_DOWN:
mLastY = ev.getRawY();
break;
case MotionEvent.ACTION_MOVE:
final float deltaY = ev.getRawY() - mLastY;
mLastY = ev.getRawY();
// 已在第一項,且頂部已展開或正在往下拉
if (getFirstVisiblePosition() == 0
&& (mHeaderView.getHeight() > finalTopHeight || deltaY > 0)
&& mHeaderView.getTop() >= 0) {
updateHeaderHeight(deltaY / OFFSET_RADIO);
}
// 已在最後一項,且底部已展開或正在往上拉
else if (getLastVisiblePosition() == mTotalItemCount - 1
&& (getFootHeight() > finalBottomHeight || deltaY < 0)) {
updateFooterHeight(-deltaY / OFFSET_RADIO);
}
break;
default:
mLastY = -1; // 重置
// 手勢結束 → 若超過最終高度就回弹
if (getFirstVisiblePosition() == 0
&& getHeaderHeight() > finalTopHeight) {
resetHeaderHeight();
}
if (getLastVisiblePosition() == mTotalItemCount - 1
&& getFootHeight() > finalBottomHeight) {
resetFooterHeight();
}
break;
}
return super.onTouchEvent(ev);
}
/** 底部回弹 */
private void resetFooterHeight() {
int bottomHeight = getFootHeight();
if (bottomHeight > finalBottomHeight) {
mScrollBack = SCROLLBACK_FOOTER;
mScroller.startScroll(0, bottomHeight, 0,
-bottomHeight + finalBottomHeight, SCROLL_DURATION);
invalidate();
}
}
// invalidate() 之後系統會自動回呼 computeScroll()
@Override
public void computeScroll() {
if (mScroller.computeScrollOffset()) {
if (mScrollBack == SCROLLBACK_HEADER) {
setHeaderHeight(mScroller.getCurrY());
} else {
setFooterViewHeight(mScroller.getCurrY());
}
postInvalidate();
}
super.computeScroll();
}
private void setHeaderHeight(int height) {
LayoutParams layoutParams = (LayoutParams) mHeaderView.getLayoutParams();
layoutParams.height = height;
mHeaderView.setLayoutParams(layoutParams);
}
private void setFooterViewHeight(int height) {
LayoutParams layoutParams = (LayoutParams) mFooterView.getLayoutParams();
layoutParams.height = height;
mFooterView.setLayoutParams(layoutParams);
}
public int getHeaderHeight() {
AbsListView.LayoutParams layoutParams =
(AbsListView.LayoutParams) mHeaderView.getLayoutParams();
return layoutParams.height;
}
public int getFootHeight() {
AbsListView.LayoutParams layoutParams =
(AbsListView.LayoutParams) mFooterView.getLayoutParams();
return layoutParams.height;
}
/** 頂部回弹 */
private void resetHeaderHeight() {
int height = getHeaderHeight();
if (height == 0) { // 不可見
return;
}
mScrollBack = SCROLLBACK_HEADER;
mScroller.startScroll(0, height, 0, finalTopHeight - height, SCROLL_DURATION);
invalidate();
}
/** 設定頂部最終高度;不設定則預設為佈局本身高度 */
public void setFinalTopHeight(int height) {
this.finalTopHeight = height;
}
/** 設定底部最終高度;不設定則預設為佈局本身高度 */
public void setFinalBottomHeight(int height) {
this.finalBottomHeight = height;
}
@Override
public void addHeaderView(View v) {
mHeaderView = v;
super.addHeaderView(mHeaderView);
mHeaderView.getViewTreeObserver().addOnGlobalLayoutListener(new OnGlobalLayoutListener() {
@Override
public void onGlobalLayout() {
if (finalTopHeight == 0) {
finalTopHeight = mHeaderView.getMeasuredHeight();
}
setHeaderHeight(finalTopHeight);
getViewTreeObserver().removeGlobalOnLayoutListener(this);
}
});
}
@Override
public void addFooterView(View v) {
mFooterView = v;
super.addFooterView(mFooterView);
mFooterView.getViewTreeObserver().addOnGlobalLayoutListener(new OnGlobalLayoutListener() {
@Override
public void onGlobalLayout() {
if (finalBottomHeight == 0) {
finalBottomHeight = mFooterView.getMeasuredHeight();
}
setFooterViewHeight(finalBottomHeight);
getViewTreeObserver().removeGlobalOnLayoutListener(this);
}
});
}
private OnScrollListener mScrollListener;
// 保留呼叫方原本的滾動監聽
@Override
public void setOnScrollListener(OnScrollListener l) {
mScrollListener = l;
}
@Override
public void onScrollStateChanged(AbsListView view, int scrollState) {
if (mScrollListener != null) {
mScrollListener.onScrollStateChanged(view, scrollState);
}
}
@Override
public void onScroll(AbsListView view, int firstVisibleItem,
int visibleItemCount, int totalItemCount) {
mTotalItemCount = totalItemCount;
if (mScrollListener != null) {
mScrollListener.onScroll(view, firstVisibleItem, visibleItemCount, totalItemCount);
}
}
private void updateHeaderHeight(float delta) {
setHeaderHeight((int) (getHeaderHeight() + delta));
setSelection(0); // 每次都回到頂部
}
private void updateFooterHeight(float delta) {
setFooterViewHeight((int) (getFootHeight() + delta));
}
}
幾個設計上的關鍵點:OFFSET_RADIO 作為阻尼係數,讓手指位移轉成元件高度時有「拉不動」的手感;Scroller 搭配 DecelerateInterpolator 負責手放開後的回彈動畫;而覆寫 setOnScrollListener 並內部保存呼叫方的監聽器,是為了不破壞外部既有的滾動回呼。