Android ViewDragHelper实例

发表于 | 分类于 | 阅读次数：

ViewDragHelper创建

1
2
3
//创建ViewDragHelper的实例，第一个参数是ViewGroup，传自己，
// 第二个参数就是滑动灵敏度的意思,可以随意设置，第三个是回调
ViewDragHelper mViewDragHelper = ViewDragHelper.create(this, 1.0f, new DragHelperCallback());

ViewDragHelper主要重写它的Callback方法，即这里的DragHelperCallback：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
class DragHelperCallback extends ViewDragHelper.Callback {
    /**
     * 根据返回结果决定当前child是否可以拖拽
     *
     * @param child     当前被拖拽的view
     * @param pointerId 区分多点触摸的id
     * @return
     */
    @Override
    public boolean tryCaptureView(View child, int pointerId) {
        return mContentLayout == child;
    }
    /**
     * 返回拖拽的范围，不对拖拽进行真正的限制，仅仅决定了动画执行速度
     *
     * @param child
     * @return
     */
    @Override
    public int getViewHorizontalDragRange(View child) {
        return mContentLayoutWidth;
    }
    /**
     * @param child
     * @param left  代表你将要移动到的位置的坐标,返回值就是最终确定的移动的位置,
     *              判断如果这个坐标在layout之内,那我们就返回这个坐标值，
     *              不能让他超出这个范围, 除此之外就是如果你的layout设置了padding的话，
     *              让子view的活动范围在padding之内的
     * @param dx
     * @return
     */
    @Override
    public int clampViewPositionHorizontal(View child, int left, int dx) {
        //Log.d("wxl", "clampViewPositionHorizontal left=" + left);
        if (child == mContentLayout) {
            int newLeft = Math.min(
                    Math.max((-getPaddingLeft() - mBehindLayoutWidth), left), 0);
            return newLeft;
        } else {
            int newLeft = Math.min(
                    Math.max(left, getPaddingLeft() + mContentLayoutWidth - mBehindLayoutWidth),
                    (getPaddingLeft() + mContentLayoutWidth + getPaddingRight()));
            return newLeft;
        }
    }
    /**
     * 位置改变时回调，常用于滑动是更改scale进行缩放等效果
     *
     * @param changedView
     * @param left
     * @param top
     * @param dx          横向滑动的加速度
     * @param dy
     */
    @Override
    public void onViewPositionChanged(
            View changedView, int left, int top, int dx, int dy) {
        //Log.d("wxl", "onViewPositionChanged left=" + left);
        mViewDragRange = left;
        float percent = Math.abs((float) left / (float) mContentLayoutWidth);
        if (null != mViewDragListener)
            mViewDragListener.onDrag(percent);
        if (changedView == mContentLayout) {
            mBehindLayout.offsetLeftAndRight(dx);
        } else {
            mContentLayout.offsetLeftAndRight(dx);
        }
        invalidate();
    }
    /**
     * 拖动结束后调用
     *
     * @param releasedChild
     * @param xvel          水平方向的速度  向右为正
     * @param yvel          竖直方向的速度  向下为正
     */
    @Override
    public void onViewReleased(View releasedChild, float xvel, float yvel) {
        if (releasedChild == mContentLayout) {
            if (xvel <= 0) {//向左滑动
                if (-mViewDragRange >= mBehindLayoutWidth / 2
                        && -mViewDragRange <= mBehindLayoutWidth) {
                    open();
                } else {
                    close();
                }
            } else {//向右滑动
                if (-mViewDragRange >= 0
                        && -mViewDragRange <= mBehindLayoutWidth) {
                    close();
                } else {
                    open();
                }
            }
        }
    }
}

实例

效果预览

