320 lines
12 KiB
Java
320 lines
12 KiB
Java
|
/*
|
||
|
* 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_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 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;
|
||
|
|
||
|
public static final int TYPE_ACCESSIBLE = TYPE_ALL & ~TYPE_DISCOVERY_BOUNCE & ~TYPE_LISTENER
|
||
|
& ~TYPE_ALL_APPS_EDU;
|
||
|
|
||
|
// 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;
|
||
|
|
||
|
public static final int TYPE_ALL_EXCEPT_ON_BOARD_POPUP = TYPE_ALL & ~TYPE_ON_BOARD_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;
|
||
|
}
|
||
|
}
|