注解

/**
* Scroll the view with standard behavior for scrolling beyond the normal
* content boundaries. Views that call this method should override
* {@link #onOverScrolled(int, int, boolean, boolean)} to respond to the
* results of an over-scroll operation.
*
* Views can use this method to handle any touch or fling-based scrolling.
*
* @param deltaX Change in X in pixels
* @param deltaY Change in Y in pixels
* @param scrollX Current X scroll value in pixels before applying deltaX
* @param scrollY Current Y scroll value in pixels before applying deltaY
* @param scrollRangeX Maximum content scroll range along the X axis
* @param scrollRangeY Maximum content scroll range along the Y axis
* @param maxOverScrollX Number of pixels to overscroll by in either direction
* along the X axis.
* @param maxOverScrollY Number of pixels to overscroll by in either direction
* along the Y axis.
* @param isTouchEvent true if this scroll operation is the result of a touch event.
* @return true if scrolling was clamped to an over-scroll boundary along either
* axis, false otherwise.
*/
@SuppressWarnings({"UnusedParameters"})
protected boolean overScrollBy(int deltaX, int deltaY,
int scrollX, int scrollY,
int scrollRangeX, int scrollRangeY,
int maxOverScrollX, int maxOverScrollY,
boolean isTouchEvent)

maxOverScrollX、maxOverScrollY默认为0

注：

只有当listview不能单一屏幕显示时才有该效果

转载内容

第一部分原理分析

      IOS上的bounce功能给人的感觉很爽，当一个可以滚动的区域被拖到边界时，它允许用户将内容拖过界，放手后再弹回来，以一种非常棒的方式提示了用户边界的存在，是IOS的一大特色。android2.3新增了overscroll功能，听名字就知道应该是bounce功能的翻版，但也许是出于专利方面的考虑，google的默认实现跟IOS有所不同，它只是在list拖到边界处时做了一个发光的动画，个人觉得体验比IOS差远了。而且这个黄色的发光在黑色背景下虽然效果不错，在其它背景下可就难说了，因此很多人想要关掉它。

      日前google上搜索“android overscroll”，对此效果的介绍很多，但关于其具体使用方式和实现，则很少涉及，偶有提及，也经常答非所问或似是而非，反而误导了别人。于是我查阅了android相关源码，并做了一些测试，在此讲讲我的理解。

      首先是overscroll功能本身，在最顶层的View类提供了支持，可通过setOverScrollMode函数控制其出现条件。但其实View中并没有实现overscroll功能，它仅仅提供了一个辅助函数overScrollBy，该函数根据overScrollMode和内容是否需要滚动控制最大滚动范围，最后将计算结果传给onOverScrolled实现具体的overscroll功能，但此函数在View类中是全空的。

      overscroll功能真正的实现分别在ScrollView、AbsListView、HorizontalScrollView和WebView中各有一份，代码基本一样。以ScrollView为例，它在处理笔点移动消息时调用overScrollBy来滚动视图，然后重载了overScrollBy函数来实现具体功能，其位置计算通过OverScroller类实现。OverScroller作为一个计算引擎，应该是一个独立的模块，具体滚动效果和范围都不可能通过它来设置，我觉得没有必要细看。但滚动位置最终是它给出的，那相关数据肯定要传递给它，回头看overScrollBy函数，它有两个控制overScroll出界范围的参数，几个实现里面都是取自ViewConfiguration.getScaledOverscrollDistance，而这个参数的值在我的源码中都是0，而且我没找到任何可以影响其结果的设置。

      真悲催，绕了半天，android的默认实现里面根本没有给出overscroll功能，它只是提供了实现机制，要想用起来还得应用程序自己显式重写相关控件，估计还有一层隐含的意思，法律风险自负。在我的系统中一试，果然一个像素都不能拉出界。但那个闪光是怎么回事呢？

      在处理笔点消息处，overScrollBy后面不远处有一段mEdgeGlowTop的操作代码，看名字就像，用它一搜，相关机制就全明白了。mEdgeGlowTop在setOverScrollMode函数时创建，它使用的图片都是系统中固有的，甚至不能通过theme改变。它的实现原理也很简单，仅仅是两张png图片的合成，通过透明度的变化制造闪光的效果。更无语的是它既不能被应用程序访问，也不受任何控制，要关闭它的唯一办法是setOverScrollMode(View.OVER_SCROLL_NEVER)。否则就重写onTouchEvent函数吧，想干啥都可以，只是得自己做。

      谈到overScroll，很多文章都提到了ListView的setOverscrollHeader和setOverscrollFooter，很多人想通过这个来控制那个闪光效果。这两玩意不但可以通过函数设置，也可以在xml中指定，相当方便。但最后很多人发现没有任何作用，百思不得其解。其实这两张图片是用来作为overScroll拖过界时的背景的，默认系统不能拖过界，自然永远都看不到，有些定制的系统中能拖出界几个像素，但也很难看清。

                 第二部分代码实现
     1. 在View中增加了overSrollBy方法,用于记录x, y 轴上滚动。

     2. 在AbsListView的onTouchEvent中判断是否到达边界(顶部或底部) ,然后调用view.overScrollBy ,传入 mScrollY等参数

     3. overScrollBy 最终赋值给View的mScrollX, mScrollY 两个变量

     4. 在AbsListView中调用完overScrollBy之后,调用invalidate重绘

自定义ListView
Java代码

public class BounceListView extends ListView{
private static final int MAX_Y_OVERSCROLL_DISTANCE = 200;
private Context mContext;
private int mMaxYOverscrollDistance;
public BounceListView(Context context){
super(context);
mContext = context;
initBounceListView();
}
public BounceListView(Context context, AttributeSet attrs){
super(context, attrs);
mContext = context;
initBounceListView();
}
public BounceListView(Context context, AttributeSet attrs, int defStyle){
super(context, attrs, defStyle);
mContext = context;
initBounceListView();
}
private void initBounceListView(){
//get the density of the screen and do some maths with it on the max overscroll distance
//variable so that you get similar behaviors no matter what the screen size
final DisplayMetrics metrics = mContext.getResources().getDisplayMetrics();
final float density = metrics.density;
mMaxYOverscrollDistance = (int) (density * MAX_Y_OVERSCROLL_DISTANCE);
}
@Override
protected boolean overScrollBy(int deltaX, int deltaY, int scrollX, int scrollY, int scrollRangeX, int scrollRangeY, int maxOverScrollX, int maxOverScrollY, boolean isTouchEvent){
//This is where the magic happens, we have replaced the incoming maxOverScrollY with our own custom variable mMaxYOverscrollDistance;
return super.overScrollBy(deltaX, deltaY, scrollX, scrollY, scrollRangeX, scrollRangeY, maxOverScrollX, mMaxYOverscrollDistance, isTouchEvent);
}
}

Java代码

public class MainActivity extends Activity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
LinearLayout linearLayout = new LinearLayout(this);
linearLayout.setLayoutParams(new LayoutParams(LayoutParams.FILL_PARENT, LayoutParams.FILL_PARENT));
setContentView(linearLayout);
BounceListView bounceListView = new BounceListView(this);
String[] data = new String[30];
for (int i = 0; i < data.length; i++) {
data[i] = "回弹效果 " + i;
}
ArrayAdapter arrayAdapter =
new ArrayAdapter(this,android.R.layout.simple_list_item_1, data);
bounceListView.setAdapter(arrayAdapter);
linearLayout.addView(bounceListView);
}
}

Android(安卓)ListView滑动回弹——overScrollBy

注解

注：

转载内容

更多相关文章

随机推荐