实例代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
public class ViewDragLayout extends LinearLayout {
    /**
     * 内容界面
     */
    private ViewGroup mContentLayout;
    /**
     * 遮盖界面
     */
    private ViewGroup mBehindLayout;
    private ViewDragHelper mViewDragHelper;
    /**
     * 手势事件类
     */
    private GestureDetectorCompat mGestureDetectorCompat;
    /**
     * 滑动距离
     */
    private int mViewDragRange;
    /**
     * 左滑最大距离
     */
    private int mBehindLayoutWidth;
    /**
     * 宽度
     */
    private int mContentLayoutWidth;
    private ViewDragListener mViewDragListener;
    private boolean isOpen = false;
    public ViewDragLayout(Context context) {
        super(context);
        init();
    }
    public ViewDragLayout(Context context, AttributeSet attrs) {
        super(context, attrs);
        init();
    }
    public ViewDragLayout(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init();
    }
    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    public ViewDragLayout(Context context, AttributeSet attrs,
                          int defStyleAttr, int defStyleRes) {
        super(context, attrs, defStyleAttr, defStyleRes);
        init();
    }
    /**
     * View 中所有的子控件均被映射成xml后触发
     */
    @Override
    protected void onFinishInflate() {
        mContentLayout = (ViewGroup) getChildAt(0);
        mBehindLayout = (ViewGroup) getChildAt(1);
        mBehindLayout.setClickable(true);
        mContentLayout.setClickable(true);
        super.onFinishInflate();
    }
    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
        mContentLayoutWidth = mContentLayout.getMeasuredWidth();
        mBehindLayoutWidth = mBehindLayout.getMeasuredWidth();
    }
    /**
     * 设置监听
     */
    public void setOnViewDragListener(ViewDragListener viewDragListener) {
        this.mViewDragListener = viewDragListener;
    }
    public interface ViewDragListener {
        void onOpen();
        void onClose();
        void onDrag(float percent);
    }
    /**
     * 滑动时松手后以一定速率继续自动滑动下去并逐渐停止，
     * 类似于扔东西或者松手后自动滑动到指定位置
     */
    @Override
    public void computeScroll() {
        if (mViewDragHelper.continueSettling(true)) {
            ViewCompat.postInvalidateOnAnimation(this);
        }
    }
    /**
     * 初始化
     */
    private void init() {
        //创建ViewDragHelper的实例，第一个参数是ViewGroup，传自己，
        // 第二个参数就是滑动灵敏度的意思,可以随意设置，第三个是回调
        mViewDragHelper = ViewDragHelper.create(this, 1.0f, new DragHelperCallback());
        //手势操作，第二参数什么意思看下面
        mGestureDetectorCompat = new GestureDetectorCompat(getContext(), new XScrollDetector());
    }
    /**
     * 手势监听回调,
     * SimpleOnGestureListener为了不用重写那么多监听的帮助类
     */
    private class XScrollDetector extends GestureDetector.SimpleOnGestureListener {
        @Override
        public boolean onScroll(MotionEvent e1, MotionEvent e2,
                                float distanceX, float distanceY) {
            //判断是否是滑动的x距离>y距离
            return Math.abs(distanceY) <= Math.abs(distanceX);
        }
    }
    class DragHelperCallback extends ViewDragHelper.Callback {
        /**
         * 根据返回结果决定当前child是否可以拖拽
         *
         * @param child     当前被拖拽的view
         * @param pointerId 区分多点触摸的id
         * @return
         */
        @Override
        public boolean tryCaptureView(View child, int pointerId) {
            return mContentLayout == child;
        }
        /**
         * 返回拖拽的范围，不对拖拽进行真正的限制，仅仅决定了动画执行速度
         *
         * @param child
         * @return
         */
        @Override
        public int getViewHorizontalDragRange(View child) {
            return mContentLayoutWidth;
        }
        /**
         * @param child
         * @param left  代表你将要移动到的位置的坐标,返回值就是最终确定的移动的位置,
         *              判断如果这个坐标在layout之内,那我们就返回这个坐标值，
         *              不能让他超出这个范围, 除此之外就是如果你的layout设置了padding的话，
         *              让子view的活动范围在padding之内的
         * @param dx
         * @return
         */
        @Override
        public int clampViewPositionHorizontal(View child, int left, int dx) {
            //Log.d("wxl", "clampViewPositionHorizontal left=" + left);
            if (child == mContentLayout) {
                int newLeft = Math.min(
                        Math.max((-getPaddingLeft() - mBehindLayoutWidth), left), 0);
                return newLeft;
            } else {
                int newLeft = Math.min(
                        Math.max(left, getPaddingLeft() + mContentLayoutWidth - mBehindLayoutWidth),
                        (getPaddingLeft() + mContentLayoutWidth + getPaddingRight()));
                return newLeft;
            }
        }
        /**
         * 位置改变时回调，常用于滑动是更改scale进行缩放等效果
         *
         * @param changedView
         * @param left
         * @param top
         * @param dx          横向滑动的加速度
         * @param dy
         */
        @Override
        public void onViewPositionChanged(
                View changedView, int left, int top, int dx, int dy) {
            //Log.d("wxl", "onViewPositionChanged left=" + left);
            mViewDragRange = left;
            float percent = Math.abs((float) left / (float) mContentLayoutWidth);
            if (null != mViewDragListener)
                mViewDragListener.onDrag(percent);
            if (changedView == mContentLayout) {
                mBehindLayout.offsetLeftAndRight(dx);
            } else {
                mContentLayout.offsetLeftAndRight(dx);
            }
            invalidate();
        }
        /**
         * 拖动结束后调用
         *
         * @param releasedChild
         * @param xvel          水平方向的速度  向右为正
         * @param yvel          竖直方向的速度  向下为正
         */
        @Override
        public void onViewReleased(View releasedChild, float xvel, float yvel) {
            if (releasedChild == mContentLayout) {
                if (xvel <= 0) {//向左滑动
                    if (-mViewDragRange >= mBehindLayoutWidth / 2
                            && -mViewDragRange <= mBehindLayoutWidth) {
                        open();
                    } else {
                        close();
                    }
                } else {//向右滑动
                    if (-mViewDragRange >= 0
                            && -mViewDragRange <= mBehindLayoutWidth) {
                        close();
                    } else {
                        open();
                    }
                }
            }
        }
    }
    /**
     * 打开
     */
    public void open() {
        if (mViewDragHelper.smoothSlideViewTo(
                mContentLayout, -mBehindLayoutWidth, 0)) {
            ViewCompat.postInvalidateOnAnimation(this);
        }
        if (null != mViewDragListener)
            mViewDragListener.onOpen();
        isOpen = true;
    }
    /**
     * 关闭
     */
    public void close() {
        if (mViewDragHelper.smoothSlideViewTo(mContentLayout, 0, 0)) {
            ViewCompat.postInvalidateOnAnimation(this);
        }
        if (null != mViewDragListener)
            mViewDragListener.onClose();
        isOpen = false;
    }
    public boolean isOpen() {
        return isOpen;
    }
    /**
     * 事件拦截下来,相当于把自定义控件的事件交给ViewDragHelper去处理
     *
     * @param ev
     * @return
     */
    @Override
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        return mViewDragHelper.shouldInterceptTouchEvent(ev)
                && mGestureDetectorCompat.onTouchEvent(ev);
    }
    /**
     * 事件监听，交给ViewDragHelper处理
     *
     * @param e
     * @return
     */
    @Override
    public boolean onTouchEvent(MotionEvent e) {
        try {
            mViewDragHelper.processTouchEvent(e);
        } catch (Exception ex) {
            ex.printStackTrace();
        }
        return false;
    }
}

