blob: a7198a80cd141a6d0fb9278b6d3d3b3d5de2ebff [file] [log] [blame]
Winson Chung321e9ee2010-08-09 13:37:56 -07001/*
Adam Cohen7d30a372013-07-01 17:03:59 -07002 * Copyright (C) 2012 The Android Open Source Project
Winson Chung321e9ee2010-08-09 13:37:56 -07003 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
Daniel Sandler325dc232013-06-05 22:57:57 -040017package com.android.launcher3;
Winson Chung321e9ee2010-08-09 13:37:56 -070018
Andras Kloczl55edfe52021-05-14 12:21:30 +020019import static androidx.annotation.VisibleForTesting.PACKAGE_PRIVATE;
Andras Kloczldbf577a2021-05-26 15:02:52 +020020
Sunny Goyalc39db732021-04-03 01:20:21 -070021import static com.android.launcher3.anim.Interpolators.SCROLL;
Sunny Goyal8b37c572020-03-31 12:12:14 -070022import static com.android.launcher3.compat.AccessibilityManagerCompat.isAccessibilityEnabled;
23import static com.android.launcher3.compat.AccessibilityManagerCompat.isObservedEventType;
Sunny Goyal8b37c572020-03-31 12:12:14 -070024import static com.android.launcher3.touch.OverScroll.OVERSCROLL_DAMP_FACTOR;
Sunny Goyal8b37c572020-03-31 12:12:14 -070025import static com.android.launcher3.touch.PagedOrientationHandler.VIEW_SCROLL_BY;
26import static com.android.launcher3.touch.PagedOrientationHandler.VIEW_SCROLL_TO;
27
Sunny Goyal3e2ff8a2015-04-15 16:31:22 -070028import android.animation.LayoutTransition;
Sunny Goyalcf25b522015-07-09 00:01:18 -070029import android.annotation.SuppressLint;
Winson Chung321e9ee2010-08-09 13:37:56 -070030import android.content.Context;
Adam Cohen9c4949e2010-10-05 12:27:22 -070031import android.content.res.TypedArray;
Jon Miranda71cb80c2019-01-24 21:25:13 -080032import android.graphics.Canvas;
Winson Chung321e9ee2010-08-09 13:37:56 -070033import android.graphics.Rect;
Svetoslav Ganov08055f62012-05-15 11:06:36 -070034import android.os.Bundle;
Tony Wickhamd58c2d52018-05-04 12:10:55 -070035import android.provider.Settings;
Winson Chung321e9ee2010-08-09 13:37:56 -070036import android.util.AttributeSet;
Winson Chung785d2eb2011-04-14 16:08:02 -070037import android.util.Log;
Winson Chung185d7162011-02-28 13:47:29 -080038import android.view.InputDevice;
39import android.view.KeyEvent;
Winson Chung321e9ee2010-08-09 13:37:56 -070040import android.view.MotionEvent;
41import android.view.VelocityTracker;
42import android.view.View;
43import android.view.ViewConfiguration;
Sunny Goyal4ffec482016-02-09 11:28:52 -080044import android.view.ViewDebug;
Winson Chung321e9ee2010-08-09 13:37:56 -070045import android.view.ViewGroup;
46import android.view.ViewParent;
Winson Chung6a0f57d2011-06-29 20:10:49 -070047import android.view.accessibility.AccessibilityEvent;
48import android.view.accessibility.AccessibilityNodeInfo;
Sunny Goyalc39db732021-04-03 01:20:21 -070049import android.widget.OverScroller;
Vadim Trysheve6bbefb2018-04-03 13:38:06 -070050import android.widget.ScrollView;
Tony Wickhamf549dab2016-05-16 09:54:06 -070051
Tony Wickham62117d72020-03-26 16:56:26 -070052import androidx.annotation.Nullable;
Andras Kloczl55edfe52021-05-14 12:21:30 +020053import androidx.annotation.VisibleForTesting;
Tony Wickham62117d72020-03-26 16:56:26 -070054
Jon Miranda9e198662020-03-11 14:42:02 -070055import com.android.launcher3.compat.AccessibilityManagerCompat;
56import com.android.launcher3.config.FeatureFlags;
Jon Miranda9e198662020-03-11 14:42:02 -070057import com.android.launcher3.pageindicators.PageIndicator;
Jon Miranda9e198662020-03-11 14:42:02 -070058import com.android.launcher3.touch.PagedOrientationHandler;
59import com.android.launcher3.touch.PagedOrientationHandler.ChildBounds;
Sunny Goyalc39db732021-04-03 01:20:21 -070060import com.android.launcher3.util.EdgeEffectCompat;
Andras Kloczl55edfe52021-05-14 12:21:30 +020061import com.android.launcher3.util.IntSet;
Jon Miranda9e198662020-03-11 14:42:02 -070062import com.android.launcher3.util.Thunk;
Sunny Goyal8b37c572020-03-31 12:12:14 -070063import com.android.launcher3.views.ActivityContext;
Jon Miranda9e198662020-03-11 14:42:02 -070064
65import java.util.ArrayList;
Sunny Goyal59969372021-05-06 12:11:44 -070066import java.util.function.Consumer;
Jon Miranda9e198662020-03-11 14:42:02 -070067
Winson Chung321e9ee2010-08-09 13:37:56 -070068/**
69 * An abstraction of the original Workspace which supports browsing through a
Michael Jurka0142d492010-08-25 17:46:15 -070070 * sequential list of "pages"
Winson Chung321e9ee2010-08-09 13:37:56 -070071 */
Sunny Goyal0bd7f4f2018-02-01 09:53:35 -080072public abstract class PagedView<T extends View & PageIndicator> extends ViewGroup {
Winson Chung321e9ee2010-08-09 13:37:56 -070073 private static final String TAG = "PagedView";
Winson Chung785d2eb2011-04-14 16:08:02 -070074 private static final boolean DEBUG = false;
Winson Chung4941f652020-06-18 15:11:53 -070075 public static final boolean DEBUG_FAILED_QUICKSWITCH = false;
Sunny Goyal20a13ff2018-03-13 16:44:00 -070076
Winson Chung4941f652020-06-18 15:11:53 -070077 public static final int ACTION_MOVE_ALLOW_EASY_FLING = MotionEvent.ACTION_MASK - 1;
Sunny Goyala7a5bf32020-01-05 15:35:29 +053078 public static final int INVALID_PAGE = -1;
Sunny Goyal20a13ff2018-03-13 16:44:00 -070079 protected static final ComputePageScrollsLogic SIMPLE_SCROLL_LOGIC = (v) -> v.getVisibility() != GONE;
Winson Chung321e9ee2010-08-09 13:37:56 -070080
Vadim Tryshevfedca432015-08-19 17:55:02 -070081 public static final int PAGE_SNAP_ANIMATION_DURATION = 750;
Winson Chung321e9ee2010-08-09 13:37:56 -070082
Adam Cohenb64cb5a2011-02-15 13:53:42 -080083 private static final float RETURN_TO_ORIGINAL_PAGE_THRESHOLD = 0.33f;
Adam Cohen00481b32011-11-18 12:03:48 -080084 // The page is moved more than halfway, automatically move to the next page on touch up.
85 private static final float SIGNIFICANT_MOVE_THRESHOLD = 0.4f;
Adam Cohen68d73932010-11-15 10:50:58 -080086
Sunny Goyal8e2133b2015-05-06 13:39:07 -070087 private static final float MAX_SCROLL_PROGRESS = 1.0f;
88
Adam Cohen265b9a62011-12-07 14:37:18 -080089 // The following constants need to be scaled based on density. The scaled versions will be
90 // assigned to the corresponding member variables below.
91 private static final int FLING_THRESHOLD_VELOCITY = 500;
Winson Chung4941f652020-06-18 15:11:53 -070092 private static final int EASY_FLING_THRESHOLD_VELOCITY = 400;
Adam Cohen265b9a62011-12-07 14:37:18 -080093 private static final int MIN_SNAP_VELOCITY = 1500;
94 private static final int MIN_FLING_VELOCITY = 250;
95
Adam Cohenf358a4b2013-07-23 16:47:31 -070096 private boolean mFreeScroll = false;
Adam Cohenf358a4b2013-07-23 16:47:31 -070097
Winson Chung4941f652020-06-18 15:11:53 -070098 protected final int mFlingThresholdVelocity;
99 protected final int mEasyFlingThresholdVelocity;
100 protected final int mMinFlingVelocity;
101 protected final int mMinSnapVelocity;
Michael Jurka0142d492010-08-25 17:46:15 -0700102
Michael Jurka0142d492010-08-25 17:46:15 -0700103 protected boolean mFirstLayout = true;
104
Sunny Goyal4ffec482016-02-09 11:28:52 -0800105 @ViewDebug.ExportedProperty(category = "launcher")
Michael Jurka0142d492010-08-25 17:46:15 -0700106 protected int mCurrentPage;
Alex Chauba61b982021-06-15 16:29:19 +0100107 // Difference between current scroll position and mCurrentPage's page scroll. Used to maintain
108 // relative scroll position unchanged in updateCurrentPageScroll. Cleared when snapping to a
109 // page.
110 protected int mCurrentPageScrollDiff;
Lais Andradecc5c8842021-06-04 18:20:30 +0100111 // The current page the PagedView is scrolling over on it's way to the destination page.
112 protected int mCurrentScrollOverPage;
Adam Cohene61a9a22013-06-11 15:45:31 -0700113
Sunny Goyal4ffec482016-02-09 11:28:52 -0800114 @ViewDebug.ExportedProperty(category = "launcher")
Michael Jurka0142d492010-08-25 17:46:15 -0700115 protected int mNextPage = INVALID_PAGE;
Vinit Nayaka406f722019-12-19 11:50:55 -0800116 protected int mMaxScroll;
117 protected int mMinScroll;
Sunny Goyalb7b01352018-08-09 12:31:20 -0700118 protected OverScroller mScroller;
Winson Chung321e9ee2010-08-09 13:37:56 -0700119 private VelocityTracker mVelocityTracker;
Sunny Goyale15e2a82017-12-15 13:05:42 -0800120 protected int mPageSpacing = 0;
Winson Chung321e9ee2010-08-09 13:37:56 -0700121
122 private float mDownMotionX;
Adam Cohen7d30a372013-07-01 17:03:59 -0700123 private float mDownMotionY;
Vinit Nayaka406f722019-12-19 11:50:55 -0800124 private float mDownMotionPrimary;
125 private float mLastMotion;
126 private float mLastMotionRemainder;
127 private float mTotalMotion;
Winson Chung4941f652020-06-18 15:11:53 -0700128 // Used in special cases where the fling checks can be relaxed for an intentional gesture
129 private boolean mAllowEasyFling;
Sunny Goyalacd17df2020-04-03 15:58:45 -0700130 protected PagedOrientationHandler mOrientationHandler = PagedOrientationHandler.PORTRAIT;
Adam Cohenedb40762013-07-18 16:45:45 -0700131
Vadim Trysheve628c472018-05-16 14:28:18 -0700132 protected int[] mPageScrolls;
Sunny Goyalaad33592018-08-07 17:20:35 -0700133 private boolean mIsBeingDragged;
Adam Cohencae7f572013-11-04 14:42:52 -0800134
Winson Chung4941f652020-06-18 15:11:53 -0700135 // The amount of movement to begin scrolling
Michael Jurka7426c422010-11-11 15:23:47 -0800136 protected int mTouchSlop;
Winson Chung4941f652020-06-18 15:11:53 -0700137 // The amount of movement to begin paging
138 protected int mPageSlop;
Winson Chung321e9ee2010-08-09 13:37:56 -0700139 private int mMaximumVelocity;
Adam Cohen68d73932010-11-15 10:50:58 -0800140 protected boolean mAllowOverScroll = true;
Winson Chung321e9ee2010-08-09 13:37:56 -0700141
Michael Jurka5f1c5092010-09-03 14:15:02 -0700142 protected static final int INVALID_POINTER = -1;
Winson Chung321e9ee2010-08-09 13:37:56 -0700143
Michael Jurka5f1c5092010-09-03 14:15:02 -0700144 protected int mActivePointerId = INVALID_POINTER;
Winson Chung321e9ee2010-08-09 13:37:56 -0700145
Sunny Goyal9ccafbf2016-10-26 13:06:08 -0700146 protected boolean mIsPageInTransition = false;
Tony Wickham62117d72020-03-26 16:56:26 -0700147 private Runnable mOnPageTransitionEndCallback;
Patrick Dubroy1262e362010-10-06 15:49:50 -0700148
Winson Chungd2be3812013-07-16 11:11:32 -0700149 // Page Indicator
Adam Cohen091440a2015-03-18 14:16:05 -0700150 @Thunk int mPageIndicatorViewId;
Sunny Goyal0bd7f4f2018-02-01 09:53:35 -0800151 protected T mPageIndicator;
Adam Cohen7d30a372013-07-01 17:03:59 -0700152
John Spurlock77e1f472013-09-11 10:09:51 -0400153 protected final Rect mInsets = new Rect();
Tony Wickhamdfb5cc92018-02-26 16:41:57 -0800154 protected boolean mIsRtl;
John Spurlock77e1f472013-09-11 10:09:51 -0400155
Sunny Goyal85a7fe02018-02-02 10:09:32 -0800156 // Similar to the platform implementation of isLayoutValid();
157 protected boolean mIsLayoutValid;
158
Vadim Tryshev528b9e02018-05-24 18:22:03 -0700159 private int[] mTmpIntPair = new int[2];
160
Sunny Goyalc39db732021-04-03 01:20:21 -0700161 protected EdgeEffectCompat mEdgeGlowLeft;
162 protected EdgeEffectCompat mEdgeGlowRight;
163
Winson Chung321e9ee2010-08-09 13:37:56 -0700164 public PagedView(Context context) {
165 this(context, null);
166 }
167
168 public PagedView(Context context, AttributeSet attrs) {
169 this(context, attrs, 0);
170 }
171
172 public PagedView(Context context, AttributeSet attrs, int defStyle) {
173 super(context, attrs, defStyle);
Winson Chungc9ca2982013-07-19 12:07:38 -0700174
Adam Cohen9c4949e2010-10-05 12:27:22 -0700175 TypedArray a = context.obtainStyledAttributes(attrs,
176 R.styleable.PagedView, defStyle, 0);
Winson Chungd2be3812013-07-16 11:11:32 -0700177 mPageIndicatorViewId = a.getResourceId(R.styleable.PagedView_pageIndicator, -1);
Adam Cohen9c4949e2010-10-05 12:27:22 -0700178 a.recycle();
179
Winson Chung321e9ee2010-08-09 13:37:56 -0700180 setHapticFeedbackEnabled(false);
Sunny Goyal70660032015-05-14 00:07:08 -0700181 mIsRtl = Utilities.isRtl(getResources());
Winson Chung321e9ee2010-08-09 13:37:56 -0700182
Sunny Goyalc39db732021-04-03 01:20:21 -0700183 mScroller = new OverScroller(context, SCROLL);
Winson Chung86f77532010-08-24 11:08:22 -0700184 mCurrentPage = 0;
Lais Andradecc5c8842021-06-04 18:20:30 +0100185 mCurrentScrollOverPage = 0;
Winson Chung321e9ee2010-08-09 13:37:56 -0700186
Vinit Nayaka406f722019-12-19 11:50:55 -0800187 final ViewConfiguration configuration = ViewConfiguration.get(context);
Winson Chung4941f652020-06-18 15:11:53 -0700188 mTouchSlop = configuration.getScaledTouchSlop();
189 mPageSlop = configuration.getScaledPagingTouchSlop();
Winson Chung321e9ee2010-08-09 13:37:56 -0700190 mMaximumVelocity = configuration.getScaledMaximumFlingVelocity();
Adam Cohen265b9a62011-12-07 14:37:18 -0800191
Sunny Goyalcf25b522015-07-09 00:01:18 -0700192 float density = getResources().getDisplayMetrics().density;
193 mFlingThresholdVelocity = (int) (FLING_THRESHOLD_VELOCITY * density);
Winson Chung4941f652020-06-18 15:11:53 -0700194 mEasyFlingThresholdVelocity = (int) (EASY_FLING_THRESHOLD_VELOCITY * density);
Sunny Goyalcf25b522015-07-09 00:01:18 -0700195 mMinFlingVelocity = (int) (MIN_FLING_VELOCITY * density);
196 mMinSnapVelocity = (int) (MIN_SNAP_VELOCITY * density);
Sunny Goyala9f55462018-03-25 18:15:15 -0700197
Sunny Goyalc39db732021-04-03 01:20:21 -0700198 initEdgeEffect();
Sunny Goyaleaf7a952020-07-29 16:54:20 -0700199 setDefaultFocusHighlightEnabled(false);
Sunny Goyalc39db732021-04-03 01:20:21 -0700200 setWillNotDraw(false);
Winson Chung321e9ee2010-08-09 13:37:56 -0700201 }
202
Sunny Goyalc39db732021-04-03 01:20:21 -0700203 protected void initEdgeEffect() {
204 mEdgeGlowLeft = new EdgeEffectCompat(getContext());
205 mEdgeGlowRight = new EdgeEffectCompat(getContext());
Adam Cohenf9618852013-11-08 06:45:03 -0800206 }
207
Sunny Goyald0a6ae72016-06-16 12:29:03 -0700208 public void initParentViews(View parent) {
209 if (mPageIndicatorViewId > -1) {
Sunny Goyal0bd7f4f2018-02-01 09:53:35 -0800210 mPageIndicator = parent.findViewById(mPageIndicatorViewId);
Sunny Goyalc64cfdd2016-05-18 14:12:02 -0700211 mPageIndicator.setMarkersCount(getChildCount());
Winson Chungd2be3812013-07-16 11:11:32 -0700212 }
213 }
214
Sunny Goyal0bd7f4f2018-02-01 09:53:35 -0800215 public T getPageIndicator() {
Adam Cohenedb40762013-07-18 16:45:45 -0700216 return mPageIndicator;
217 }
218
Adam Cohen674531f2013-12-13 15:07:14 -0800219 /**
Tony Wickham29d853c2015-09-08 10:35:56 -0700220 * Returns the index of the currently displayed page. When in free scroll mode, this is the page
221 * that the user was on before entering free scroll mode (e.g. the home screen page they
Alex Chaub794ea62021-02-03 18:00:30 +0000222 * long-pressed on to enter the overview). Try using {@link #getDestinationPage()}
Tony Wickham29d853c2015-09-08 10:35:56 -0700223 * to get the page the user is currently scrolling over.
Winson Chung321e9ee2010-08-09 13:37:56 -0700224 */
Sunny Goyal83a8f042015-05-19 12:52:12 -0700225 public int getCurrentPage() {
Winson Chung86f77532010-08-24 11:08:22 -0700226 return mCurrentPage;
Winson Chung321e9ee2010-08-09 13:37:56 -0700227 }
Adam Cohen7d30a372013-07-01 17:03:59 -0700228
Hyunyoung Songb76cd622015-04-16 14:34:09 -0700229 /**
230 * Returns the index of page to be shown immediately afterwards.
231 */
Vadim Tryshevfedca432015-08-19 17:55:02 -0700232 public int getNextPage() {
Winson Chung360e63f2012-04-27 13:48:05 -0700233 return (mNextPage != INVALID_PAGE) ? mNextPage : mCurrentPage;
234 }
Winson Chung321e9ee2010-08-09 13:37:56 -0700235
Adam Cohenf9c184a2016-01-15 16:47:43 -0800236 public int getPageCount() {
Winson Chung321e9ee2010-08-09 13:37:56 -0700237 return getChildCount();
238 }
239
Sunny Goyal83a8f042015-05-19 12:52:12 -0700240 public View getPageAt(int index) {
Winson Chung321e9ee2010-08-09 13:37:56 -0700241 return getChildAt(index);
242 }
243
Winson Chung321e9ee2010-08-09 13:37:56 -0700244 /**
Winson Chungbbc60d82010-11-11 16:34:41 -0800245 * Updates the scroll of the current page immediately to its final scroll position. We use this
246 * in CustomizePagedView to allow tabs to share the same PagedView while resetting the scroll of
247 * the previous tab page.
248 */
249 protected void updateCurrentPageScroll() {
Adam Cohen0ffac432013-07-10 11:19:26 -0700250 // If the current page is invalid, just reset the scroll position to zero
Vinit Nayaka406f722019-12-19 11:50:55 -0800251 int newPosition = 0;
Adam Cohen0ffac432013-07-10 11:19:26 -0700252 if (0 <= mCurrentPage && mCurrentPage < getPageCount()) {
Alex Chauba61b982021-06-15 16:29:19 +0100253 newPosition = getScrollForPage(mCurrentPage) + mCurrentPageScrollDiff;
Adam Cohen0ffac432013-07-10 11:19:26 -0700254 }
Vinit Nayaka406f722019-12-19 11:50:55 -0800255 mOrientationHandler.set(this, VIEW_SCROLL_TO, newPosition);
Sunny Goyalc39db732021-04-03 01:20:21 -0700256 mScroller.startScroll(mScroller.getCurrX(), 0, newPosition - mScroller.getCurrX(), 0);
Tony Wickhamd5521322021-09-14 14:26:50 -0700257 forceFinishScroller();
Winson Chungbbc60d82010-11-11 16:34:41 -0800258 }
259
Tony Wickhamf8d731a2021-05-26 14:58:13 -0700260 /**
261 * Immediately finishes any overscroll effect and jumps to the end of the scroller animation.
262 */
263 public void abortScrollerAnimation() {
264 mEdgeGlowLeft.finish();
265 mEdgeGlowRight.finish();
266 abortScrollerAnimation(true);
267 }
268
Adam Cohen8bdbaab2013-10-29 15:25:02 -0700269 private void abortScrollerAnimation(boolean resetNextPage) {
Adam Cohen4fe4c932013-10-28 16:02:34 -0700270 mScroller.abortAnimation();
271 // We need to clean up the next page here to avoid computeScrollHelper from
272 // updating current page on the pass.
Adam Cohen8bdbaab2013-10-29 15:25:02 -0700273 if (resetNextPage) {
274 mNextPage = INVALID_PAGE;
Sunny Goyal857b1b92018-03-05 10:49:05 -0800275 pageEndTransition();
Adam Cohen8bdbaab2013-10-29 15:25:02 -0700276 }
Chet Haasebc2f0822012-10-26 17:59:53 -0700277 }
Adam Cohen4fe4c932013-10-28 16:02:34 -0700278
Tony Wickhamd5521322021-09-14 14:26:50 -0700279 /**
280 * Immediately finishes any in-progress scroll, maintaining the current position. Also sets
281 * mNextPage = INVALID_PAGE and calls pageEndTransition().
282 */
283 public void forceFinishScroller() {
Adam Cohen4fe4c932013-10-28 16:02:34 -0700284 mScroller.forceFinished(true);
285 // We need to clean up the next page here to avoid computeScrollHelper from
286 // updating current page on the pass.
Tony Wickhamd5521322021-09-14 14:26:50 -0700287 mNextPage = INVALID_PAGE;
288 pageEndTransition();
Adam Cohen4fe4c932013-10-28 16:02:34 -0700289 }
290
Adam Cohen6f127a62014-06-12 14:54:41 -0700291 private int validateNewPage(int newPage) {
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700292 newPage = ensureWithinScrollBounds(newPage);
Adam Cohen6f127a62014-06-12 14:54:41 -0700293 // Ensure that it is clamped by the actual set of children in all cases
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100294 newPage = Utilities.boundToRange(newPage, 0, getPageCount() - 1);
295
296 if (getPanelCount() > 1) {
Alex Chau1e448462021-08-13 21:48:35 +0100297 // Always return left most panel as new page
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100298 newPage = getLeftmostVisiblePageForIndex(newPage);
299 }
300 return newPage;
301 }
302
Andras Kloczl55edfe52021-05-14 12:21:30 +0200303 /**
304 * In most cases where panelCount is 1, this method will just return the page index that was
305 * passed in.
306 * But for example when two panel home is enabled we might need the leftmost visible page index
307 * because that page is the current page.
308 */
309 public int getLeftmostVisiblePageForIndex(int pageIndex) {
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100310 int panelCount = getPanelCount();
Andras Kloczl55edfe52021-05-14 12:21:30 +0200311 return pageIndex - pageIndex % panelCount;
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100312 }
313
314 /**
315 * Returns the number of pages that are shown at the same time.
316 */
317 protected int getPanelCount() {
318 return 1;
319 }
320
321 /**
Andras Kloczl55edfe52021-05-14 12:21:30 +0200322 * Returns an IntSet with the indices of the currently visible pages
323 */
324 @VisibleForTesting(otherwise = PACKAGE_PRIVATE)
325 public IntSet getVisiblePageIndices() {
Andras Kloczl7e912442021-05-06 12:50:28 +0200326 return getPageIndices(mCurrentPage);
327 }
328
329 /**
330 * In case the panelCount is 1 this just returns the same page index in an IntSet.
331 * But in cases where the panelCount > 1 this will return all the page indices that belong
332 * together, i.e. on the Workspace they are next to each other and shown at the same time.
333 */
334 private IntSet getPageIndices(int pageIndex) {
335 // we want to make sure the pageIndex is the leftmost page
336 pageIndex = getLeftmostVisiblePageForIndex(pageIndex);
337
338 IntSet pageIndices = new IntSet();
Andras Kloczl55edfe52021-05-14 12:21:30 +0200339 int panelCount = getPanelCount();
340 int pageCount = getPageCount();
Andras Kloczl7e912442021-05-06 12:50:28 +0200341 for (int page = pageIndex; page < pageIndex + panelCount && page < pageCount; page++) {
342 pageIndices.add(page);
Andras Kloczl55edfe52021-05-14 12:21:30 +0200343 }
Andras Kloczl7e912442021-05-06 12:50:28 +0200344 return pageIndices;
345 }
346
347 /**
348 * Returns an IntSet with the indices of the neighbour pages that are in the focus direction.
349 */
350 private IntSet getNeighbourPageIndices(int focus) {
351 int panelCount = getPanelCount();
352 // getNextPage is more reliable than getCurrentPage
353 int currentPage = getNextPage();
354
355 int nextPage;
356 if (focus == View.FOCUS_LEFT) {
357 nextPage = currentPage - panelCount;
358 } else if (focus == View.FOCUS_RIGHT) {
359 nextPage = currentPage + panelCount;
360 } else {
Andras Kloczlb0632942021-08-03 14:03:58 +0200361 // no neighbours to other directions
Andras Kloczl7e912442021-05-06 12:50:28 +0200362 return new IntSet();
363 }
364 nextPage = validateNewPage(nextPage);
365 if (nextPage == currentPage) {
366 // We reached the end of the pages
367 return new IntSet();
368 }
369
Andras Kloczlb0632942021-08-03 14:03:58 +0200370 return getPageIndices(nextPage);
Andras Kloczl55edfe52021-05-14 12:21:30 +0200371 }
372
373 /**
Sunny Goyal59969372021-05-06 12:11:44 -0700374 * Executes the callback against each visible page
Andras Kloczl2bb51342021-03-20 01:13:45 +0100375 */
Sunny Goyal59969372021-05-06 12:11:44 -0700376 public void forEachVisiblePage(Consumer<View> callback) {
Andras Kloczl55edfe52021-05-14 12:21:30 +0200377 getVisiblePageIndices().forEach(pageIndex -> {
378 View page = getPageAt(pageIndex);
Andras Kloczl2bb51342021-03-20 01:13:45 +0100379 if (page != null) {
Sunny Goyal59969372021-05-06 12:11:44 -0700380 callback.accept(page);
Andras Kloczl2bb51342021-03-20 01:13:45 +0100381 }
Andras Kloczl55edfe52021-05-14 12:21:30 +0200382 });
Andras Kloczl2bb51342021-03-20 01:13:45 +0100383 }
384
385 /**
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100386 * Returns true if the view is on one of the current pages, false otherwise.
387 */
388 public boolean isVisible(View child) {
Andras Kloczl7e912442021-05-06 12:50:28 +0200389 return isVisible(indexOfChild(child));
390 }
391
392 /**
393 * Returns true if the page with the given index is currently visible, false otherwise.
394 */
395 private boolean isVisible(int pageIndex) {
396 return getLeftmostVisiblePageForIndex(pageIndex) == mCurrentPage;
Adam Cohen6f127a62014-06-12 14:54:41 -0700397 }
398
Chet Haasebc2f0822012-10-26 17:59:53 -0700399 /**
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700400 * @return The closest page to the provided page that is within mMinScrollX and mMaxScrollX.
401 */
402 private int ensureWithinScrollBounds(int page) {
403 int dir = !mIsRtl ? 1 : - 1;
404 int currScroll = getScrollForPage(page);
405 int prevScroll;
Vinit Nayaka406f722019-12-19 11:50:55 -0800406 while (currScroll < mMinScroll) {
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700407 page += dir;
408 prevScroll = currScroll;
409 currScroll = getScrollForPage(page);
410 if (currScroll <= prevScroll) {
411 Log.e(TAG, "validateNewPage: failed to find a page > mMinScrollX");
412 break;
413 }
414 }
Vinit Nayaka406f722019-12-19 11:50:55 -0800415 while (currScroll > mMaxScroll) {
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700416 page -= dir;
417 prevScroll = currScroll;
418 currScroll = getScrollForPage(page);
419 if (currScroll >= prevScroll) {
420 Log.e(TAG, "validateNewPage: failed to find a page < mMaxScrollX");
421 break;
422 }
423 }
424 return page;
425 }
426
Tony Wickham03f27012019-04-25 14:22:54 -0700427 public void setCurrentPage(int currentPage) {
428 setCurrentPage(currentPage, INVALID_PAGE);
429 }
430
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700431 /**
Winson Chung86f77532010-08-24 11:08:22 -0700432 * Sets the current page.
Winson Chung321e9ee2010-08-09 13:37:56 -0700433 */
Tony Wickham03f27012019-04-25 14:22:54 -0700434 public void setCurrentPage(int currentPage, int overridePrevPage) {
Patrick Dubroy72e0d342010-11-09 15:23:28 -0800435 if (!mScroller.isFinished()) {
Adam Cohen8bdbaab2013-10-29 15:25:02 -0700436 abortScrollerAnimation(true);
Patrick Dubroy72e0d342010-11-09 15:23:28 -0800437 }
Michael Jurkad3ef3062010-11-23 16:23:58 -0800438 // don't introduce any checks like mCurrentPage == currentPage here-- if we change the
439 // the default
440 if (getChildCount() == 0) {
Patrick Dubroy72e0d342010-11-09 15:23:28 -0800441 return;
442 }
Tony Wickham03f27012019-04-25 14:22:54 -0700443 int prevPage = overridePrevPage != INVALID_PAGE ? overridePrevPage : mCurrentPage;
Adam Cohen6f127a62014-06-12 14:54:41 -0700444 mCurrentPage = validateNewPage(currentPage);
Lais Andradecc5c8842021-06-04 18:20:30 +0100445 mCurrentScrollOverPage = mCurrentPage;
Winson Chung181c3dc2013-07-17 15:36:20 -0700446 updateCurrentPageScroll();
Hyunyoung Song3f5a11f2017-06-29 16:42:04 -0700447 notifyPageSwitchListener(prevPage);
Winson Chunga12a2502010-12-20 14:41:35 -0800448 invalidate();
Winson Chung321e9ee2010-08-09 13:37:56 -0700449 }
450
Winson Chung8c87cd82013-07-23 16:20:10 -0700451 /**
Adam Cohen674531f2013-12-13 15:07:14 -0800452 * Should be called whenever the page changes. In the case of a scroll, we wait until the page
453 * has settled.
454 */
Hyunyoung Song3f5a11f2017-06-29 16:42:04 -0700455 protected void notifyPageSwitchListener(int prevPage) {
Adam Cohen674531f2013-12-13 15:07:14 -0800456 updatePageIndicator();
457 }
458
459 private void updatePageIndicator() {
Sunny Goyal4cbf0462014-08-28 16:19:39 -0700460 if (mPageIndicator != null) {
Tony Mak4f521af2018-03-15 16:37:34 +0000461 mPageIndicator.setActiveMarker(getNextPage());
Winson Chungd2be3812013-07-16 11:11:32 -0700462 }
Winson Chung321e9ee2010-08-09 13:37:56 -0700463 }
Sunny Goyal9ccafbf2016-10-26 13:06:08 -0700464 protected void pageBeginTransition() {
465 if (!mIsPageInTransition) {
466 mIsPageInTransition = true;
467 onPageBeginTransition();
Michael Jurkad74c9842011-07-10 12:44:21 -0700468 }
Patrick Dubroy1262e362010-10-06 15:49:50 -0700469 }
470
Sunny Goyal9ccafbf2016-10-26 13:06:08 -0700471 protected void pageEndTransition() {
Sunny Goyal05b59c02021-04-29 13:55:40 -0700472 if (mIsPageInTransition && !mIsBeingDragged && mScroller.isFinished()
Sunny Goyalb745a2a2021-04-30 13:38:22 -0700473 && (!isShown() || (mEdgeGlowLeft.isFinished() && mEdgeGlowRight.isFinished()))) {
Sunny Goyal9ccafbf2016-10-26 13:06:08 -0700474 mIsPageInTransition = false;
475 onPageEndTransition();
Michael Jurkad74c9842011-07-10 12:44:21 -0700476 }
Michael Jurka0142d492010-08-25 17:46:15 -0700477 }
478
Sunny Goyalb745a2a2021-04-30 13:38:22 -0700479 @Override
480 public void onVisibilityAggregated(boolean isVisible) {
481 pageEndTransition();
482 super.onVisibilityAggregated(isVisible);
483 }
484
Sunny Goyal9ccafbf2016-10-26 13:06:08 -0700485 protected boolean isPageInTransition() {
486 return mIsPageInTransition;
Adam Cohen26976d92011-03-22 15:33:33 -0700487 }
488
Sunny Goyal9ccafbf2016-10-26 13:06:08 -0700489 /**
490 * Called when the page starts moving as part of the scroll. Subclasses can override this
491 * to provide custom behavior during animation.
492 */
493 protected void onPageBeginTransition() {
Patrick Dubroy1262e362010-10-06 15:49:50 -0700494 }
495
Sunny Goyal9ccafbf2016-10-26 13:06:08 -0700496 /**
497 * Called when the page ends moving as part of the scroll. Subclasses can override this
498 * to provide custom behavior during animation.
499 */
500 protected void onPageEndTransition() {
Alex Chauba61b982021-06-15 16:29:19 +0100501 mCurrentPageScrollDiff = 0;
vadimt4d93df52019-07-10 17:32:58 -0700502 AccessibilityManagerCompat.sendScrollFinishedEventToTest(getContext());
Tony Wickham619daaf2020-02-07 12:29:06 -0800503 AccessibilityManagerCompat.sendCustomAccessibilityEvent(getPageAt(mCurrentPage),
504 AccessibilityEvent.TYPE_VIEW_FOCUSED, null);
Tony Wickham62117d72020-03-26 16:56:26 -0700505 if (mOnPageTransitionEndCallback != null) {
506 mOnPageTransitionEndCallback.run();
507 mOnPageTransitionEndCallback = null;
508 }
509 }
510
511 /**
512 * Sets a callback to run once when the scrolling finishes. If there is currently
513 * no page in transition, then the callback is called immediately.
514 */
515 public void setOnPageTransitionEndCallback(@Nullable Runnable callback) {
516 if (mIsPageInTransition || callback == null) {
517 mOnPageTransitionEndCallback = callback;
518 } else {
519 callback.run();
520 }
Michael Jurka0142d492010-08-25 17:46:15 -0700521 }
522
Adam Cohen68d73932010-11-15 10:50:58 -0800523 @Override
Michael Jurka0142d492010-08-25 17:46:15 -0700524 public void scrollTo(int x, int y) {
Sunny Goyalc39db732021-04-03 01:20:21 -0700525 x = Utilities.boundToRange(x,
526 mOrientationHandler.getPrimaryValue(mMinScroll, 0), mMaxScroll);
527 y = Utilities.boundToRange(y,
528 mOrientationHandler.getPrimaryValue(0, mMinScroll), mMaxScroll);
Vinit Nayaka406f722019-12-19 11:50:55 -0800529 super.scrollTo(x, y);
Michael Jurka0142d492010-08-25 17:46:15 -0700530 }
531
Adam Cohen53805212013-10-01 10:39:23 -0700532 private void sendScrollAccessibilityEvent() {
Sunny Goyald0030b02017-12-08 15:07:24 -0800533 if (isObservedEventType(getContext(), AccessibilityEvent.TYPE_VIEW_SCROLLED)) {
Vadim Tryshevf4715972015-05-08 17:21:03 -0700534 if (mCurrentPage != getNextPage()) {
535 AccessibilityEvent ev =
536 AccessibilityEvent.obtain(AccessibilityEvent.TYPE_VIEW_SCROLLED);
Vadim Tryshev7066c122015-05-21 14:06:35 -0700537 ev.setScrollable(true);
538 ev.setScrollX(getScrollX());
539 ev.setScrollY(getScrollY());
Vinit Nayaka406f722019-12-19 11:50:55 -0800540 mOrientationHandler.setMaxScroll(ev, mMaxScroll);
Vadim Tryshevf4715972015-05-08 17:21:03 -0700541 sendAccessibilityEventUnchecked(ev);
Adam Cohen53805212013-10-01 10:39:23 -0700542 }
Adam Cohen53805212013-10-01 10:39:23 -0700543 }
544 }
545
Vadim Tryshev2c430b32018-04-04 14:45:21 -0700546 protected void announcePageForAccessibility() {
547 if (isAccessibilityEnabled(getContext())) {
548 // Notify the user when the page changes
549 announceForAccessibility(getCurrentPageDescription());
550 }
551 }
552
Winson Chung85425412021-05-10 16:24:14 -0700553 protected boolean computeScrollHelper() {
Winson Chung321e9ee2010-08-09 13:37:56 -0700554 if (mScroller.computeScrollOffset()) {
Winson Chung557d6ed2011-07-08 15:34:52 -0700555 // Don't bother scrolling if the page does not need to be moved
Sunny Goyalc39db732021-04-03 01:20:21 -0700556 int oldPos = mOrientationHandler.getPrimaryScroll(this);
557 int newPos = mScroller.getCurrX();
558 if (oldPos != newPos) {
559 mOrientationHandler.set(this, VIEW_SCROLL_TO, mScroller.getCurrX());
Winson Chung557d6ed2011-07-08 15:34:52 -0700560 }
Winson Chung85425412021-05-10 16:24:14 -0700561
562 if (mAllowOverScroll) {
563 if (newPos < mMinScroll && oldPos >= mMinScroll) {
564 mEdgeGlowLeft.onAbsorb((int) mScroller.getCurrVelocity());
565 mScroller.abortAnimation();
Lais Andradecc5c8842021-06-04 18:20:30 +0100566 onEdgeAbsorbingScroll();
Winson Chung85425412021-05-10 16:24:14 -0700567 } else if (newPos > mMaxScroll && oldPos <= mMaxScroll) {
568 mEdgeGlowRight.onAbsorb((int) mScroller.getCurrVelocity());
569 mScroller.abortAnimation();
Lais Andradecc5c8842021-06-04 18:20:30 +0100570 onEdgeAbsorbingScroll();
Sunny Goyalc39db732021-04-03 01:20:21 -0700571 }
Tony Wickham95cdb3a2016-02-18 14:37:07 -0800572 }
Adam Cohen53805212013-10-01 10:39:23 -0700573
Winson Chung85425412021-05-10 16:24:14 -0700574 // If the scroller has scrolled to the final position and there is no edge effect, then
575 // finish the scroller to skip waiting for additional settling
576 int finalPos = mOrientationHandler.getPrimaryValue(mScroller.getFinalX(),
577 mScroller.getFinalY());
578 if (newPos == finalPos && mEdgeGlowLeft.isFinished() && mEdgeGlowRight.isFinished()) {
579 mScroller.abortAnimation();
580 }
581
582 invalidate();
583 return true;
584 } else if (mNextPage != INVALID_PAGE) {
585 sendScrollAccessibilityEvent();
Hyunyoung Song3f5a11f2017-06-29 16:42:04 -0700586 int prevPage = mCurrentPage;
Adam Cohen6f127a62014-06-12 14:54:41 -0700587 mCurrentPage = validateNewPage(mNextPage);
Lais Andradecc5c8842021-06-04 18:20:30 +0100588 mCurrentScrollOverPage = mCurrentPage;
Winson Chung86f77532010-08-24 11:08:22 -0700589 mNextPage = INVALID_PAGE;
Hyunyoung Song3f5a11f2017-06-29 16:42:04 -0700590 notifyPageSwitchListener(prevPage);
Winson Chungb44b5242011-06-13 11:32:14 -0700591
Adam Cohen73aa9752010-11-24 16:26:58 -0800592 // We don't want to trigger a page end moving unless the page has settled
593 // and the user has stopped scrolling
Sunny Goyalaad33592018-08-07 17:20:35 -0700594 if (!mIsBeingDragged) {
Sunny Goyal9ccafbf2016-10-26 13:06:08 -0700595 pageEndTransition();
Adam Cohen73aa9752010-11-24 16:26:58 -0800596 }
Winson Chungc27d1bb2011-09-29 12:07:42 -0700597
Vadim Tryshev2c430b32018-04-04 14:45:21 -0700598 if (canAnnouncePageDescription()) {
599 announcePageForAccessibility();
Adam Cohen0ffac432013-07-10 11:19:26 -0700600 }
Winson Chung321e9ee2010-08-09 13:37:56 -0700601 }
Michael Jurka0142d492010-08-25 17:46:15 -0700602 return false;
603 }
604
605 @Override
606 public void computeScroll() {
607 computeScrollHelper();
Winson Chung321e9ee2010-08-09 13:37:56 -0700608 }
609
Sunny Goyalce8809a2018-01-18 14:02:47 -0800610 public int getExpectedHeight() {
611 return getMeasuredHeight();
612 }
613
Adam Cohen410f3cd2013-09-22 12:09:32 -0700614 public int getNormalChildHeight() {
Sunny Goyalce8809a2018-01-18 14:02:47 -0800615 return getExpectedHeight() - getPaddingTop() - getPaddingBottom()
Sunny Goyalac00cba2017-11-13 15:58:01 -0800616 - mInsets.top - mInsets.bottom;
Adam Cohen410f3cd2013-09-22 12:09:32 -0700617 }
618
Sunny Goyalce8809a2018-01-18 14:02:47 -0800619 public int getExpectedWidth() {
620 return getMeasuredWidth();
621 }
622
Sunny Goyalbc683e92017-12-06 10:25:07 -0800623 public int getNormalChildWidth() {
Sunny Goyalce8809a2018-01-18 14:02:47 -0800624 return getExpectedWidth() - getPaddingLeft() - getPaddingRight()
Sunny Goyalbc683e92017-12-06 10:25:07 -0800625 - mInsets.left - mInsets.right;
626 }
627
Winson Chung321e9ee2010-08-09 13:37:56 -0700628 @Override
Sunny Goyal85a7fe02018-02-02 10:09:32 -0800629 public void requestLayout() {
630 mIsLayoutValid = false;
631 super.requestLayout();
632 }
633
634 @Override
635 public void forceLayout() {
636 mIsLayoutValid = false;
637 super.forceLayout();
638 }
639
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100640 private int getPageWidthSize(int widthSize) {
641 return (widthSize - mInsets.left - mInsets.right) / getPanelCount();
642 }
643
Sunny Goyal85a7fe02018-02-02 10:09:32 -0800644 @Override
Winson Chung321e9ee2010-08-09 13:37:56 -0700645 protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
Sunny Goyal8e2133b2015-05-06 13:39:07 -0700646 if (getChildCount() == 0) {
Winson Chungf0ea4d32011-06-06 14:27:16 -0700647 super.onMeasure(widthMeasureSpec, heightMeasureSpec);
648 return;
649 }
650
Adam Cohen7d30a372013-07-01 17:03:59 -0700651 // We measure the dimensions of the PagedView to be larger than the pages so that when we
652 // zoom out (and scale down), the view is still contained in the parent
Adam Cohen7d30a372013-07-01 17:03:59 -0700653 int widthMode = MeasureSpec.getMode(widthMeasureSpec);
654 int widthSize = MeasureSpec.getSize(widthMeasureSpec);
655 int heightMode = MeasureSpec.getMode(heightMeasureSpec);
Winson Chung8aad6102012-05-11 16:27:49 -0700656 int heightSize = MeasureSpec.getSize(heightMeasureSpec);
Adam Cohen410f3cd2013-09-22 12:09:32 -0700657
Adam Cohen7d30a372013-07-01 17:03:59 -0700658 if (widthMode == MeasureSpec.UNSPECIFIED || heightMode == MeasureSpec.UNSPECIFIED) {
659 super.onMeasure(widthMeasureSpec, heightMeasureSpec);
660 return;
Winson Chung321e9ee2010-08-09 13:37:56 -0700661 }
662
Winson Chung8aad6102012-05-11 16:27:49 -0700663 // Return early if we aren't given a proper dimension
664 if (widthSize <= 0 || heightSize <= 0) {
665 super.onMeasure(widthMeasureSpec, heightMeasureSpec);
666 return;
667 }
668
Winson Chung321e9ee2010-08-09 13:37:56 -0700669 // The children are given the same width and height as the workspace
Michael Jurka5f1c5092010-09-03 14:15:02 -0700670 // unless they were set to WRAP_CONTENT
Winson Chung785d2eb2011-04-14 16:08:02 -0700671 if (DEBUG) Log.d(TAG, "PagedView.onMeasure(): " + widthSize + ", " + heightSize);
Michael Jurka5f1c5092010-09-03 14:15:02 -0700672
Sunny Goyalac00cba2017-11-13 15:58:01 -0800673 int myWidthSpec = MeasureSpec.makeMeasureSpec(
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100674 getPageWidthSize(widthSize), MeasureSpec.EXACTLY);
Sunny Goyalac00cba2017-11-13 15:58:01 -0800675 int myHeightSpec = MeasureSpec.makeMeasureSpec(
Sunny Goyal228153d2018-01-04 15:35:22 -0800676 heightSize - mInsets.top - mInsets.bottom, MeasureSpec.EXACTLY);
Adam Cohen96d30a12013-07-16 18:13:21 -0700677
Sunny Goyalac00cba2017-11-13 15:58:01 -0800678 // measureChildren takes accounts for content padding, we only need to care about extra
679 // space due to insets.
680 measureChildren(myWidthSpec, myHeightSpec);
681 setMeasuredDimension(widthSize, heightSize);
Adam Cohen60b07122011-11-14 17:26:06 -0800682 }
683
Sunny Goyalcf25b522015-07-09 00:01:18 -0700684 @SuppressLint("DrawAllocation")
Winson Chung321e9ee2010-08-09 13:37:56 -0700685 @Override
Michael Jurka28750fb2010-09-24 17:43:49 -0700686 protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
Sunny Goyal85a7fe02018-02-02 10:09:32 -0800687 mIsLayoutValid = true;
Vadim Trysheveb701c62018-05-14 16:00:15 -0700688 final int childCount = getChildCount();
689 boolean pageScrollChanged = false;
690 if (mPageScrolls == null || childCount != mPageScrolls.length) {
691 mPageScrolls = new int[childCount];
692 pageScrollChanged = true;
693 }
694
695 if (childCount == 0) {
Winson Chungf0ea4d32011-06-06 14:27:16 -0700696 return;
697 }
698
Winson Chung785d2eb2011-04-14 16:08:02 -0700699 if (DEBUG) Log.d(TAG, "PagedView.onLayout()");
Winson Chung321e9ee2010-08-09 13:37:56 -0700700
Vinit Nayaka406f722019-12-19 11:50:55 -0800701 boolean isScrollChanged = getPageScrolls(mPageScrolls, true, SIMPLE_SCROLL_LOGIC);
702 if (isScrollChanged) {
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700703 pageScrollChanged = true;
Winson Chung321e9ee2010-08-09 13:37:56 -0700704 }
Winson Chungc3665fa2011-09-14 17:56:27 -0700705
Sunny Goyal3e2ff8a2015-04-15 16:31:22 -0700706 final LayoutTransition transition = getLayoutTransition();
707 // If the transition is running defer updating max scroll, as some empty pages could
708 // still be present, and a max scroll change could cause sudden jumps in scroll.
709 if (transition != null && transition.isRunning()) {
710 transition.addTransitionListener(new LayoutTransition.TransitionListener() {
711
712 @Override
713 public void startTransition(LayoutTransition transition, ViewGroup container,
714 View view, int transitionType) { }
715
716 @Override
717 public void endTransition(LayoutTransition transition, ViewGroup container,
718 View view, int transitionType) {
719 // Wait until all transitions are complete.
720 if (!transition.isRunning()) {
721 transition.removeTransitionListener(this);
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700722 updateMinAndMaxScrollX();
Sunny Goyal3e2ff8a2015-04-15 16:31:22 -0700723 }
724 }
725 });
Adam Cohenf698c6e2013-07-17 18:44:25 -0700726 } else {
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700727 updateMinAndMaxScrollX();
Adam Cohenf698c6e2013-07-17 18:44:25 -0700728 }
729
Sunny Goyalcb037ee2015-07-08 16:41:21 -0700730 if (mFirstLayout && mCurrentPage >= 0 && mCurrentPage < childCount) {
731 updateCurrentPageScroll();
732 mFirstLayout = false;
733 }
734
Sunny Goyal85a7fe02018-02-02 10:09:32 -0800735 if (mScroller.isFinished() && pageScrollChanged) {
Sunny Goyalc82c6392018-06-06 15:39:13 -0700736 setCurrentPage(getNextPage());
Adam Cohenf698c6e2013-07-17 18:44:25 -0700737 }
Winson Chunge3193b92010-09-10 11:44:42 -0700738 }
739
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700740 /**
741 * Initializes {@code outPageScrolls} with scroll positions for view at that index. The length
742 * of {@code outPageScrolls} should be same as the the childCount
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700743 */
744 protected boolean getPageScrolls(int[] outPageScrolls, boolean layoutChildren,
745 ComputePageScrollsLogic scrollLogic) {
746 final int childCount = getChildCount();
747
748 final int startIndex = mIsRtl ? childCount - 1 : 0;
749 final int endIndex = mIsRtl ? -1 : childCount;
750 final int delta = mIsRtl ? -1 : 1;
751
Vinit Nayaka406f722019-12-19 11:50:55 -0800752 final int pageCenter = mOrientationHandler.getCenterForPage(this, mInsets);
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700753
Vinit Nayaka406f722019-12-19 11:50:55 -0800754 final int scrollOffsetStart = mOrientationHandler.getScrollOffsetStart(this, mInsets);
755 final int scrollOffsetEnd = mOrientationHandler.getScrollOffsetEnd(this, mInsets);
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700756 boolean pageScrollChanged = false;
Thales Limae4457742021-07-20 16:46:38 +0100757 int panelCount = getPanelCount();
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700758
Vinit Nayaka406f722019-12-19 11:50:55 -0800759 for (int i = startIndex, childStart = scrollOffsetStart; i != endIndex; i += delta) {
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700760 final View child = getPageAt(i);
761 if (scrollLogic.shouldIncludeView(child)) {
Vinit Nayaka406f722019-12-19 11:50:55 -0800762 ChildBounds bounds = mOrientationHandler.getChildBounds(child, childStart,
763 pageCenter, layoutChildren);
764 final int primaryDimension = bounds.primaryDimension;
765 final int childPrimaryEnd = bounds.childPrimaryEnd;
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700766
Alex Chaub5c4d112021-03-29 17:37:53 +0100767 // In case the pages are of different width, align the page to left edge for non-RTL
768 // or right edge for RTL.
769 final int pageScroll =
770 mIsRtl ? childPrimaryEnd - scrollOffsetEnd : childStart - scrollOffsetStart;
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700771 if (outPageScrolls[i] != pageScroll) {
772 pageScrollChanged = true;
773 outPageScrolls[i] = pageScroll;
774 }
Thales Limae4457742021-07-20 16:46:38 +0100775 childStart += primaryDimension + getChildGap();
776
777 // This makes sure that the space is added after the page, not after each panel
Thales Limac2a6f6f2021-09-09 17:06:22 +0100778 int lastPanel = mIsRtl ? 0 : panelCount - 1;
779 if (i % panelCount == lastPanel) {
Thales Limae4457742021-07-20 16:46:38 +0100780 childStart += mPageSpacing;
781 }
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700782 }
783 }
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100784
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100785 if (panelCount > 1) {
786 for (int i = 0; i < childCount; i++) {
Alex Chau1e448462021-08-13 21:48:35 +0100787 // In case we have multiple panels, always use left most panel's page scroll for all
Andras Kloczl8e57cce2021-02-11 23:51:19 +0100788 // panels on the screen.
789 int adjustedScroll = outPageScrolls[getLeftmostVisiblePageForIndex(i)];
790 if (outPageScrolls[i] != adjustedScroll) {
791 outPageScrolls[i] = adjustedScroll;
792 pageScrollChanged = true;
793 }
794 }
795 }
Sunny Goyal20a13ff2018-03-13 16:44:00 -0700796 return pageScrollChanged;
797 }
798
Sunny Goyala1fbd842015-05-20 13:40:27 -0700799 protected int getChildGap() {
800 return 0;
801 }
802
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700803 protected void updateMinAndMaxScrollX() {
Vinit Nayaka406f722019-12-19 11:50:55 -0800804 mMinScroll = computeMinScroll();
805 mMaxScroll = computeMaxScroll();
Tony Wickhamf549dab2016-05-16 09:54:06 -0700806 }
807
Vinit Nayaka406f722019-12-19 11:50:55 -0800808 protected int computeMinScroll() {
Tony Wickham66d1c2f2019-04-24 11:32:59 -0700809 return 0;
Tony50876bf2018-09-19 23:09:14 -0400810 }
811
Vinit Nayaka406f722019-12-19 11:50:55 -0800812 protected int computeMaxScroll() {
Sunny Goyal3e2ff8a2015-04-15 16:31:22 -0700813 int childCount = getChildCount();
814 if (childCount > 0) {
Sunny Goyal70660032015-05-14 00:07:08 -0700815 final int index = mIsRtl ? 0 : childCount - 1;
Tony Wickhamf549dab2016-05-16 09:54:06 -0700816 return getScrollForPage(index);
Sunny Goyal3e2ff8a2015-04-15 16:31:22 -0700817 } else {
Tony Wickhamf549dab2016-05-16 09:54:06 -0700818 return 0;
Sunny Goyal3e2ff8a2015-04-15 16:31:22 -0700819 }
820 }
821
Adam Cohen3b185e22013-10-29 14:45:58 -0700822 public void setPageSpacing(int pageSpacing) {
823 mPageSpacing = pageSpacing;
824 requestLayout();
825 }
826
Tony50876bf2018-09-19 23:09:14 -0400827 public int getPageSpacing() {
828 return mPageSpacing;
829 }
830
Sunny Goyal0bd7f4f2018-02-01 09:53:35 -0800831 private void dispatchPageCountChanged() {
832 if (mPageIndicator != null) {
833 mPageIndicator.setMarkersCount(getChildCount());
Winson Chungd2be3812013-07-16 11:11:32 -0700834 }
Adam Cohen2591f6a2011-10-25 14:36:40 -0700835 // This ensures that when children are added, they get the correct transforms / alphas
836 // in accordance with any scroll effects.
Adam Cohen2591f6a2011-10-25 14:36:40 -0700837 invalidate();
838 }
839
Michael Jurka8b805b12012-04-18 14:23:14 -0700840 @Override
Sunny Goyal0bd7f4f2018-02-01 09:53:35 -0800841 public void onViewAdded(View child) {
Winson Chungc7c51582018-02-23 17:58:36 -0800842 super.onViewAdded(child);
Sunny Goyal0bd7f4f2018-02-01 09:53:35 -0800843 dispatchPageCountChanged();
844 }
845
846 @Override
847 public void onViewRemoved(View child) {
Winson Chungc7c51582018-02-23 17:58:36 -0800848 super.onViewRemoved(child);
Tonya361c722017-07-04 09:43:06 -0700849 mCurrentPage = validateNewPage(mCurrentPage);
Lais Andradecc5c8842021-06-04 18:20:30 +0100850 mCurrentScrollOverPage = mCurrentPage;
Sunny Goyal0bd7f4f2018-02-01 09:53:35 -0800851 dispatchPageCountChanged();
Winson Chungd2be3812013-07-16 11:11:32 -0700852 }
853
Adam Cohen73894962011-10-31 13:17:17 -0700854 protected int getChildOffset(int index) {
Adam Cohen7d30a372013-07-01 17:03:59 -0700855 if (index < 0 || index > getChildCount() - 1) return 0;
Vinit Nayaka406f722019-12-19 11:50:55 -0800856 View pageAtIndex = getPageAt(index);
857 return mOrientationHandler.getChildStart(pageAtIndex);
Adam Cohen73894962011-10-31 13:17:17 -0700858 }
859
Alex Chau7944ee52021-01-08 19:07:25 +0000860 protected int getChildVisibleSize(int index) {
861 View layout = getPageAt(index);
862 return mOrientationHandler.getMeasuredSize(layout);
863 }
864
Winson Chung321e9ee2010-08-09 13:37:56 -0700865 @Override
866 public boolean requestChildRectangleOnScreen(View child, Rect rectangle, boolean immediate) {
Andras Kloczl7e912442021-05-06 12:50:28 +0200867 int page = indexOfChild(child);
868 if (!isVisible(page) || !mScroller.isFinished()) {
Vadim Trysheveeaa8ee2018-04-11 12:23:42 -0700869 if (immediate) {
870 setCurrentPage(page);
871 } else {
872 snapToPage(page);
873 }
Winson Chung321e9ee2010-08-09 13:37:56 -0700874 return true;
875 }
876 return false;
877 }
878
879 @Override
880 protected boolean onRequestFocusInDescendants(int direction, Rect previouslyFocusedRect) {
Winson Chung86f77532010-08-24 11:08:22 -0700881 int focusablePage;
882 if (mNextPage != INVALID_PAGE) {
883 focusablePage = mNextPage;
Winson Chung321e9ee2010-08-09 13:37:56 -0700884 } else {
Winson Chung86f77532010-08-24 11:08:22 -0700885 focusablePage = mCurrentPage;
Winson Chung321e9ee2010-08-09 13:37:56 -0700886 }
Winson Chung86f77532010-08-24 11:08:22 -0700887 View v = getPageAt(focusablePage);
Winson Chung321e9ee2010-08-09 13:37:56 -0700888 if (v != null) {
Adam Cohen76fc0852011-06-17 13:26:23 -0700889 return v.requestFocus(direction, previouslyFocusedRect);
Winson Chung321e9ee2010-08-09 13:37:56 -0700890 }
891 return false;
892 }
893
894 @Override
895 public boolean dispatchUnhandledMove(View focused, int direction) {
Sunny Goyal0c4e3722015-12-01 13:21:49 -0800896 if (super.dispatchUnhandledMove(focused, direction)) {
897 return true;
898 }
899
900 if (mIsRtl) {
901 if (direction == View.FOCUS_LEFT) {
902 direction = View.FOCUS_RIGHT;
903 } else if (direction == View.FOCUS_RIGHT) {
904 direction = View.FOCUS_LEFT;
905 }
906 }
Andras Kloczl7e912442021-05-06 12:50:28 +0200907
908 int currentPage = getNextPage();
909 int closestNeighbourIndex = -1;
910 int closestNeighbourDistance = Integer.MAX_VALUE;
911 // Find the closest neighbour page
912 for (int neighbourPageIndex : getNeighbourPageIndices(direction)) {
913 int distance = Math.abs(neighbourPageIndex - currentPage);
914 if (closestNeighbourDistance > distance) {
915 closestNeighbourDistance = distance;
916 closestNeighbourIndex = neighbourPageIndex;
Winson Chung321e9ee2010-08-09 13:37:56 -0700917 }
918 }
Andras Kloczl7e912442021-05-06 12:50:28 +0200919 if (closestNeighbourIndex != -1) {
920 View page = getPageAt(closestNeighbourIndex);
921 snapToPage(closestNeighbourIndex);
922 page.requestFocus(direction);
923 return true;
924 }
925
Sunny Goyal0c4e3722015-12-01 13:21:49 -0800926 return false;
Winson Chung321e9ee2010-08-09 13:37:56 -0700927 }
928
929 @Override
930 public void addFocusables(ArrayList<View> views, int direction, int focusableMode) {
Jon Miranda6a858172016-10-25 16:19:17 -0700931 if (getDescendantFocusability() == FOCUS_BLOCK_DESCENDANTS) {
932 return;
933 }
934
Andras Kloczl7e912442021-05-06 12:50:28 +0200935 // nextPage is more reliable when multiple control movements have been done in a short
936 // period of time
937 getPageIndices(getNextPage())
938 .addAll(getNeighbourPageIndices(direction))
939 .forEach(pageIndex ->
940 getPageAt(pageIndex).addFocusables(views, direction, focusableMode));
Winson Chung321e9ee2010-08-09 13:37:56 -0700941 }
942
943 /**
944 * If one of our descendant views decides that it could be focused now, only
Winson Chung86f77532010-08-24 11:08:22 -0700945 * pass that along if it's on the current page.
Winson Chung321e9ee2010-08-09 13:37:56 -0700946 *
Winson Chung86f77532010-08-24 11:08:22 -0700947 * This happens when live folders requery, and if they're off page, they
948 * end up calling requestFocus, which pulls it on page.
Winson Chung321e9ee2010-08-09 13:37:56 -0700949 */
950 @Override
951 public void focusableViewAvailable(View focused) {
Winson Chung86f77532010-08-24 11:08:22 -0700952 View current = getPageAt(mCurrentPage);
Winson Chung321e9ee2010-08-09 13:37:56 -0700953 View v = focused;
954 while (true) {
955 if (v == current) {
956 super.focusableViewAvailable(focused);
957 return;
958 }
959 if (v == this) {
960 return;
961 }
962 ViewParent parent = v.getParent();
963 if (parent instanceof View) {
964 v = (View)v.getParent();
965 } else {
966 return;
967 }
968 }
969 }
970
971 /**
972 * {@inheritDoc}
973 */
974 @Override
975 public void requestDisallowInterceptTouchEvent(boolean disallowIntercept) {
976 if (disallowIntercept) {
977 // We need to make sure to cancel our long press if
978 // a scrollable widget takes over touch events
Andras Kloczl7a1ca0b2021-04-08 16:08:16 +0200979 cancelCurrentPageLongPress();
Winson Chung321e9ee2010-08-09 13:37:56 -0700980 }
981 super.requestDisallowInterceptTouchEvent(disallowIntercept);
982 }
983
984 @Override
985 public boolean onInterceptTouchEvent(MotionEvent ev) {
986 /*
987 * This method JUST determines whether we want to intercept the motion.
988 * If we return true, onTouchEvent will be called and we do the actual
989 * scrolling there.
990 */
991
Winson Chung45e1d6e2010-11-09 17:19:49 -0800992 // Skip touch handling if there are no pages to swipe
Tony Wickhamb6841ac2019-07-22 12:39:59 -0700993 if (getChildCount() <= 0) return false;
Sunny Goyalc4bb3732019-06-20 11:34:14 -0700994
995 acquireVelocityTrackerAndAddMovement(ev);
Winson Chung45e1d6e2010-11-09 17:19:49 -0800996
Winson Chung321e9ee2010-08-09 13:37:56 -0700997 /*
998 * Shortcut the most recurring case: the user is in the dragging
999 * state and he is moving his finger. We want to intercept this
1000 * motion.
1001 */
1002 final int action = ev.getAction();
Sunny Goyalaad33592018-08-07 17:20:35 -07001003 if ((action == MotionEvent.ACTION_MOVE) && mIsBeingDragged) {
Winson Chung321e9ee2010-08-09 13:37:56 -07001004 return true;
1005 }
1006
Winson Chung321e9ee2010-08-09 13:37:56 -07001007 switch (action & MotionEvent.ACTION_MASK) {
1008 case MotionEvent.ACTION_MOVE: {
1009 /*
1010 * mIsBeingDragged == false, otherwise the shortcut would have caught it. Check
Vinit Nayaka406f722019-12-19 11:50:55 -08001011 * whether the user has moved far enough from their original down touch.
Winson Chung321e9ee2010-08-09 13:37:56 -07001012 */
Michael Jurka1ff706b2010-09-14 17:35:20 -07001013 if (mActivePointerId != INVALID_POINTER) {
1014 determineScrollingStart(ev);
Michael Jurka1ff706b2010-09-14 17:35:20 -07001015 }
1016 // if mActivePointerId is INVALID_POINTER, then we must have missed an ACTION_DOWN
Vinit Nayaka406f722019-12-19 11:50:55 -08001017 // event. in that case, treat the first occurrence of a move event as a ACTION_DOWN
Michael Jurka1ff706b2010-09-14 17:35:20 -07001018 // i.e. fall through to the next case (don't break)
1019 // (We sometimes miss ACTION_DOWN events in Workspace because it ignores all events
1020 // while it's small- this was causing a crash before we checked for INVALID_POINTER)
Adam Cohen93c97562013-09-26 13:48:01 -07001021 break;
Winson Chung321e9ee2010-08-09 13:37:56 -07001022 }
1023
1024 case MotionEvent.ACTION_DOWN: {
1025 final float x = ev.getX();
1026 final float y = ev.getY();
1027 // Remember location of down touch
1028 mDownMotionX = x;
Adam Cohen7d30a372013-07-01 17:03:59 -07001029 mDownMotionY = y;
Jon Mirandaf52af432020-04-10 17:25:57 -07001030 mDownMotionPrimary = mLastMotion = mOrientationHandler.getPrimaryDirection(ev, 0);
Vinit Nayaka406f722019-12-19 11:50:55 -08001031 mLastMotionRemainder = 0;
1032 mTotalMotion = 0;
Winson Chung4941f652020-06-18 15:11:53 -07001033 mAllowEasyFling = false;
Winson Chung321e9ee2010-08-09 13:37:56 -07001034 mActivePointerId = ev.getPointerId(0);
Sunny Goyalc39db732021-04-03 01:20:21 -07001035 updateIsBeingDraggedOnTouchDown(ev);
Winson Chung321e9ee2010-08-09 13:37:56 -07001036 break;
1037 }
1038
Winson Chung321e9ee2010-08-09 13:37:56 -07001039 case MotionEvent.ACTION_UP:
Jeff Brown1d0867c2010-12-02 18:27:39 -08001040 case MotionEvent.ACTION_CANCEL:
Adam Cohen7d30a372013-07-01 17:03:59 -07001041 resetTouchState();
Winson Chung321e9ee2010-08-09 13:37:56 -07001042 break;
1043
1044 case MotionEvent.ACTION_POINTER_UP:
1045 onSecondaryPointerUp(ev);
Adam Cohen6342bba2011-03-10 11:33:35 -08001046 releaseVelocityTracker();
Winson Chung321e9ee2010-08-09 13:37:56 -07001047 break;
1048 }
1049
1050 /*
1051 * The only time we want to intercept motion events is if we are in the
1052 * drag mode.
1053 */
Sunny Goyalaad33592018-08-07 17:20:35 -07001054 return mIsBeingDragged;
Winson Chung321e9ee2010-08-09 13:37:56 -07001055 }
1056
Tony Wickhama0aee212019-09-18 09:24:03 -07001057 /**
1058 * If being flinged and user touches the screen, initiate drag; otherwise don't.
1059 */
Sunny Goyalbb030562021-07-19 16:28:39 -07001060 protected void updateIsBeingDraggedOnTouchDown(MotionEvent ev) {
Tony Wickhama0aee212019-09-18 09:24:03 -07001061 // mScroller.isFinished should be false when being flinged.
Sunny Goyalc39db732021-04-03 01:20:21 -07001062 final int xDist = Math.abs(mScroller.getFinalX() - mScroller.getCurrX());
Winson Chung4941f652020-06-18 15:11:53 -07001063 final boolean finishedScrolling = (mScroller.isFinished() || xDist < mPageSlop / 3);
Tony Wickhama0aee212019-09-18 09:24:03 -07001064
1065 if (finishedScrolling) {
1066 mIsBeingDragged = false;
1067 if (!mScroller.isFinished() && !mFreeScroll) {
1068 setCurrentPage(getNextPage());
1069 pageEndTransition();
1070 }
Sunny Goyalc39db732021-04-03 01:20:21 -07001071 mIsBeingDragged = !mEdgeGlowLeft.isFinished() || !mEdgeGlowRight.isFinished();
Tony Wickhama0aee212019-09-18 09:24:03 -07001072 } else {
1073 mIsBeingDragged = true;
1074 }
Sunny Goyalc39db732021-04-03 01:20:21 -07001075
1076 // Catch the edge effect if it is active.
1077 float displacement = mOrientationHandler.getSecondaryValue(ev.getX(), ev.getY())
1078 / mOrientationHandler.getSecondaryValue(getWidth(), getHeight());
1079 if (!mEdgeGlowLeft.isFinished()) {
1080 mEdgeGlowLeft.onPullDistance(0f, 1f - displacement);
1081 }
1082 if (!mEdgeGlowRight.isFinished()) {
1083 mEdgeGlowRight.onPullDistance(0f, displacement);
1084 }
Tony Wickhama0aee212019-09-18 09:24:03 -07001085 }
1086
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001087 public boolean isHandlingTouch() {
Sunny Goyalaad33592018-08-07 17:20:35 -07001088 return mIsBeingDragged;
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001089 }
1090
Adam Cohenf8d28232011-02-01 21:47:00 -08001091 protected void determineScrollingStart(MotionEvent ev) {
1092 determineScrollingStart(ev, 1.0f);
1093 }
1094
Winson Chung321e9ee2010-08-09 13:37:56 -07001095 /*
1096 * Determines if we should change the touch state to start scrolling after the
1097 * user moves their touch point too far.
1098 */
Adam Cohenf8d28232011-02-01 21:47:00 -08001099 protected void determineScrollingStart(MotionEvent ev, float touchSlopScale) {
Adam Cohen7d30a372013-07-01 17:03:59 -07001100 // Disallow scrolling if we don't have a valid pointer index
Winson Chung321e9ee2010-08-09 13:37:56 -07001101 final int pointerIndex = ev.findPointerIndex(mActivePointerId);
Adam Cohen7d30a372013-07-01 17:03:59 -07001102 if (pointerIndex == -1) return;
1103
Vinit Nayaka406f722019-12-19 11:50:55 -08001104 final float primaryDirection = mOrientationHandler.getPrimaryDirection(ev, pointerIndex);
1105 final int diff = (int) Math.abs(primaryDirection - mLastMotion);
Adam Cohenf8d28232011-02-01 21:47:00 -08001106 final int touchSlop = Math.round(touchSlopScale * mTouchSlop);
Winson Chung4941f652020-06-18 15:11:53 -07001107 boolean moved = diff > touchSlop || ev.getAction() == ACTION_MOVE_ALLOW_EASY_FLING;
Winson Chung321e9ee2010-08-09 13:37:56 -07001108
Vinit Nayaka406f722019-12-19 11:50:55 -08001109 if (moved) {
Sunny Goyal5a1f53b2015-05-27 10:24:24 -07001110 // Scroll if the user moved far enough along the X axis
Sunny Goyalaad33592018-08-07 17:20:35 -07001111 mIsBeingDragged = true;
Vinit Nayaka406f722019-12-19 11:50:55 -08001112 mTotalMotion += Math.abs(mLastMotion - primaryDirection);
1113 mLastMotion = primaryDirection;
1114 mLastMotionRemainder = 0;
Sunny Goyal9ccafbf2016-10-26 13:06:08 -07001115 pageBeginTransition();
Tony Wickhamdadb3042016-02-24 11:07:00 -08001116 // Stop listening for things like pinches.
1117 requestDisallowInterceptTouchEvent(true);
Adam Cohenf8d28232011-02-01 21:47:00 -08001118 }
1119 }
1120
1121 protected void cancelCurrentPageLongPress() {
Sunny Goyal8e2133b2015-05-06 13:39:07 -07001122 // Try canceling the long press. It could also have been scheduled
1123 // by a distant descendant, so use the mAllowLongPress flag to block
1124 // everything
Sunny Goyal59969372021-05-06 12:11:44 -07001125 forEachVisiblePage(View::cancelLongPress);
Winson Chung321e9ee2010-08-09 13:37:56 -07001126 }
1127
Adam Cohenb5ba0972011-09-07 18:02:31 -07001128 protected float getScrollProgress(int screenCenter, View v, int page) {
Sunny Goyal228153d2018-01-04 15:35:22 -08001129 final int halfScreenSize = getMeasuredWidth() / 2;
Adam Cohenedb40762013-07-18 16:45:45 -07001130 int delta = screenCenter - (getScrollForPage(page) + halfScreenSize);
Andras Kloczl77b3eb02021-07-15 11:15:24 +02001131 int panelCount = getPanelCount();
1132 int pageCount = getChildCount();
Adam Cohen3b185e22013-10-29 14:45:58 -07001133
Andras Kloczl77b3eb02021-07-15 11:15:24 +02001134 int adjacentPage = page + panelCount;
Sunny Goyal70660032015-05-14 00:07:08 -07001135 if ((delta < 0 && !mIsRtl) || (delta > 0 && mIsRtl)) {
Andras Kloczl77b3eb02021-07-15 11:15:24 +02001136 adjacentPage = page - panelCount;
Adam Cohen3b185e22013-10-29 14:45:58 -07001137 }
1138
Andras Kloczl77b3eb02021-07-15 11:15:24 +02001139 final int totalDistance;
1140 if (adjacentPage < 0 || adjacentPage > pageCount - 1) {
1141 totalDistance = (v.getMeasuredWidth() + mPageSpacing) * panelCount;
Adam Cohen3b185e22013-10-29 14:45:58 -07001142 } else {
1143 totalDistance = Math.abs(getScrollForPage(adjacentPage) - getScrollForPage(page));
1144 }
Adam Cohenb5ba0972011-09-07 18:02:31 -07001145
1146 float scrollProgress = delta / (totalDistance * 1.0f);
Sunny Goyal8e2133b2015-05-06 13:39:07 -07001147 scrollProgress = Math.min(scrollProgress, MAX_SCROLL_PROGRESS);
Andras Kloczl77b3eb02021-07-15 11:15:24 +02001148 scrollProgress = Math.max(scrollProgress, -MAX_SCROLL_PROGRESS);
Adam Cohenb5ba0972011-09-07 18:02:31 -07001149 return scrollProgress;
1150 }
1151
Adam Cohenedb40762013-07-18 16:45:45 -07001152 public int getScrollForPage(int index) {
Adam Cohen1f1f45d2013-10-02 09:40:18 -07001153 if (mPageScrolls == null || index >= mPageScrolls.length || index < 0) {
Adam Cohenedb40762013-07-18 16:45:45 -07001154 return 0;
1155 } else {
1156 return mPageScrolls[index];
1157 }
1158 }
1159
Adam Cohen564a2e72013-10-09 14:47:32 -07001160 // While layout transitions are occurring, a child's position may stray from its baseline
1161 // position. This method returns the magnitude of this stray at any given time.
1162 public int getLayoutTransitionOffsetForPage(int index) {
1163 if (mPageScrolls == null || index >= mPageScrolls.length || index < 0) {
1164 return 0;
1165 } else {
1166 View child = getChildAt(index);
Adam Cohen3b185e22013-10-29 14:45:58 -07001167
Sunny Goyal228153d2018-01-04 15:35:22 -08001168 int scrollOffset = mIsRtl ? getPaddingRight() : getPaddingLeft();
1169 int baselineX = mPageScrolls[index] + scrollOffset;
Adam Cohen564a2e72013-10-09 14:47:32 -07001170 return (int) (child.getX() - baselineX);
1171 }
1172 }
1173
Tony Wickham023f4042019-01-29 10:52:31 -08001174 public void setEnableFreeScroll(boolean freeScroll) {
Winson Chung0e449002019-04-26 11:09:58 -07001175 if (mFreeScroll == freeScroll) {
1176 return;
1177 }
1178
Tony Wickham8f7ead32016-04-07 18:46:44 -07001179 boolean wasFreeScroll = mFreeScroll;
Adam Cohenf358a4b2013-07-23 16:47:31 -07001180 mFreeScroll = freeScroll;
1181
Adam Cohenf9618852013-11-08 06:45:03 -08001182 if (mFreeScroll) {
Sunny Goyal4d519f22017-10-24 10:32:40 -07001183 setCurrentPage(getNextPage());
Tony Wickham8f7ead32016-04-07 18:46:44 -07001184 } else if (wasFreeScroll) {
Tony Wickhamaf33f2c2019-10-04 12:55:22 -07001185 if (getScrollForPage(getNextPage()) != getScrollX()) {
1186 snapToPage(getNextPage());
1187 }
Adam Cohenf358a4b2013-07-23 16:47:31 -07001188 }
Adam Cohenf358a4b2013-07-23 16:47:31 -07001189 }
1190
Sunny Goyal2f0ec852015-03-26 13:38:27 -07001191 protected void setEnableOverscroll(boolean enable) {
Adam Cohenf358a4b2013-07-23 16:47:31 -07001192 mAllowOverScroll = enable;
1193 }
1194
Alex Chau822acf42021-06-03 11:35:05 +01001195 protected float getSignificantMoveThreshold() {
1196 return SIGNIFICANT_MOVE_THRESHOLD;
1197 }
1198
Winson Chung321e9ee2010-08-09 13:37:56 -07001199 @Override
1200 public boolean onTouchEvent(MotionEvent ev) {
Winson Chung45e1d6e2010-11-09 17:19:49 -08001201 // Skip touch handling if there are no pages to swipe
Tony Wickhamb6841ac2019-07-22 12:39:59 -07001202 if (getChildCount() <= 0) return false;
Winson Chung45e1d6e2010-11-09 17:19:49 -08001203
Michael Jurkab8f06722010-10-10 15:58:46 -07001204 acquireVelocityTrackerAndAddMovement(ev);
Winson Chung321e9ee2010-08-09 13:37:56 -07001205
1206 final int action = ev.getAction();
1207
1208 switch (action & MotionEvent.ACTION_MASK) {
1209 case MotionEvent.ACTION_DOWN:
Sunny Goyalc39db732021-04-03 01:20:21 -07001210 updateIsBeingDraggedOnTouchDown(ev);
Tony Wickhama0aee212019-09-18 09:24:03 -07001211
Winson Chung321e9ee2010-08-09 13:37:56 -07001212 /*
1213 * If being flinged and user touches, stop the fling. isFinished
1214 * will be false if being flinged.
1215 */
1216 if (!mScroller.isFinished()) {
Adam Cohen8bdbaab2013-10-29 15:25:02 -07001217 abortScrollerAnimation(false);
Winson Chung321e9ee2010-08-09 13:37:56 -07001218 }
1219
1220 // Remember where the motion event started
Vinit Nayaka406f722019-12-19 11:50:55 -08001221 mDownMotionX = ev.getX();
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001222 mDownMotionY = ev.getY();
Vinit Nayaka406f722019-12-19 11:50:55 -08001223 mDownMotionPrimary = mLastMotion = mOrientationHandler.getPrimaryDirection(ev, 0);
1224 mLastMotionRemainder = 0;
1225 mTotalMotion = 0;
Winson Chung4941f652020-06-18 15:11:53 -07001226 mAllowEasyFling = false;
Winson Chung321e9ee2010-08-09 13:37:56 -07001227 mActivePointerId = ev.getPointerId(0);
Sunny Goyalaad33592018-08-07 17:20:35 -07001228 if (mIsBeingDragged) {
Sunny Goyal9ccafbf2016-10-26 13:06:08 -07001229 pageBeginTransition();
Michael Jurka0142d492010-08-25 17:46:15 -07001230 }
Winson Chung321e9ee2010-08-09 13:37:56 -07001231 break;
1232
Winson Chung4941f652020-06-18 15:11:53 -07001233 case ACTION_MOVE_ALLOW_EASY_FLING:
1234 // Start scrolling immediately
1235 determineScrollingStart(ev);
1236 mAllowEasyFling = true;
1237 break;
1238
1239 case MotionEvent.ACTION_MOVE:
1240 if (mIsBeingDragged) {
Winson Chung321e9ee2010-08-09 13:37:56 -07001241 // Scroll to follow the motion event
1242 final int pointerIndex = ev.findPointerIndex(mActivePointerId);
Adam Cohen7d30a372013-07-01 17:03:59 -07001243
1244 if (pointerIndex == -1) return true;
Sunny Goyalc39db732021-04-03 01:20:21 -07001245 float oldScroll = mOrientationHandler.getPrimaryScroll(this);
1246 float dx = ev.getX(pointerIndex);
1247 float dy = ev.getY(pointerIndex);
Adam Cohen7d30a372013-07-01 17:03:59 -07001248
Sunny Goyalc39db732021-04-03 01:20:21 -07001249 float direction = mOrientationHandler.getPrimaryValue(dx, dy);
Vinit Nayaka406f722019-12-19 11:50:55 -08001250 float delta = mLastMotion + mLastMotionRemainder - direction;
Sunny Goyalc39db732021-04-03 01:20:21 -07001251
1252 int width = getWidth();
1253 int height = getHeight();
1254 int size = mOrientationHandler.getPrimaryValue(width, height);
1255
1256 final float displacement = mOrientationHandler.getSecondaryValue(dx, dy)
1257 / mOrientationHandler.getSecondaryValue(width, height);
Vinit Nayaka406f722019-12-19 11:50:55 -08001258 mTotalMotion += Math.abs(delta);
Adam Cohenaefd4e12011-02-14 16:39:38 -08001259
Sunny Goyalc39db732021-04-03 01:20:21 -07001260 if (mAllowOverScroll) {
1261 float consumed = 0;
1262 if (delta < 0 && mEdgeGlowRight.getDistance() != 0f) {
1263 consumed = size * mEdgeGlowRight.onPullDistance(delta / size, displacement);
1264 } else if (delta > 0 && mEdgeGlowLeft.getDistance() != 0f) {
1265 consumed = -size * mEdgeGlowLeft.onPullDistance(
1266 -delta / size, 1 - displacement);
1267 }
1268 delta -= consumed;
1269 }
Alex Chau822acf42021-06-03 11:35:05 +01001270 delta /= mOrientationHandler.getPrimaryScale(this);
Sunny Goyalc39db732021-04-03 01:20:21 -07001271
Winson Chungc0844aa2011-02-02 15:25:58 -08001272 // Only scroll and update mLastMotionX if we have moved some discrete amount. We
1273 // keep the remainder because we are actually testing if we've moved from the last
1274 // scrolled position (which is discrete).
Sunny Goyalc39db732021-04-03 01:20:21 -07001275 mLastMotion = direction;
1276 int movedDelta = (int) delta;
1277 mLastMotionRemainder = delta - movedDelta;
Vinit Nayaka406f722019-12-19 11:50:55 -08001278
Sunny Goyalc39db732021-04-03 01:20:21 -07001279 if (delta != 0) {
1280 mOrientationHandler.set(this, VIEW_SCROLL_BY, movedDelta);
1281
1282 if (mAllowOverScroll) {
1283 final float pulledToX = oldScroll + delta;
1284
1285 if (pulledToX < mMinScroll) {
1286 mEdgeGlowLeft.onPullDistance(-delta / size, 1.f - displacement);
1287 if (!mEdgeGlowRight.isFinished()) {
1288 mEdgeGlowRight.onRelease();
1289 }
1290 } else if (pulledToX > mMaxScroll) {
1291 mEdgeGlowRight.onPullDistance(delta / size, displacement);
1292 if (!mEdgeGlowLeft.isFinished()) {
1293 mEdgeGlowLeft.onRelease();
1294 }
1295 }
1296
1297 if (!mEdgeGlowLeft.isFinished() || !mEdgeGlowRight.isFinished()) {
1298 postInvalidateOnAnimation();
1299 }
1300 }
1301
Winson Chung321e9ee2010-08-09 13:37:56 -07001302 } else {
1303 awakenScrollBars();
1304 }
Adam Cohen564976a2010-10-13 18:52:07 -07001305 } else {
Winson Chung321e9ee2010-08-09 13:37:56 -07001306 determineScrollingStart(ev);
1307 }
1308 break;
1309
1310 case MotionEvent.ACTION_UP:
Sunny Goyalaad33592018-08-07 17:20:35 -07001311 if (mIsBeingDragged) {
Winson Chung321e9ee2010-08-09 13:37:56 -07001312 final int activePointerId = mActivePointerId;
1313 final int pointerIndex = ev.findPointerIndex(activePointerId);
Vinit Nayak93bf1fe2020-05-26 17:22:13 -07001314 if (pointerIndex == -1) return true;
1315
Vinit Nayaka406f722019-12-19 11:50:55 -08001316 final float primaryDirection = mOrientationHandler.getPrimaryDirection(ev,
1317 pointerIndex);
Sunny Goyal4bb8b062019-02-19 16:37:38 -08001318 final VelocityTracker velocityTracker = mVelocityTracker;
1319 velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity);
Adam Cohenaefd4e12011-02-14 16:39:38 -08001320
Vinit Nayaka406f722019-12-19 11:50:55 -08001321 int velocity = (int) mOrientationHandler.getPrimaryVelocity(velocityTracker,
1322 mActivePointerId);
Alex Chau822acf42021-06-03 11:35:05 +01001323 float delta = primaryDirection - mDownMotionPrimary;
1324 delta /= mOrientationHandler.getPrimaryScale(this);
Vinit Nayaka406f722019-12-19 11:50:55 -08001325 int pageOrientedSize = mOrientationHandler.getMeasuredSize(getPageAt(mCurrentPage));
1326
Alex Chau822acf42021-06-03 11:35:05 +01001327 boolean isSignificantMove = Math.abs(delta)
1328 > pageOrientedSize * getSignificantMoveThreshold();
Vinit Nayaka406f722019-12-19 11:50:55 -08001329
1330 mTotalMotion += Math.abs(mLastMotion + mLastMotionRemainder - primaryDirection);
Winson Chung4941f652020-06-18 15:11:53 -07001331 boolean passedSlop = mAllowEasyFling || mTotalMotion > mPageSlop;
1332 boolean isFling = passedSlop && shouldFlingForVelocity(velocity);
Vinit Nayaka406f722019-12-19 11:50:55 -08001333 boolean isDeltaLeft = mIsRtl ? delta > 0 : delta < 0;
1334 boolean isVelocityLeft = mIsRtl ? velocity > 0 : velocity < 0;
Winson Chung4941f652020-06-18 15:11:53 -07001335 if (DEBUG_FAILED_QUICKSWITCH && !isFling && mAllowEasyFling) {
1336 Log.d("Quickswitch", "isFling=false vel=" + velocity
1337 + " threshold=" + mEasyFlingThresholdVelocity);
1338 }
Adam Cohen00481b32011-11-18 12:03:48 -08001339
Adam Cohenf358a4b2013-07-23 16:47:31 -07001340 if (!mFreeScroll) {
1341 // In the case that the page is moved far to one direction and then is flung
1342 // in the opposite direction, we use a threshold to determine whether we should
1343 // just return to the starting page, or if we should skip one further.
1344 boolean returnToOriginalPage = false;
Vinit Nayaka406f722019-12-19 11:50:55 -08001345 if (Math.abs(delta) > pageOrientedSize * RETURN_TO_ORIGINAL_PAGE_THRESHOLD &&
1346 Math.signum(velocity) != Math.signum(delta) && isFling) {
Adam Cohenf358a4b2013-07-23 16:47:31 -07001347 returnToOriginalPage = true;
1348 }
Adam Cohenaefd4e12011-02-14 16:39:38 -08001349
Adam Cohenf358a4b2013-07-23 16:47:31 -07001350 int finalPage;
1351 // We give flings precedence over large moves, which is why we short-circuit our
1352 // test for a large move if a fling has been registered. That is, a large
1353 // move to the left and fling to the right will register as a fling to the right.
Sunny Goyalb7b01352018-08-09 12:31:20 -07001354
Vinit Nayaka406f722019-12-19 11:50:55 -08001355 if (((isSignificantMove && !isDeltaLeft && !isFling) ||
1356 (isFling && !isVelocityLeft)) && mCurrentPage > 0) {
Andras Kloczl8e57cce2021-02-11 23:51:19 +01001357 finalPage = returnToOriginalPage
1358 ? mCurrentPage : mCurrentPage - getPanelCount();
Vinit Nayaka406f722019-12-19 11:50:55 -08001359 snapToPageWithVelocity(finalPage, velocity);
1360 } else if (((isSignificantMove && isDeltaLeft && !isFling) ||
1361 (isFling && isVelocityLeft)) &&
Adam Cohenf358a4b2013-07-23 16:47:31 -07001362 mCurrentPage < getChildCount() - 1) {
Andras Kloczl8e57cce2021-02-11 23:51:19 +01001363 finalPage = returnToOriginalPage
1364 ? mCurrentPage : mCurrentPage + getPanelCount();
Vinit Nayaka406f722019-12-19 11:50:55 -08001365 snapToPageWithVelocity(finalPage, velocity);
Adam Cohenf358a4b2013-07-23 16:47:31 -07001366 } else {
1367 snapToDestination();
Adam Cohenf358a4b2013-07-23 16:47:31 -07001368 }
Winson Chung321e9ee2010-08-09 13:37:56 -07001369 } else {
Santiago Etchebehere260b4cb2018-06-15 16:42:19 -07001370 if (!mScroller.isFinished()) {
1371 abortScrollerAnimation(true);
Adam Cohenf358a4b2013-07-23 16:47:31 -07001372 }
Santiago Etchebehere260b4cb2018-06-15 16:42:19 -07001373
Vinit Nayaka406f722019-12-19 11:50:55 -08001374 int initialScroll = mOrientationHandler.getPrimaryScroll(this);
1375 int maxScroll = mMaxScroll;
1376 int minScroll = mMinScroll;
Santiago Etchebehere260b4cb2018-06-15 16:42:19 -07001377
Vinit Nayaka406f722019-12-19 11:50:55 -08001378 if (((initialScroll >= maxScroll) && (isVelocityLeft || !isFling)) ||
1379 ((initialScroll <= minScroll) && (!isVelocityLeft || !isFling))) {
Sunny Goyalc39db732021-04-03 01:20:21 -07001380 mScroller.springBack(initialScroll, 0, minScroll, maxScroll, 0, 0);
Alex Chaub794ea62021-02-03 18:00:30 +00001381 mNextPage = getDestinationPage();
Sunny Goyalb7b01352018-08-09 12:31:20 -07001382 } else {
Sunny Goyalc39db732021-04-03 01:20:21 -07001383 int velocity1 = -velocity;
1384 // Continue a scroll or fling in progress
1385 mScroller.fling(initialScroll, 0, velocity1, 0, minScroll, maxScroll, 0, 0,
1386 Math.round(getWidth() * 0.5f * OVERSCROLL_DAMP_FACTOR), 0);
Santiago Etchebehere260b4cb2018-06-15 16:42:19 -07001387
Sunny Goyalc39db732021-04-03 01:20:21 -07001388 int finalPos = mScroller.getFinalX();
Alex Chaub794ea62021-02-03 18:00:30 +00001389 mNextPage = getDestinationPage(finalPos);
Sunny Goyalc39db732021-04-03 01:20:21 -07001390 onNotSnappingToPageInFreeScroll();
Santiago Etchebehere260b4cb2018-06-15 16:42:19 -07001391 }
1392 invalidate();
Winson Chung321e9ee2010-08-09 13:37:56 -07001393 }
Winson Chung321e9ee2010-08-09 13:37:56 -07001394 }
Adam Cohen7d30a372013-07-01 17:03:59 -07001395
Sunny Goyalc39db732021-04-03 01:20:21 -07001396 mEdgeGlowLeft.onRelease();
1397 mEdgeGlowRight.onRelease();
Adam Cohen7d30a372013-07-01 17:03:59 -07001398 // End any intermediate reordering states
1399 resetTouchState();
Winson Chung321e9ee2010-08-09 13:37:56 -07001400 break;
1401
1402 case MotionEvent.ACTION_CANCEL:
Sunny Goyalaad33592018-08-07 17:20:35 -07001403 if (mIsBeingDragged) {
Michael Jurkab8f06722010-10-10 15:58:46 -07001404 snapToDestination();
1405 }
Sunny Goyalc39db732021-04-03 01:20:21 -07001406 mEdgeGlowLeft.onRelease();
1407 mEdgeGlowRight.onRelease();
Adam Cohen7d30a372013-07-01 17:03:59 -07001408 resetTouchState();
Winson Chung321e9ee2010-08-09 13:37:56 -07001409 break;
1410
1411 case MotionEvent.ACTION_POINTER_UP:
1412 onSecondaryPointerUp(ev);
Adam Cohenf358a4b2013-07-23 16:47:31 -07001413 releaseVelocityTracker();
Winson Chung321e9ee2010-08-09 13:37:56 -07001414 break;
1415 }
1416
1417 return true;
1418 }
1419
Sunny Goyalc39db732021-04-03 01:20:21 -07001420 protected void onNotSnappingToPageInFreeScroll() { }
Alex Chaub794ea62021-02-03 18:00:30 +00001421
Lais Andradecc5c8842021-06-04 18:20:30 +01001422 /**
1423 * Called when the view edges absorb part of the scroll. Subclasses can override this
1424 * to provide custom behavior during animation.
1425 */
1426 protected void onEdgeAbsorbingScroll() {
1427 }
1428
1429 /**
1430 * Called when the current page closest to the center of the screen changes as part of the
1431 * scroll. Subclasses can override this to provide custom behavior during scroll.
1432 */
1433 protected void onScrollOverPageChanged() {
1434 }
1435
Vinit Nayaka406f722019-12-19 11:50:55 -08001436 protected boolean shouldFlingForVelocity(int velocity) {
Winson Chung4941f652020-06-18 15:11:53 -07001437 float threshold = mAllowEasyFling ? mEasyFlingThresholdVelocity : mFlingThresholdVelocity;
1438 return Math.abs(velocity) > threshold;
Sunny Goyal65d9ceb2017-05-08 09:17:42 -07001439 }
1440
Adam Cohen7d30a372013-07-01 17:03:59 -07001441 private void resetTouchState() {
1442 releaseVelocityTracker();
Sunny Goyalaad33592018-08-07 17:20:35 -07001443 mIsBeingDragged = false;
Adam Cohen7d30a372013-07-01 17:03:59 -07001444 mActivePointerId = INVALID_POINTER;
Adam Cohen7d30a372013-07-01 17:03:59 -07001445 }
1446
Winson Chung185d7162011-02-28 13:47:29 -08001447 @Override
1448 public boolean onGenericMotionEvent(MotionEvent event) {
1449 if ((event.getSource() & InputDevice.SOURCE_CLASS_POINTER) != 0) {
1450 switch (event.getAction()) {
1451 case MotionEvent.ACTION_SCROLL: {
1452 // Handle mouse (or ext. device) by shifting the page depending on the scroll
1453 final float vscroll;
1454 final float hscroll;
1455 if ((event.getMetaState() & KeyEvent.META_SHIFT_ON) != 0) {
1456 vscroll = 0;
1457 hscroll = event.getAxisValue(MotionEvent.AXIS_VSCROLL);
1458 } else {
1459 vscroll = -event.getAxisValue(MotionEvent.AXIS_VSCROLL);
1460 hscroll = event.getAxisValue(MotionEvent.AXIS_HSCROLL);
1461 }
Sunny Goyal8b37c572020-03-31 12:12:14 -07001462 if (!canScroll(Math.abs(vscroll), Math.abs(hscroll))) {
1463 return false;
Samuel Fufa59cba192019-08-22 18:31:34 -07001464 }
Winson Chung185d7162011-02-28 13:47:29 -08001465 if (hscroll != 0 || vscroll != 0) {
Sunny Goyal70660032015-05-14 00:07:08 -07001466 boolean isForwardScroll = mIsRtl ? (hscroll < 0 || vscroll < 0)
Adam Cohen0ffac432013-07-10 11:19:26 -07001467 : (hscroll > 0 || vscroll > 0);
1468 if (isForwardScroll) {
Winson Chung185d7162011-02-28 13:47:29 -08001469 scrollRight();
1470 } else {
1471 scrollLeft();
1472 }
1473 return true;
1474 }
1475 }
1476 }
1477 }
1478 return super.onGenericMotionEvent(event);
1479 }
1480
Sunny Goyal8b37c572020-03-31 12:12:14 -07001481 /**
1482 * Returns true if the paged view can scroll for the provided vertical and horizontal
1483 * scroll values
1484 */
1485 protected boolean canScroll(float absVScroll, float absHScroll) {
1486 ActivityContext ac = ActivityContext.lookupContext(getContext());
1487 return (ac == null || AbstractFloatingView.getTopOpenView(ac) == null);
Samuel Fufa59cba192019-08-22 18:31:34 -07001488 }
1489
Michael Jurkab8f06722010-10-10 15:58:46 -07001490 private void acquireVelocityTrackerAndAddMovement(MotionEvent ev) {
1491 if (mVelocityTracker == null) {
1492 mVelocityTracker = VelocityTracker.obtain();
1493 }
1494 mVelocityTracker.addMovement(ev);
1495 }
1496
1497 private void releaseVelocityTracker() {
1498 if (mVelocityTracker != null) {
Adam Cohenf358a4b2013-07-23 16:47:31 -07001499 mVelocityTracker.clear();
Michael Jurkab8f06722010-10-10 15:58:46 -07001500 mVelocityTracker.recycle();
1501 mVelocityTracker = null;
1502 }
1503 }
1504
Winson Chung321e9ee2010-08-09 13:37:56 -07001505 private void onSecondaryPointerUp(MotionEvent ev) {
Winson Chung4941f652020-06-18 15:11:53 -07001506 final int pointerIndex = ev.getActionIndex();
Winson Chung321e9ee2010-08-09 13:37:56 -07001507 final int pointerId = ev.getPointerId(pointerIndex);
1508 if (pointerId == mActivePointerId) {
1509 // This was our active pointer going up. Choose a new
1510 // active pointer and adjust accordingly.
1511 // TODO: Make this decision more intelligent.
1512 final int newPointerIndex = pointerIndex == 0 ? 1 : 0;
Vinit Nayaka406f722019-12-19 11:50:55 -08001513 mLastMotion = mDownMotionPrimary = mOrientationHandler.getPrimaryDirection(ev,
1514 newPointerIndex);
1515 mLastMotionRemainder = 0;
Winson Chung321e9ee2010-08-09 13:37:56 -07001516 mActivePointerId = ev.getPointerId(newPointerIndex);
1517 if (mVelocityTracker != null) {
1518 mVelocityTracker.clear();
1519 }
1520 }
Jeff Brown1d0867c2010-12-02 18:27:39 -08001521 }
1522
Winson Chung321e9ee2010-08-09 13:37:56 -07001523 @Override
1524 public void requestChildFocus(View child, View focused) {
1525 super.requestChildFocus(child, focused);
Andras Kloczl359d1ae2021-05-04 22:25:27 +02001526
1527 // In case the device is controlled by a controller, mCurrentPage isn't updated properly
1528 // which results in incorrect navigation
1529 int nextPage = getNextPage();
1530 if (nextPage != mCurrentPage) {
1531 setCurrentPage(nextPage);
1532 }
1533
Andras Kloczl7e912442021-05-06 12:50:28 +02001534 int page = indexOfChild(child);
1535 if (page >= 0 && !isVisible(page) && !isInTouchMode()) {
Winson Chung86f77532010-08-24 11:08:22 -07001536 snapToPage(page);
Winson Chung321e9ee2010-08-09 13:37:56 -07001537 }
1538 }
1539
Alex Chaub794ea62021-02-03 18:00:30 +00001540 public int getDestinationPage() {
1541 return getDestinationPage(mOrientationHandler.getPrimaryScroll(this));
1542 }
1543
Alex Chaudedbc8a2021-03-17 16:53:26 +00001544 protected int getDestinationPage(int primaryScroll) {
1545 return getPageNearestToCenterOfScreen(primaryScroll);
Alex Chaub794ea62021-02-03 18:00:30 +00001546 }
1547
Sunny Goyal228153d2018-01-04 15:35:22 -08001548 public int getPageNearestToCenterOfScreen() {
Vinit Nayaka406f722019-12-19 11:50:55 -08001549 return getPageNearestToCenterOfScreen(mOrientationHandler.getPrimaryScroll(this));
Tony Wickham8f7ead32016-04-07 18:46:44 -07001550 }
1551
Alex Chaudedbc8a2021-03-17 16:53:26 +00001552 private int getPageNearestToCenterOfScreen(int primaryScroll) {
1553 int screenCenter = getScreenCenter(primaryScroll);
Adam Cohen22f823d2011-09-01 17:22:18 -07001554 int minDistanceFromScreenCenter = Integer.MAX_VALUE;
Winson Chung321e9ee2010-08-09 13:37:56 -07001555 int minDistanceFromScreenCenterIndex = -1;
Winson Chung321e9ee2010-08-09 13:37:56 -07001556 final int childCount = getChildCount();
1557 for (int i = 0; i < childCount; ++i) {
Tony Wickham7383d4e2020-07-07 19:25:25 -07001558 int distanceFromScreenCenter = Math.abs(
1559 getDisplacementFromScreenCenter(i, screenCenter));
Winson Chung321e9ee2010-08-09 13:37:56 -07001560 if (distanceFromScreenCenter < minDistanceFromScreenCenter) {
1561 minDistanceFromScreenCenter = distanceFromScreenCenter;
1562 minDistanceFromScreenCenterIndex = i;
1563 }
1564 }
Adam Cohend19d3ca2010-09-15 14:43:42 -07001565 return minDistanceFromScreenCenterIndex;
1566 }
1567
Tony Wickham7383d4e2020-07-07 19:25:25 -07001568 private int getDisplacementFromScreenCenter(int childIndex, int screenCenter) {
Alex Chaudedbc8a2021-03-17 16:53:26 +00001569 int childSize = Math.round(getChildVisibleSize(childIndex));
Tony Wickham7383d4e2020-07-07 19:25:25 -07001570 int halfChildSize = (childSize / 2);
1571 int childCenter = getChildOffset(childIndex) + halfChildSize;
1572 return childCenter - screenCenter;
1573 }
1574
1575 protected int getDisplacementFromScreenCenter(int childIndex) {
Alex Chaudedbc8a2021-03-17 16:53:26 +00001576 int primaryScroll = mOrientationHandler.getPrimaryScroll(this);
1577 int screenCenter = getScreenCenter(primaryScroll);
Tony Wickham7383d4e2020-07-07 19:25:25 -07001578 return getDisplacementFromScreenCenter(childIndex, screenCenter);
1579 }
1580
Andras Kloczl9732df12021-09-09 19:40:42 +01001581 protected int getScreenCenter(int primaryScroll) {
Alex Chaudedbc8a2021-03-17 16:53:26 +00001582 float primaryScale = mOrientationHandler.getPrimaryScale(this);
1583 float primaryPivot = mOrientationHandler.getPrimaryValue(getPivotX(), getPivotY());
1584 int pageOrientationSize = mOrientationHandler.getMeasuredSize(this);
1585 return Math.round(primaryScroll + (pageOrientationSize / 2f - primaryPivot) / primaryScale
1586 + primaryPivot);
1587 }
1588
Adam Cohend19d3ca2010-09-15 14:43:42 -07001589 protected void snapToDestination() {
Sunny Goyalc39db732021-04-03 01:20:21 -07001590 snapToPage(getDestinationPage(), PAGE_SNAP_ANIMATION_DURATION);
Winson Chung321e9ee2010-08-09 13:37:56 -07001591 }
1592
Adam Cohene0f66b52010-11-23 15:06:07 -08001593 // We want the duration of the page snap animation to be influenced by the distance that
1594 // the screen has to travel, however, we don't want this duration to be effected in a
1595 // purely linear fashion. Instead, we use this method to moderate the effect that the distance
1596 // of travel has on the overall snap duration.
Sunny Goyal4d113a52015-05-27 10:05:28 -07001597 private float distanceInfluenceForSnapDuration(float f) {
Adam Cohene0f66b52010-11-23 15:06:07 -08001598 f -= 0.5f; // center the values about 0.
1599 f *= 0.3f * Math.PI / 2.0f;
1600 return (float) Math.sin(f);
1601 }
1602
Winson Chung05a31ed2018-02-08 17:08:43 -08001603 protected boolean snapToPageWithVelocity(int whichPage, int velocity) {
Adam Cohen6f127a62014-06-12 14:54:41 -07001604 whichPage = validateNewPage(whichPage);
Vinit Nayaka406f722019-12-19 11:50:55 -08001605 int halfScreenSize = mOrientationHandler.getMeasuredSize(this) / 2;
Adam Cohene0f66b52010-11-23 15:06:07 -08001606
Vinit Nayaka406f722019-12-19 11:50:55 -08001607 final int newLoc = getScrollForPage(whichPage);
Sunny Goyalc39db732021-04-03 01:20:21 -07001608 int delta = newLoc - mOrientationHandler.getPrimaryScroll(this);
Adam Cohene0f66b52010-11-23 15:06:07 -08001609 int duration = 0;
1610
Sunny Goyal4d113a52015-05-27 10:05:28 -07001611 if (Math.abs(velocity) < mMinFlingVelocity) {
Adam Cohene0f66b52010-11-23 15:06:07 -08001612 // If the velocity is low enough, then treat this more as an automatic page advance
1613 // as opposed to an apparent physical response to flinging
Winson Chung05a31ed2018-02-08 17:08:43 -08001614 return snapToPage(whichPage, PAGE_SNAP_ANIMATION_DURATION);
Adam Cohene0f66b52010-11-23 15:06:07 -08001615 }
1616
1617 // Here we compute a "distance" that will be used in the computation of the overall
1618 // snap duration. This is a function of the actual distance that needs to be traveled;
1619 // we keep this value close to half screen size in order to reduce the variance in snap
1620 // duration as a function of the distance the page needs to travel.
Michael Jurka20b7ca92011-06-07 20:09:16 -07001621 float distanceRatio = Math.min(1f, 1.0f * Math.abs(delta) / (2 * halfScreenSize));
Adam Cohene0f66b52010-11-23 15:06:07 -08001622 float distance = halfScreenSize + halfScreenSize *
1623 distanceInfluenceForSnapDuration(distanceRatio);
1624
1625 velocity = Math.abs(velocity);
Adam Cohen265b9a62011-12-07 14:37:18 -08001626 velocity = Math.max(mMinSnapVelocity, velocity);
Adam Cohene0f66b52010-11-23 15:06:07 -08001627
1628 // we want the page's snap velocity to approximately match the velocity at which the
1629 // user flings, so we scale the duration by a value near to the derivative of the scroll
Michael Jurka20b7ca92011-06-07 20:09:16 -07001630 // interpolator at zero, ie. 5. We use 4 to make it a little slower.
1631 duration = 4 * Math.round(1000 * Math.abs(distance / velocity));
Adam Cohene0f66b52010-11-23 15:06:07 -08001632
Sunny Goyalc39db732021-04-03 01:20:21 -07001633 return snapToPage(whichPage, delta, duration);
Michael Jurka0142d492010-08-25 17:46:15 -07001634 }
1635
Winson Chung05a31ed2018-02-08 17:08:43 -08001636 public boolean snapToPage(int whichPage) {
1637 return snapToPage(whichPage, PAGE_SNAP_ANIMATION_DURATION);
Winson Chung321e9ee2010-08-09 13:37:56 -07001638 }
1639
Winson Chung05a31ed2018-02-08 17:08:43 -08001640 public boolean snapToPageImmediately(int whichPage) {
Sunny Goyalc39db732021-04-03 01:20:21 -07001641 return snapToPage(whichPage, PAGE_SNAP_ANIMATION_DURATION, true);
Adam Cohen7d30a372013-07-01 17:03:59 -07001642 }
1643
Winson Chung05a31ed2018-02-08 17:08:43 -08001644 public boolean snapToPage(int whichPage, int duration) {
Sunny Goyalc39db732021-04-03 01:20:21 -07001645 return snapToPage(whichPage, duration, false);
Adam Cohen7d30a372013-07-01 17:03:59 -07001646 }
1647
Sunny Goyalc39db732021-04-03 01:20:21 -07001648 protected boolean snapToPage(int whichPage, int duration, boolean immediate) {
Adam Cohen6f127a62014-06-12 14:54:41 -07001649 whichPage = validateNewPage(whichPage);
Winson Chung321e9ee2010-08-09 13:37:56 -07001650
Vinit Nayaka406f722019-12-19 11:50:55 -08001651 int newLoc = getScrollForPage(whichPage);
Sunny Goyalc39db732021-04-03 01:20:21 -07001652 final int delta = newLoc - mOrientationHandler.getPrimaryScroll(this);
1653 return snapToPage(whichPage, delta, duration, immediate);
Michael Jurka0142d492010-08-25 17:46:15 -07001654 }
1655
Winson Chung05a31ed2018-02-08 17:08:43 -08001656 protected boolean snapToPage(int whichPage, int delta, int duration) {
Sunny Goyalc39db732021-04-03 01:20:21 -07001657 return snapToPage(whichPage, delta, duration, false);
Adam Cohen7d30a372013-07-01 17:03:59 -07001658 }
Michael Jurka0142d492010-08-25 17:46:15 -07001659
Sunny Goyalc39db732021-04-03 01:20:21 -07001660 protected boolean snapToPage(int whichPage, int delta, int duration, boolean immediate) {
Sunny Goyal9bb8ffb2018-05-24 17:11:16 -07001661 if (mFirstLayout) {
1662 setCurrentPage(whichPage);
1663 return false;
1664 }
Tony Wickhamd58c2d52018-05-04 12:10:55 -07001665
Andy Wickhamda5a89b2021-07-23 12:38:14 -10001666 if (FeatureFlags.IS_STUDIO_BUILD && !Utilities.IS_RUNNING_IN_TEST_HARNESS) {
Tony Wickhamcb3f8702018-08-27 17:36:03 -07001667 duration *= Settings.Global.getFloat(getContext().getContentResolver(),
1668 Settings.Global.WINDOW_ANIMATION_SCALE, 1);
Tony Wickhamd58c2d52018-05-04 12:10:55 -07001669 }
1670
Adam Cohen6f127a62014-06-12 14:54:41 -07001671 whichPage = validateNewPage(whichPage);
1672
Adam Cohen7d30a372013-07-01 17:03:59 -07001673 mNextPage = whichPage;
Michael Jurka0142d492010-08-25 17:46:15 -07001674
Winson Chung321e9ee2010-08-09 13:37:56 -07001675 awakenScrollBars(duration);
Adam Cohen7d30a372013-07-01 17:03:59 -07001676 if (immediate) {
1677 duration = 0;
1678 } else if (duration == 0) {
Winson Chung321e9ee2010-08-09 13:37:56 -07001679 duration = Math.abs(delta);
1680 }
1681
Sunny Goyal9ccafbf2016-10-26 13:06:08 -07001682 if (duration != 0) {
1683 pageBeginTransition();
1684 }
1685
Adam Cohenf358a4b2013-07-23 16:47:31 -07001686 if (!mScroller.isFinished()) {
Adam Cohenf9618852013-11-08 06:45:03 -08001687 abortScrollerAnimation(false);
Adam Cohenf358a4b2013-07-23 16:47:31 -07001688 }
Adam Cohenf9618852013-11-08 06:45:03 -08001689
Sunny Goyalc39db732021-04-03 01:20:21 -07001690 mScroller.startScroll(mOrientationHandler.getPrimaryScroll(this), 0, delta, 0, duration);
Adam Cohen674531f2013-12-13 15:07:14 -08001691 updatePageIndicator();
Adam Cohen7d30a372013-07-01 17:03:59 -07001692
1693 // Trigger a compute() to finish switching pages if necessary
1694 if (immediate) {
1695 computeScroll();
Sunny Goyal76dbf6f2017-01-03 14:55:47 -08001696 pageEndTransition();
Adam Cohen7d30a372013-07-01 17:03:59 -07001697 }
1698
Winson Chung321e9ee2010-08-09 13:37:56 -07001699 invalidate();
Winson Chung05a31ed2018-02-08 17:08:43 -08001700 return Math.abs(delta) > 0;
Winson Chung321e9ee2010-08-09 13:37:56 -07001701 }
1702
Vadim Tryshev98913d02018-05-18 18:41:34 -07001703 public boolean scrollLeft() {
1704 if (getNextPage() > 0) {
Andras Kloczl77b3eb02021-07-15 11:15:24 +02001705 snapToPage(getNextPage() - getPanelCount());
Vadim Tryshev98913d02018-05-18 18:41:34 -07001706 return true;
1707 }
Sunny Goyalc39db732021-04-03 01:20:21 -07001708 return mAllowOverScroll;
Winson Chung321e9ee2010-08-09 13:37:56 -07001709 }
1710
Vadim Tryshev98913d02018-05-18 18:41:34 -07001711 public boolean scrollRight() {
1712 if (getNextPage() < getChildCount() - 1) {
Andras Kloczl77b3eb02021-07-15 11:15:24 +02001713 snapToPage(getNextPage() + getPanelCount());
Vadim Tryshev98913d02018-05-18 18:41:34 -07001714 return true;
1715 }
Sunny Goyalc39db732021-04-03 01:20:21 -07001716 return mAllowOverScroll;
Winson Chung321e9ee2010-08-09 13:37:56 -07001717 }
1718
Vadim Trysheve6bbefb2018-04-03 13:38:06 -07001719 @Override
Lais Andradecc5c8842021-06-04 18:20:30 +01001720 protected void onScrollChanged(int l, int t, int oldl, int oldt) {
1721 int newDestinationPage = getDestinationPage();
1722 if (newDestinationPage >= 0 && newDestinationPage != mCurrentScrollOverPage) {
1723 mCurrentScrollOverPage = newDestinationPage;
1724 onScrollOverPageChanged();
1725 }
1726 }
1727
1728 @Override
Vadim Trysheve6bbefb2018-04-03 13:38:06 -07001729 public CharSequence getAccessibilityClassName() {
1730 // Some accessibility services have special logic for ScrollView. Since we provide same
1731 // accessibility info as ScrollView, inform the service to handle use the same way.
1732 return ScrollView.class.getName();
1733 }
1734
Vadim Tryshev0fc07132018-05-04 12:08:54 -07001735 protected boolean isPageOrderFlipped() {
1736 return false;
1737 }
1738
Winson Chung6a0f57d2011-06-29 20:10:49 -07001739 /* Accessibility */
Sunny Goyalcf25b522015-07-09 00:01:18 -07001740 @SuppressWarnings("deprecation")
Winson Chung6a0f57d2011-06-29 20:10:49 -07001741 @Override
1742 public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) {
1743 super.onInitializeAccessibilityNodeInfo(info);
Vadim Tryshev0fc07132018-05-04 12:08:54 -07001744 final boolean pagesFlipped = isPageOrderFlipped();
Pinyao Tingaf6daa22019-09-18 22:18:03 +00001745 int offset = (mAllowOverScroll ? 0 : 1);
1746 info.setScrollable(getPageCount() > offset);
1747 if (getCurrentPage() < getPageCount() - offset) {
yingleiw02cc8482019-08-02 16:14:27 -07001748 info.addAction(pagesFlipped ?
1749 AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_BACKWARD
1750 : AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_FORWARD);
1751 info.addAction(mIsRtl ?
1752 AccessibilityNodeInfo.AccessibilityAction.ACTION_PAGE_LEFT
1753 : AccessibilityNodeInfo.AccessibilityAction.ACTION_PAGE_RIGHT);
Svetoslav Ganov08055f62012-05-15 11:06:36 -07001754 }
Pinyao Tingaf6daa22019-09-18 22:18:03 +00001755 if (getCurrentPage() >= offset) {
yingleiw02cc8482019-08-02 16:14:27 -07001756 info.addAction(pagesFlipped ?
1757 AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_FORWARD
1758 : AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_BACKWARD);
1759 info.addAction(mIsRtl ?
1760 AccessibilityNodeInfo.AccessibilityAction.ACTION_PAGE_RIGHT
1761 : AccessibilityNodeInfo.AccessibilityAction.ACTION_PAGE_LEFT);
Svetoslav Ganov08055f62012-05-15 11:06:36 -07001762 }
Vadim Tryshev7af0d442015-05-15 08:48:11 -07001763 // Accessibility-wise, PagedView doesn't support long click, so disabling it.
1764 // Besides disabling the accessibility long-click, this also prevents this view from getting
1765 // accessibility focus.
1766 info.setLongClickable(false);
Sunny Goyala52ecb02016-12-16 15:04:51 -08001767 info.removeAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_LONG_CLICK);
Winson Chung6a0f57d2011-06-29 20:10:49 -07001768 }
1769
1770 @Override
Alan Viverette254139a2013-10-08 13:13:46 -07001771 public void sendAccessibilityEvent(int eventType) {
1772 // Don't let the view send real scroll events.
1773 if (eventType != AccessibilityEvent.TYPE_VIEW_SCROLLED) {
1774 super.sendAccessibilityEvent(eventType);
1775 }
1776 }
1777
1778 @Override
Winson Chung6a0f57d2011-06-29 20:10:49 -07001779 public void onInitializeAccessibilityEvent(AccessibilityEvent event) {
1780 super.onInitializeAccessibilityEvent(event);
Pinyao Tingaf6daa22019-09-18 22:18:03 +00001781 event.setScrollable(mAllowOverScroll || getPageCount() > 1);
Winson Chung6a0f57d2011-06-29 20:10:49 -07001782 }
1783
Svetoslav Ganov08055f62012-05-15 11:06:36 -07001784 @Override
1785 public boolean performAccessibilityAction(int action, Bundle arguments) {
1786 if (super.performAccessibilityAction(action, arguments)) {
1787 return true;
1788 }
Vadim Tryshev0fc07132018-05-04 12:08:54 -07001789 final boolean pagesFlipped = isPageOrderFlipped();
Svetoslav Ganov08055f62012-05-15 11:06:36 -07001790 switch (action) {
1791 case AccessibilityNodeInfo.ACTION_SCROLL_FORWARD: {
Vadim Tryshev98913d02018-05-18 18:41:34 -07001792 if (pagesFlipped ? scrollLeft() : scrollRight()) {
Svetoslav Ganov08055f62012-05-15 11:06:36 -07001793 return true;
1794 }
1795 } break;
1796 case AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD: {
Vadim Tryshev98913d02018-05-18 18:41:34 -07001797 if (pagesFlipped ? scrollRight() : scrollLeft()) {
Svetoslav Ganov08055f62012-05-15 11:06:36 -07001798 return true;
1799 }
yingleiw02cc8482019-08-02 16:14:27 -07001800 } break;
1801 case android.R.id.accessibilityActionPageRight: {
1802 if (!mIsRtl) {
1803 return scrollRight();
1804 } else {
1805 return scrollLeft();
1806 }
Vadim Tryshev0fc07132018-05-04 12:08:54 -07001807 }
yingleiw02cc8482019-08-02 16:14:27 -07001808 case android.R.id.accessibilityActionPageLeft: {
1809 if (!mIsRtl) {
1810 return scrollLeft();
1811 } else {
1812 return scrollRight();
1813 }
1814 }
Svetoslav Ganov08055f62012-05-15 11:06:36 -07001815 }
1816 return false;
1817 }
1818
Vadim Tryshev2c430b32018-04-04 14:45:21 -07001819 protected boolean canAnnouncePageDescription() {
1820 return true;
1821 }
1822
Adam Cohen0ffac432013-07-10 11:19:26 -07001823 protected String getCurrentPageDescription() {
Sunny Goyalf4f89ef2015-09-02 15:06:12 -07001824 return getContext().getString(R.string.default_scroll_format,
Adam Cohen0ffac432013-07-10 11:19:26 -07001825 getNextPage() + 1, getChildCount());
1826 }
1827
Tony Mak2e564402018-02-27 17:19:34 +00001828 protected float getDownMotionX() {
1829 return mDownMotionX;
1830 }
1831
1832 protected float getDownMotionY() {
1833 return mDownMotionY;
1834 }
1835
Sunny Goyal20a13ff2018-03-13 16:44:00 -07001836 protected interface ComputePageScrollsLogic {
1837
1838 boolean shouldIncludeView(View view);
1839 }
Vadim Tryshev528b9e02018-05-24 18:22:03 -07001840
1841 public int[] getVisibleChildrenRange() {
1842 float visibleLeft = 0;
1843 float visibleRight = visibleLeft + getMeasuredWidth();
1844 float scaleX = getScaleX();
1845 if (scaleX < 1 && scaleX > 0) {
1846 float mid = getMeasuredWidth() / 2;
1847 visibleLeft = mid - ((mid - visibleLeft) / scaleX);
1848 visibleRight = mid + ((visibleRight - mid) / scaleX);
1849 }
1850
1851 int leftChild = -1;
1852 int rightChild = -1;
1853 final int childCount = getChildCount();
1854 for (int i = 0; i < childCount; i++) {
1855 final View child = getPageAt(i);
1856
1857 float left = child.getLeft() + child.getTranslationX() - getScrollX();
1858 if (left <= visibleRight && (left + child.getMeasuredWidth()) >= visibleLeft) {
1859 if (leftChild == -1) {
1860 leftChild = i;
1861 }
1862 rightChild = i;
1863 }
1864 }
1865 mTmpIntPair[0] = leftChild;
1866 mTmpIntPair[1] = rightChild;
1867 return mTmpIntPair;
1868 }
Sunny Goyalc39db732021-04-03 01:20:21 -07001869
1870 @Override
1871 public void draw(Canvas canvas) {
1872 super.draw(canvas);
1873 drawEdgeEffect(canvas);
Sunny Goyal05b59c02021-04-29 13:55:40 -07001874 pageEndTransition();
Sunny Goyalc39db732021-04-03 01:20:21 -07001875 }
1876
1877 protected void drawEdgeEffect(Canvas canvas) {
1878 if (mAllowOverScroll && (!mEdgeGlowRight.isFinished() || !mEdgeGlowLeft.isFinished())) {
1879 final int width = getWidth();
1880 final int height = getHeight();
1881 if (!mEdgeGlowLeft.isFinished()) {
1882 final int restoreCount = canvas.save();
1883 canvas.rotate(-90);
1884 canvas.translate(-height, Math.min(mMinScroll, getScrollX()));
1885 mEdgeGlowLeft.setSize(height, width);
1886 if (mEdgeGlowLeft.draw(canvas)) {
1887 postInvalidateOnAnimation();
1888 }
1889 canvas.restoreToCount(restoreCount);
1890 }
1891 if (!mEdgeGlowRight.isFinished()) {
1892 final int restoreCount = canvas.save();
1893 canvas.rotate(90, width, 0);
1894 canvas.translate(width, -(Math.max(mMaxScroll, getScrollX())));
1895
1896 mEdgeGlowRight.setSize(height, width);
1897 if (mEdgeGlowRight.draw(canvas)) {
1898 postInvalidateOnAnimation();
1899 }
1900 canvas.restoreToCount(restoreCount);
1901 }
1902 }
1903 }
Adam Cohen5084cba2013-09-03 12:01:16 -07001904}