| /* |
| * Copyright (C) 2016 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package com.android.launcher3; |
| |
| import static android.animation.ValueAnimator.areAnimatorsEnabled; |
| import static android.view.accessibility.AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED; |
| import static android.view.accessibility.AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED; |
| |
| import static com.android.launcher3.compat.AccessibilityManagerCompat.isAccessibilityEnabled; |
| import static com.android.launcher3.compat.AccessibilityManagerCompat.sendCustomAccessibilityEvent; |
| |
| import android.annotation.SuppressLint; |
| import android.annotation.TargetApi; |
| import android.content.Context; |
| import android.os.Build; |
| import android.util.AttributeSet; |
| import android.util.Pair; |
| import android.view.MotionEvent; |
| import android.view.View; |
| import android.view.accessibility.AccessibilityNodeInfo; |
| import android.view.animation.Interpolator; |
| import android.widget.LinearLayout; |
| import android.window.OnBackAnimationCallback; |
| |
| import androidx.annotation.IntDef; |
| |
| import com.android.launcher3.anim.PendingAnimation; |
| import com.android.launcher3.util.TouchController; |
| import com.android.launcher3.views.ActivityContext; |
| import com.android.launcher3.views.BaseDragLayer; |
| |
| import java.lang.annotation.Retention; |
| import java.lang.annotation.RetentionPolicy; |
| |
| /** |
| * Base class for a View which shows a floating UI on top of the launcher UI. |
| */ |
| @TargetApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE) |
| public abstract class AbstractFloatingView extends LinearLayout implements TouchController, |
| OnBackAnimationCallback { |
| |
| @IntDef(flag = true, value = { |
| TYPE_FOLDER, |
| TYPE_ACTION_POPUP, |
| TYPE_WIDGETS_BOTTOM_SHEET, |
| TYPE_WIDGET_RESIZE_FRAME, |
| TYPE_WIDGETS_FULL_SHEET, |
| TYPE_ON_BOARD_POPUP, |
| TYPE_DISCOVERY_BOUNCE, |
| TYPE_SNACKBAR, |
| TYPE_LISTENER, |
| TYPE_ALL_APPS_EDU, |
| TYPE_DRAG_DROP_POPUP, |
| TYPE_TASK_MENU, |
| TYPE_OPTIONS_POPUP, |
| TYPE_ICON_SURFACE, |
| TYPE_OPTIONS_POPUP_DIALOG, |
| TYPE_PIN_WIDGET_FROM_EXTERNAL_POPUP, |
| TYPE_WIDGETS_EDUCATION_DIALOG, |
| TYPE_TASKBAR_EDUCATION_DIALOG, |
| TYPE_TASKBAR_ALL_APPS, |
| TYPE_ADD_TO_HOME_CONFIRMATION, |
| TYPE_TASKBAR_OVERLAY_PROXY, |
| TYPE_TASKBAR_PINNING_POPUP |
| }) |
| @Retention(RetentionPolicy.SOURCE) |
| public @interface FloatingViewType {} |
| public static final int TYPE_FOLDER = 1 << 0; |
| public static final int TYPE_ACTION_POPUP = 1 << 1; |
| public static final int TYPE_WIDGETS_BOTTOM_SHEET = 1 << 2; |
| public static final int TYPE_WIDGET_RESIZE_FRAME = 1 << 3; |
| public static final int TYPE_WIDGETS_FULL_SHEET = 1 << 4; |
| public static final int TYPE_ON_BOARD_POPUP = 1 << 5; |
| public static final int TYPE_DISCOVERY_BOUNCE = 1 << 6; |
| public static final int TYPE_SNACKBAR = 1 << 7; |
| public static final int TYPE_LISTENER = 1 << 8; |
| public static final int TYPE_ALL_APPS_EDU = 1 << 9; |
| public static final int TYPE_DRAG_DROP_POPUP = 1 << 10; |
| |
| // Popups related to quickstep UI |
| public static final int TYPE_TASK_MENU = 1 << 11; |
| public static final int TYPE_OPTIONS_POPUP = 1 << 12; |
| public static final int TYPE_ICON_SURFACE = 1 << 13; |
| public static final int TYPE_OPTIONS_POPUP_DIALOG = 1 << 14; |
| |
| public static final int TYPE_PIN_WIDGET_FROM_EXTERNAL_POPUP = 1 << 15; |
| public static final int TYPE_WIDGETS_EDUCATION_DIALOG = 1 << 16; |
| public static final int TYPE_TASKBAR_EDUCATION_DIALOG = 1 << 17; |
| public static final int TYPE_TASKBAR_ALL_APPS = 1 << 18; |
| public static final int TYPE_ADD_TO_HOME_CONFIRMATION = 1 << 19; |
| public static final int TYPE_TASKBAR_OVERLAY_PROXY = 1 << 20; |
| public static final int TYPE_TASKBAR_PINNING_POPUP = 1 << 21; |
| public static final int TYPE_PIN_IME_POPUP = 1 << 22; |
| |
| public static final int TYPE_ALL = TYPE_FOLDER | TYPE_ACTION_POPUP |
| | TYPE_WIDGETS_BOTTOM_SHEET | TYPE_WIDGET_RESIZE_FRAME | TYPE_WIDGETS_FULL_SHEET |
| | TYPE_ON_BOARD_POPUP | TYPE_DISCOVERY_BOUNCE | TYPE_TASK_MENU |
| | TYPE_OPTIONS_POPUP | TYPE_SNACKBAR | TYPE_LISTENER | TYPE_ALL_APPS_EDU |
| | TYPE_ICON_SURFACE | TYPE_DRAG_DROP_POPUP | TYPE_PIN_WIDGET_FROM_EXTERNAL_POPUP |
| | TYPE_WIDGETS_EDUCATION_DIALOG | TYPE_TASKBAR_EDUCATION_DIALOG | TYPE_TASKBAR_ALL_APPS |
| | TYPE_OPTIONS_POPUP_DIALOG | TYPE_ADD_TO_HOME_CONFIRMATION |
| | TYPE_TASKBAR_OVERLAY_PROXY | TYPE_TASKBAR_PINNING_POPUP | TYPE_PIN_IME_POPUP; |
| |
| // Type of popups which should be kept open during launcher rebind |
| public static final int TYPE_REBIND_SAFE = TYPE_WIDGETS_FULL_SHEET |
| | TYPE_WIDGETS_BOTTOM_SHEET | TYPE_ON_BOARD_POPUP | TYPE_DISCOVERY_BOUNCE |
| | TYPE_ALL_APPS_EDU | TYPE_ICON_SURFACE | TYPE_WIDGETS_EDUCATION_DIALOG |
| | TYPE_TASKBAR_EDUCATION_DIALOG | TYPE_TASKBAR_ALL_APPS | TYPE_OPTIONS_POPUP_DIALOG |
| | TYPE_TASKBAR_OVERLAY_PROXY | TYPE_PIN_IME_POPUP; |
| |
| /** Type of popups that should get exclusive accessibility focus. */ |
| public static final int TYPE_ACCESSIBLE = TYPE_ALL & ~TYPE_DISCOVERY_BOUNCE & ~TYPE_LISTENER |
| & ~TYPE_ALL_APPS_EDU & ~TYPE_TASKBAR_ALL_APPS & ~TYPE_PIN_IME_POPUP |
| & ~TYPE_WIDGET_RESIZE_FRAME; |
| |
| // These view all have particular operation associated with swipe down interaction. |
| public static final int TYPE_STATUS_BAR_SWIPE_DOWN_DISALLOW = TYPE_WIDGETS_BOTTOM_SHEET | |
| TYPE_WIDGETS_FULL_SHEET | TYPE_WIDGET_RESIZE_FRAME | TYPE_ON_BOARD_POPUP | |
| TYPE_DISCOVERY_BOUNCE | TYPE_TASK_MENU | TYPE_DRAG_DROP_POPUP; |
| |
| // Floating views that are exclusive to the taskbar overlay window. |
| public static final int TYPE_TASKBAR_OVERLAYS = |
| TYPE_TASKBAR_ALL_APPS | TYPE_TASKBAR_EDUCATION_DIALOG; |
| |
| // Floating views that a TouchController should not try to intercept touches from. |
| public static final int TYPE_TOUCH_CONTROLLER_NO_INTERCEPT = TYPE_ALL & ~TYPE_DISCOVERY_BOUNCE |
| & ~TYPE_LISTENER & ~TYPE_TASKBAR_OVERLAYS; |
| |
| public static final int TYPE_ALL_EXCEPT_ON_BOARD_POPUP = TYPE_ALL & ~TYPE_ON_BOARD_POPUP |
| & ~TYPE_PIN_IME_POPUP; |
| |
| protected boolean mIsOpen; |
| |
| public AbstractFloatingView(Context context, AttributeSet attrs) { |
| super(context, attrs); |
| } |
| |
| public AbstractFloatingView(Context context, AttributeSet attrs, int defStyleAttr) { |
| super(context, attrs, defStyleAttr); |
| } |
| |
| /** |
| * We need to handle touch events to prevent them from falling through to the workspace below. |
| */ |
| @SuppressLint("ClickableViewAccessibility") |
| @Override |
| public boolean onTouchEvent(MotionEvent ev) { |
| return true; |
| } |
| |
| public final void close(boolean animate) { |
| animate &= areAnimatorsEnabled(); |
| if (mIsOpen) { |
| // Add to WW logging |
| } |
| handleClose(animate); |
| mIsOpen = false; |
| } |
| |
| protected abstract void handleClose(boolean animate); |
| |
| /** |
| * Creates a user-controlled animation to hint that the view will be closed if completed. |
| * @param distanceToMove The max distance that elements should move from their starting point. |
| */ |
| public void addHintCloseAnim( |
| float distanceToMove, Interpolator interpolator, PendingAnimation target) { } |
| |
| public final boolean isOpen() { |
| return mIsOpen; |
| } |
| |
| protected abstract boolean isOfType(@FloatingViewType int type); |
| |
| /** Return true if this view can consume back press. */ |
| public boolean canHandleBack() { |
| return true; |
| } |
| |
| @Override |
| public void onBackInvoked() { |
| close(true); |
| } |
| |
| @Override |
| public boolean onControllerTouchEvent(MotionEvent ev) { |
| return false; |
| } |
| |
| protected void announceAccessibilityChanges() { |
| Pair<View, String> targetInfo = getAccessibilityTarget(); |
| if (targetInfo == null || !isAccessibilityEnabled(getContext())) { |
| return; |
| } |
| sendCustomAccessibilityEvent( |
| targetInfo.first, TYPE_WINDOW_STATE_CHANGED, targetInfo.second); |
| |
| if (mIsOpen) { |
| getAccessibilityInitialFocusView().performAccessibilityAction( |
| AccessibilityNodeInfo.ACTION_ACCESSIBILITY_FOCUS, null); |
| } |
| ActivityContext.lookupContext(getContext()).getDragLayer() |
| .sendAccessibilityEvent(TYPE_WINDOW_CONTENT_CHANGED); |
| } |
| |
| protected Pair<View, String> getAccessibilityTarget() { |
| return null; |
| } |
| |
| /** Returns the View that Accessibility services should focus on first. */ |
| protected View getAccessibilityInitialFocusView() { |
| return this; |
| } |
| |
| /** |
| * Returns a view matching FloatingViewType and {@link #isOpen()} == true. |
| */ |
| public static <T extends AbstractFloatingView> T getOpenView( |
| ActivityContext activity, @FloatingViewType int type) { |
| return getView(activity, type, true /* mustBeOpen */); |
| } |
| |
| /** |
| * Returns whether there is at least one view of the given type where {@link #isOpen()} == true. |
| */ |
| public static boolean hasOpenView(ActivityContext activity, @FloatingViewType int type) { |
| return getOpenView(activity, type) != null; |
| } |
| |
| /** |
| * Returns a view matching FloatingViewType, and {@link #isOpen()} may be false (if animating |
| * closed). |
| */ |
| public static <T extends AbstractFloatingView> T getAnyView( |
| ActivityContext activity, @FloatingViewType int type) { |
| return getView(activity, type, false /* mustBeOpen */); |
| } |
| |
| private static <T extends AbstractFloatingView> T getView( |
| ActivityContext activity, @FloatingViewType int type, boolean mustBeOpen) { |
| BaseDragLayer dragLayer = activity.getDragLayer(); |
| if (dragLayer == null) return null; |
| // Iterate in reverse order. AbstractFloatingView is added later to the dragLayer, |
| // and will be one of the last views. |
| for (int i = dragLayer.getChildCount() - 1; i >= 0; i--) { |
| View child = dragLayer.getChildAt(i); |
| if (child instanceof AbstractFloatingView) { |
| AbstractFloatingView view = (AbstractFloatingView) child; |
| if (view.isOfType(type) && (!mustBeOpen || view.isOpen())) { |
| return (T) view; |
| } |
| } |
| } |
| return null; |
| } |
| |
| public static void closeOpenContainer(ActivityContext activity, |
| @FloatingViewType int type) { |
| AbstractFloatingView view = getOpenView(activity, type); |
| if (view != null) { |
| view.close(true); |
| } |
| } |
| |
| public static void closeOpenViews(ActivityContext activity, boolean animate, |
| @FloatingViewType int type) { |
| BaseDragLayer dragLayer = activity.getDragLayer(); |
| // Iterate in reverse order. AbstractFloatingView is added later to the dragLayer, |
| // and will be one of the last views. |
| for (int i = dragLayer.getChildCount() - 1; i >= 0; i--) { |
| View child = dragLayer.getChildAt(i); |
| if (child instanceof AbstractFloatingView) { |
| AbstractFloatingView abs = (AbstractFloatingView) child; |
| if (abs.isOfType(type)) { |
| abs.close(animate); |
| } |
| } |
| } |
| } |
| |
| public static void closeAllOpenViews(ActivityContext activity, boolean animate) { |
| closeOpenViews(activity, animate, TYPE_ALL); |
| activity.finishAutoCancelActionMode(); |
| } |
| |
| public static void closeAllOpenViews(ActivityContext activity) { |
| closeAllOpenViews(activity, true); |
| } |
| |
| public static void closeAllOpenViewsExcept(ActivityContext activity, boolean animate, |
| @FloatingViewType int type) { |
| closeOpenViews(activity, animate, TYPE_ALL & ~type); |
| activity.finishAutoCancelActionMode(); |
| } |
| |
| public static void closeAllOpenViewsExcept(ActivityContext activity, |
| @FloatingViewType int type) { |
| closeAllOpenViewsExcept(activity, true, type); |
| } |
| |
| public static AbstractFloatingView getTopOpenView(ActivityContext activity) { |
| return getTopOpenViewWithType(activity, TYPE_ALL); |
| } |
| |
| public static AbstractFloatingView getTopOpenViewWithType(ActivityContext activity, |
| @FloatingViewType int type) { |
| return getOpenView(activity, type); |
| } |
| |
| public boolean canInterceptEventsInSystemGestureRegion() { |
| return false; |
| } |
| } |