xml引用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
<com.wuxiaolong.apksample.ViewDragLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="200dp"
        android:background="#ffff00">
        <LinearLayout
            android:id="@+id/mContentLayout"
            android:layout_width="match_parent"
            android:layout_height="80dp"
            android:gravity="center"
            android:orientation="vertical">
             <TextView
                android:id="@+id/text"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:layout_gravity="center"
                android:gravity="center_vertical"
                android:paddingLeft="5dp"
                android:text="小尛龙
                \ngithub地址：https://github.com/WuXiaolong
                \n新浪微博：吴小龙同學"
                android:textColor="#202020"
                android:textSize="16sp" />
        </LinearLayout>
        <LinearLayout
            android:id="@+id/mBehindLayout"
            android:layout_width="140dp"
            android:layout_height="80dp">
            <ImageView
                android:id="@+id/add"
                android:layout_width="70dp"
                android:layout_height="match_parent"
                android:background="#4cd964"
                android:paddingLeft="25dp"
                android:paddingRight="25dp"
                android:src="@android:drawable/ic_menu_add" />
            <ImageView
                android:id="@+id/delete"
                android:layout_width="70dp"
                android:layout_height="match_parent"
                android:background="#ff2020"
                android:paddingLeft="25dp"
                android:paddingRight="25dp"
                android:src="@android:drawable/ic_menu_delete" />
        </LinearLayout>
    </com.wuxiaolong.apksample.ViewDragLayout>

源码地址

https://github.com/WuXiaolong/AndroidSamples/blob/master/app/src/main/java/com/wuxiaolong/androidsamples/viewdraghelper/ViewDragLayout.java

延伸阅读

SwipeBackLayout：https://github.com/ikew0ng/SwipeBackLayout

更新日志

  • 2016-11-20 修改
  • 2015-12-04 撰笔


联系作者

我的微信公众号：吴小龙同学，欢迎关注交流，公号回复关键字「1024」有惊喜哦。