Android之自定义控件-下拉刷新
实现效果:
图片素材: 
--> 首先, 写先下拉刷新时的刷新布局 pull_to_refresh.xml:
1 <resources> 2 <string name="app_name">PullToRefreshTest</string> 3 <string name="pull_to_refresh">下拉可以刷新</string> 4 <string name="release_to_refresh">释放立即刷新</string> 5 <string name="refreshing">正在刷新...</string> 6 <string name="not_updated_yet">暂未更新过</string> 7 <string name="updated_at">上次更新于%1$s前</string> 8 <string name="updated_just_now">刚刚更新</string> 9 <string name="time_error">时间有问题</string> 10 </resources>
1 <?xml version="1.0" encoding="utf-8"?> 2 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 3 android:id="@+id/pull_to_refresh_head" 4 android:layout_width="match_parent" 5 android:layout_height="60dp"> 6 7 <LinearLayout 8 android:layout_width="200dp" 9 android:layout_height="60dp" 10 android:layout_centerInParent="true" 11 android:orientation="horizontal"> 12 13 <RelativeLayout 14 android:layout_width="0dp" 15 android:layout_height="60dp" 16 android:layout_weight="3"> 17 18 <ImageView 19 android:id="@+id/arrow" 20 android:layout_width="wrap_content" 21 android:layout_height="wrap_content" 22 android:layout_centerInParent="true" 23 android:src="@mipmap/indicator_arrow" /> 24 25 <ProgressBar 26 android:id="@+id/progress_bar" 27 android:layout_width="30dp" 28 android:layout_height="30dp" 29 android:layout_centerInParent="true" 30 android:visibility="gone" /> 31 </RelativeLayout> 32 33 <LinearLayout 34 android:layout_width="0dp" 35 android:layout_height="60dp" 36 android:layout_weight="12" 37 android:orientation="vertical"> 38 39 <TextView 40 android:id="@+id/description" 41 android:layout_width="match_parent" 42 android:layout_height="0dp" 43 android:layout_weight="1" 44 android:gravity="center_horizontal|bottom" 45 android:text="@string/pull_to_refresh" /> 46 47 <TextView 48 android:id="@+id/updated_at" 49 android:layout_width="match_parent" 50 android:layout_height="0dp" 51 android:layout_weight="1" 52 android:gravity="center_horizontal|top" 53 android:text="@string/updated_at" /> 54 </LinearLayout> 55 </LinearLayout> 56 57 </RelativeLayout>
--> 然后, 也是主要的, 自定义下拉刷新的 View (包含下拉刷新所有操作) RefreshView.java:
1 package com.dragon.android.tofreshlayout; 2 3 import android.content.Context; 4 import android.content.SharedPreferences; 5 import android.os.AsyncTask; 6 import android.os.SystemClock; 7 import android.preference.PreferenceManager; 8 import android.util.AttributeSet; 9 import android.view.LayoutInflater; 10 import android.view.MotionEvent; 11 import android.view.View; 12 import android.view.ViewConfiguration; 13 import android.view.animation.RotateAnimation; 14 import android.widget.ImageView; 15 import android.widget.LinearLayout; 16 import android.widget.ListView; 17 import android.widget.ProgressBar; 18 import android.widget.TextView; 19 20 public class RefreshView extends LinearLayout implements View.OnTouchListener { 21 22 private static final String TAG = RefreshView.class.getSimpleName(); 23 24 public enum PULL_STATUS { 25 STATUS_PULL_TO_REFRESH(0), // 下拉状态 26 STATUS_RELEASE_TO_REFRESH(1), // 释放立即刷新状态 27 STATUS_REFRESHING(2), // 正在刷新状态 28 STATUS_REFRESH_FINISHED(3); // 刷新完成或未刷新状态 29 30 private int status; // 状态 31 32 PULL_STATUS(int value) { 33 this.status = value; 34 } 35 36 public int getValue() { 37 return this.status; 38 } 39 } 40 41 // 下拉头部回滚的速度 42 public static final int SCROLL_SPEED = -20; 43 // 一分钟的毫秒值，用于判断上次的更新时间 44 public static final long ONE_MINUTE = 60 * 1000; 45 // 一小时的毫秒值，用于判断上次的更新时间 46 public static final long ONE_HOUR = 60 * ONE_MINUTE; 47 // 一天的毫秒值，用于判断上次的更新时间 48 public static final long ONE_DAY = 24 * ONE_HOUR; 49 // 一月的毫秒值，用于判断上次的更新时间 50 public static final long ONE_MONTH = 30 * ONE_DAY; 51 // 一年的毫秒值，用于判断上次的更新时间 52 public static final long ONE_YEAR = 12 * ONE_MONTH; 53 // 上次更新时间的字符串常量，用于作为 SharedPreferences 的键值 54 private static final String UPDATED_AT = "updated_at"; 55 56 // 下拉刷新的回调接口 57 private PullToRefreshListener mListener; 58 59 private SharedPreferences preferences; // 用于存储上次更新时间 60 private View header; // 下拉头的View 61 private ListView listView; // 需要去下拉刷新的ListView 62 63 private ProgressBar progressBar; // 刷新时显示的进度条 64 private ImageView arrow; // 指示下拉和释放的箭头 65 private TextView description; // 指示下拉和释放的文字描述 66 private TextView updateAt; // 上次更新时间的文字描述 67 68 private MarginLayoutParams headerLayoutParams; // 下拉头的布局参数 69 private long lastUpdateTime; // 上次更新时间的毫秒值 70 71 // 为了防止不同界面的下拉刷新在上次更新时间上互相有冲突，使用id来做区分 72 private int mId = -1; 73 74 private int hideHeaderHeight; // 下拉头的高度 75 76 /** 77 * 当前处理什么状态，可选值有 STATUS_PULL_TO_REFRESH, STATUS_RELEASE_TO_REFRESH, STATUS_REFRESHING 和 STATUS_REFRESH_FINISHED 78 */ 79 private PULL_STATUS currentStatus = PULL_STATUS.STATUS_REFRESH_FINISHED; 80 81 // 记录上一次的状态是什么，避免进行重复操作 82 private PULL_STATUS lastStatus = currentStatus; 83 84 private float yDown; // 手指按下时的屏幕纵坐标 85 86 private int touchSlop; // 在被判定为滚动之前用户手指可以移动的最大值。 87 88 private boolean loadOnce; // 是否已加载过一次layout，这里onLayout中的初始化只需加载一次 89 90 private boolean ableToPull; // 当前是否可以下拉，只有ListView滚动到头的时候才允许下拉 91 92 /** 93 * 下拉刷新控件的构造函数，会在运行时动态添加一个下拉头的布局 94 */ 95 public RefreshView(Context context, AttributeSet attrs) { 96 super(context, attrs); 97 98 preferences = PreferenceManager.getDefaultSharedPreferences(context); 99 header = LayoutInflater.from(context).inflate(R.layout.pull_to_refresh, null, true); 100 progressBar = (ProgressBar) header.findViewById(R.id.progress_bar); 101 arrow = (ImageView) header.findViewById(R.id.arrow); 102 description = (TextView) header.findViewById(R.id.description); 103 updateAt = (TextView) header.findViewById(R.id.updated_at); 104 touchSlop = ViewConfiguration.get(context).getScaledTouchSlop(); 105 106 refreshUpdatedAtValue(); 107 setOrientation(VERTICAL); 108 addView(header, 0); 109 110 //Log.d(TAG, "RefreshView Constructor() getChildAt(0): " + getChildAt(0)); 111 //Log.d(TAG, "RefreshView Constructor() getChildAt(0): " + getChildAt(1)); 112 113 // listView = (ListView) getChildAt(1); 114 // listView.setOnTouchListener(this); 115 } 116 117 /** 118 * 进行一些关键性的初始化操作，比如：将下拉头向上偏移进行隐藏，给 ListView 注册 touch 事件 119 */ 120 @Override 121 protected void onLayout(boolean changed, int l, int t, int r, int b) { 122 super.onLayout(changed, l, t, r, b); 123 if (changed && !loadOnce) { 124 hideHeaderHeight = -header.getHeight(); 125 126 headerLayoutParams = (MarginLayoutParams) header.getLayoutParams(); 127 headerLayoutParams.topMargin = hideHeaderHeight; 128 listView = (ListView) getChildAt(1); 129 //Log.d(TAG, "onLayout() getChildAt(0): " + getChildAt(0)); 130 //Log.d(TAG, "onLayout() listView: " + listView); 131 listView.setOnTouchListener(this); 132 loadOnce = true; 133 } 134 } 135 136 /** 137 * 当 ListView 被触摸时调用，其中处理了各种下拉刷新的具体逻辑 138 */ 139 @Override 140 public boolean onTouch(View v, MotionEvent event) { 141 setCanAbleToPull(event); // 判断是否可以下拉 142 if (ableToPull) { 143 switch (event.getAction()) { 144 case MotionEvent.ACTION_DOWN: 145 yDown = event.getRawY(); 146 break; 147 case MotionEvent.ACTION_MOVE: 148 // 获取移动中的 Y 轴的位置 149 float yMove = event.getRawY(); 150 // 获取从按下到移动过程中移动的距离 151 int distance = (int) (yMove - yDown); 152 153 // 如果手指是上滑状态，并且下拉头是完全隐藏的，就屏蔽下拉事件 154 if (distance <= 0 && headerLayoutParams.topMargin <= hideHeaderHeight) { 155 return false; 156 } 157 if (distance < touchSlop) { 158 return false; 159 } 160 // 判断是否已经在刷新状态 161 if (currentStatus != PULL_STATUS.STATUS_REFRESHING) { 162 // 判断设置的 topMargin 是否 > 0, 默认初始设置为 -header.getHeight() 163 if (headerLayoutParams.topMargin > 0) { 164 currentStatus = PULL_STATUS.STATUS_RELEASE_TO_REFRESH; 165 } else { 166 // 否则状态为下拉中的状态 167 currentStatus = PULL_STATUS.STATUS_PULL_TO_REFRESH; 168 } 169 // 通过偏移下拉头的 topMargin 值，来实现下拉效果 170 headerLayoutParams.topMargin = (distance / 2) + hideHeaderHeight; 171 header.setLayoutParams(headerLayoutParams); 172 } 173 break; 174 case MotionEvent.ACTION_UP: 175 default: 176 if (currentStatus == PULL_STATUS.STATUS_RELEASE_TO_REFRESH) { 177 // 松手时如果是释放立即刷新状态，就去调用正在刷新的任务 178 new RefreshingTask().execute(); 179 } else if (currentStatus == PULL_STATUS.STATUS_PULL_TO_REFRESH) { 180 // 松手时如果是下拉状态，就去调用隐藏下拉头的任务 181 new HideHeaderTask().execute(); 182 } 183 break; 184 } 185 // 时刻记得更新下拉头中的信息 186 if (currentStatus == PULL_STATUS.STATUS_PULL_TO_REFRESH 187 || currentStatus == PULL_STATUS.STATUS_RELEASE_TO_REFRESH) { 188 updateHeaderView(); 189 // 当前正处于下拉或释放状态，要让 ListView 失去焦点，否则被点击的那一项会一直处于选中状态 190 listView.setPressed(false); 191 listView.setFocusable(false); 192 listView.setFocusableInTouchMode(false); 193 lastStatus = currentStatus; 194 // 当前正处于下拉或释放状态，通过返回 true 屏蔽掉 ListView 的滚动事件 195 return true; 196 } 197 } 198 return false; 199 } 200 201 /** 202 * 给下拉刷新控件注册一个监听器 203 * 204 * @param listener 监听器的实现 205 * @param id 为了防止不同界面的下拉刷新在上次更新时间上互相有冲突，不同界面在注册下拉刷新监听器时一定要传入不同的 id 206 */ 207 public void setOnRefreshListener(PullToRefreshListener listener, int id) { 208 mListener = listener; 209 mId = id; 210 } 211 212 /** 213 * 当所有的刷新逻辑完成后，记录调用一下，否则你的 ListView 将一直处于正在刷新状态 214 */ 215 public void finishRefreshing() { 216 currentStatus = PULL_STATUS.STATUS_REFRESH_FINISHED; 217 preferences.edit().putLong(UPDATED_AT + mId, System.currentTimeMillis()).commit(); 218 new HideHeaderTask().execute(); 219 } 220 221 /** 222 * 根据当前 ListView 的滚动状态来设定 {@link #ableToPull} 223 * 的值，每次都需要在 onTouch 中第一个执行，这样可以判断出当前应该是滚动 ListView，还是应该进行下拉 224 */ 225 private void setCanAbleToPull(MotionEvent event) { 226 View firstChild = listView.getChildAt(0); 227 if (firstChild != null) { 228 // 获取 ListView 中第一个Item的位置 229 int firstVisiblePos = listView.getFirstVisiblePosition(); 230 // 判断第一个子控件的 Top 是否和第一个 Item 位置相等 231 if (firstVisiblePos == 0 && firstChild.getTop() == 0) { 232 if (!ableToPull) { 233 // getRawY() 获得的是相对屏幕 Y 方向的位置 234 yDown = event.getRawY(); 235 } 236 // 如果首个元素的上边缘，距离父布局值为 0，就说明 ListView 滚动到了最顶部，此时应该允许下拉刷新 237 ableToPull = true; 238 } else { 239 if (headerLayoutParams.topMargin != hideHeaderHeight) { 240 headerLayoutParams.topMargin = hideHeaderHeight; 241 header.setLayoutParams(headerLayoutParams); 242 } 243 ableToPull = false; 244 } 245 } else { 246 // 如果 ListView 中没有元素，也应该允许下拉刷新 247 ableToPull = true; 248 } 249 } 250 251 /** 252 * 更新下拉头中的信息 253 */ 254 private void updateHeaderView() { 255 if (lastStatus != currentStatus) { 256 if (currentStatus == PULL_STATUS.STATUS_PULL_TO_REFRESH) { 257 description.setText(getResources().getString(R.string.pull_to_refresh)); 258 arrow.setVisibility(View.VISIBLE); 259 progressBar.setVisibility(View.GONE); 260 rotateArrow(); 261 } else if (currentStatus == PULL_STATUS.STATUS_RELEASE_TO_REFRESH) { 262 description.setText(getResources().getString(R.string.release_to_refresh)); 263 arrow.setVisibility(View.VISIBLE); 264 progressBar.setVisibility(View.GONE); 265 rotateArrow(); 266 } else if (currentStatus == PULL_STATUS.STATUS_REFRESHING) { 267 description.setText(getResources().getString(R.string.refreshing)); 268 progressBar.setVisibility(View.VISIBLE); 269 arrow.clearAnimation(); 270 arrow.setVisibility(View.GONE); 271 } 272 refreshUpdatedAtValue(); 273 } 274 } 275 276 /** 277 * 根据当前的状态来旋转箭头 278 */ 279 private void rotateArrow() { 280 float pivotX = arrow.getWidth() / 2f; 281 float pivotY = arrow.getHeight() / 2f; 282 float fromDegrees = 0f; 283 float toDegrees = 0f; 284 if (currentStatus == PULL_STATUS.STATUS_PULL_TO_REFRESH) { 285 fromDegrees = 180f; 286 toDegrees = 360f; 287 } else if (currentStatus == PULL_STATUS.STATUS_RELEASE_TO_REFRESH) { 288 fromDegrees = 0f; 289 toDegrees = 180f; 290 } 291 RotateAnimation animation = new RotateAnimation(fromDegrees, toDegrees, pivotX, pivotY); 292 animation.setDuration(100); 293 animation.setFillAfter(true); 294 arrow.startAnimation(animation); 295 } 296 297 /** 298 * 刷新下拉头中上次更新时间的文字描述 299 */ 300 private void refreshUpdatedAtValue() { 301 lastUpdateTime = preferences.getLong(UPDATED_AT + mId, -1); 302 long currentTime = System.currentTimeMillis(); 303 long timePassed = currentTime - lastUpdateTime; 304 long timeIntoFormat; 305 String updateAtValue; 306 if (lastUpdateTime == -1) { 307 updateAtValue = getResources().getString(R.string.not_updated_yet); 308 } else if (timePassed < 0) { 309 updateAtValue = getResources().getString(R.string.time_error); 310 } else if (timePassed < ONE_MINUTE) { 311 updateAtValue = getResources().getString(R.string.updated_just_now); 312 } else if (timePassed < ONE_HOUR) { 313 timeIntoFormat = timePassed / ONE_MINUTE; 314 String value = timeIntoFormat + "分钟"; 315 updateAtValue = String.format(getResources().getString(R.string.updated_at), value); 316 } else if (timePassed < ONE_DAY) { 317 timeIntoFormat = timePassed / ONE_HOUR; 318 String value = timeIntoFormat + "小时"; 319 updateAtValue = String.format(getResources().getString(R.string.updated_at), value); 320 } else if (timePassed < ONE_MONTH) { 321 timeIntoFormat = timePassed / ONE_DAY; 322 String value = timeIntoFormat + "天"; 323 updateAtValue = String.format(getResources().getString(R.string.updated_at), value); 324 } else if (timePassed < ONE_YEAR) { 325 timeIntoFormat = timePassed / ONE_MONTH; 326 String value = timeIntoFormat + "个月"; 327 updateAtValue = String.format(getResources().getString(R.string.updated_at), value); 328 } else { 329 timeIntoFormat = timePassed / ONE_YEAR; 330 String value = timeIntoFormat + "年"; 331 updateAtValue = String.format(getResources().getString(R.string.updated_at), value); 332 } 333 updateAt.setText(updateAtValue); 334 } 335 336 /** 337 * 正在刷新的任务，在此任务中会去回调注册进来的下拉刷新监听器 338 */ 339 class RefreshingTask extends AsyncTask<Void, Integer, Void> { 340 341 @Override 342 protected Void doInBackground(Void... params) { 343 int topMargin = headerLayoutParams.topMargin; 344 while (true) { 345 topMargin = topMargin + SCROLL_SPEED; 346 if (topMargin <= 0) { 347 topMargin = 0; 348 break; 349 } 350 publishProgress(topMargin); 351 SystemClock.sleep(10); 352 } 353 currentStatus = PULL_STATUS.STATUS_REFRESHING; 354 publishProgress(0); 355 if (mListener != null) { 356 mListener.onRefresh(); 357 } 358 return null; 359 } 360 361 @Override 362 protected void onProgressUpdate(Integer... topMargin) { 363 updateHeaderView(); 364 headerLayoutParams.topMargin = topMargin[0]; 365 header.setLayoutParams(headerLayoutParams); 366 } 367 368 } 369 370 /** 371 * 隐藏下拉头的任务，当未进行下拉刷新或下拉刷新完成后，此任务将会使下拉头重新隐藏 372 */ 373 class HideHeaderTask extends AsyncTask<Void, Integer, Integer> { 374 375 @Override 376 protected Integer doInBackground(Void... params) { 377 int topMargin = headerLayoutParams.topMargin; 378 while (true) { 379 topMargin = topMargin + SCROLL_SPEED; 380 if (topMargin <= hideHeaderHeight) { 381 topMargin = hideHeaderHeight; 382 break; 383 } 384 publishProgress(topMargin); 385 SystemClock.sleep(10); 386 } 387 return topMargin; 388 } 389 390 @Override 391 protected void onProgressUpdate(Integer ... topMargin) { 392 headerLayoutParams.topMargin = topMargin[0]; 393 header.setLayoutParams(headerLayoutParams); 394 } 395 396 @Override 397 protected void onPostExecute(Integer topMargin) { 398 headerLayoutParams.topMargin = topMargin; 399 header.setLayoutParams(headerLayoutParams); 400 currentStatus = PULL_STATUS.STATUS_REFRESH_FINISHED; 401 } 402 } 403 404 /** 405 * 下拉刷新的监听器，使用下拉刷新的地方应该注册此监听器来获取刷新回调 406 */ 407 public interface PullToRefreshListener { 408 // 刷新时会去回调此方法，在方法内编写具体的刷新逻辑。注意此方法是在子线程中调用的， 可以不必另开线程来进行耗时操作 409 void onRefresh(); 410 } 411 }
--> 第三步, 写主布局:
1 <?xml version="1.0" encoding="utf-8"?> 2 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 3 xmlns:tools="http://schemas.android.com/tools" 4 android:layout_width="match_parent" 5 android:layout_height="match_parent" 6 tools:context=".MainActivity" > 7 8 <com.dragon.android.tofreshlayout.RefreshView 9 android:id="@+id/refreshable_view" 10 android:layout_width="match_parent" 11 android:layout_height="match_parent" > 12 13 <ListView 14 android:id="@+id/list_view" 15 android:layout_width="match_parent" 16 android:layout_height="match_parent" > 17 </ListView> 18 19 </com.dragon.android.tofreshlayout.RefreshView> 20 21 </RelativeLayout>
--> 最后, Java 代码添加 ListView 的数据:
package com.dragon.android.tofreshlayout; import android.os.Bundle; import android.os.SystemClock; import android.support.v7.app.AppCompatActivity; import android.webkit.WebView; import android.widget.ArrayAdapter; import android.widget.ListView; public class MainActivity extends AppCompatActivity { RefreshView refreshableView; ListView listView; ArrayAdapter<String> adapter; private WebView webView; private static int NUM = 30; String[] items = new String[NUM]; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); getSupportActionBar().hide(); for (int i = 0; i < items.length; i++) { items[i] = "列表项" + i; } refreshableView = (RefreshView) findViewById(R.id.refreshable_view); listView = (ListView) findViewById(R.id.list_view); adapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, items); listView.setAdapter(adapter); refreshableView.setOnRefreshListener(new RefreshView.PullToRefreshListener() { @Override public void onRefresh() { SystemClock.sleep(3000); refreshableView.finishRefreshing(); } }, 0); } }
程序 Demo: 链接：http://pan.baidu.com/s/1ge6Llw3 密码：skna
***************其实还应该再封装的...*****************
