/* * Copyright (C) 2008 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.views; import android.content.Context; import android.graphics.CornerPathEffect; import android.graphics.Paint; import android.graphics.drawable.ShapeDrawable; import android.os.Handler; import android.util.Log; import android.view.Gravity; import android.view.MotionEvent; import android.view.View; import android.view.ViewGroup; import android.widget.LinearLayout; import android.widget.TextView; import androidx.annotation.Nullable; import androidx.annotation.Px; import androidx.core.content.ContextCompat; import com.android.launcher3.AbstractFloatingView; import com.android.launcher3.BaseDraggingActivity; import com.android.launcher3.R; import com.android.launcher3.anim.Interpolators; import com.android.launcher3.dragndrop.DragLayer; import com.android.launcher3.graphics.TriangleShape; /** * A base class for arrow tip view in launcher */ public class ArrowTipView extends AbstractFloatingView { private static final String TAG = ArrowTipView.class.getSimpleName(); private static final long AUTO_CLOSE_TIMEOUT_MILLIS = 10 * 1000; private static final long SHOW_DELAY_MS = 200; private static final long SHOW_DURATION_MS = 300; private static final long HIDE_DURATION_MS = 100; protected final BaseDraggingActivity mActivity; private final Handler mHandler = new Handler(); private Runnable mOnClosed; public ArrowTipView(Context context) { super(context, null, 0); mActivity = BaseDraggingActivity.fromContext(context); init(context); } @Override public boolean onControllerInterceptTouchEvent(MotionEvent ev) { if (ev.getAction() == MotionEvent.ACTION_DOWN) { close(true); } return false; } @Override protected void handleClose(boolean animate) { if (mIsOpen) { if (animate) { animate().alpha(0f) .withLayer() .setStartDelay(0) .setDuration(HIDE_DURATION_MS) .setInterpolator(Interpolators.ACCEL) .withEndAction(() -> mActivity.getDragLayer().removeView(this)) .start(); } else { animate().cancel(); mActivity.getDragLayer().removeView(this); } if (mOnClosed != null) mOnClosed.run(); mIsOpen = false; } } @Override protected boolean isOfType(int type) { return (type & TYPE_ON_BOARD_POPUP) != 0; } private void init(Context context) { inflate(context, R.layout.arrow_toast, this); setOrientation(LinearLayout.VERTICAL); View dismissButton = findViewById(R.id.dismiss); dismissButton.setOnClickListener(view -> { handleClose(true); }); View arrowView = findViewById(R.id.arrow); ViewGroup.LayoutParams arrowLp = arrowView.getLayoutParams(); ShapeDrawable arrowDrawable = new ShapeDrawable(TriangleShape.create( arrowLp.width, arrowLp.height, false)); Paint arrowPaint = arrowDrawable.getPaint(); arrowPaint.setColor(ContextCompat.getColor(getContext(), R.color.arrow_tip_view_bg)); // The corner path effect won't be reflected in the shadow, but shouldn't be noticeable. arrowPaint.setPathEffect(new CornerPathEffect( context.getResources().getDimension(R.dimen.arrow_toast_corner_radius))); arrowView.setBackground(arrowDrawable); mIsOpen = true; mHandler.postDelayed(() -> handleClose(true), AUTO_CLOSE_TIMEOUT_MILLIS); } /** * Show Tip with specified string and Y location */ public ArrowTipView show(String text, int top) { return show(text, Gravity.CENTER_HORIZONTAL, 0, top); } /** * Show the ArrowTipView (tooltip) center, start, or end aligned. * * @param text The text to be shown in the tooltip. * @param gravity The gravity aligns the tooltip center, start, or end. * @param arrowMarginStart The margin from start to place arrow (ignored if center) * @param top The Y coordinate of the bottom of tooltip. * @return The tooltip. */ public ArrowTipView show(String text, int gravity, int arrowMarginStart, int top) { ((TextView) findViewById(R.id.text)).setText(text); ViewGroup parent = mActivity.getDragLayer(); parent.addView(this); DragLayer.LayoutParams params = (DragLayer.LayoutParams) getLayoutParams(); params.gravity = gravity; LinearLayout.LayoutParams lp = (LinearLayout.LayoutParams) findViewById( R.id.arrow).getLayoutParams(); lp.gravity = gravity; if (parent.getLayoutDirection() == LAYOUT_DIRECTION_RTL) { arrowMarginStart = parent.getMeasuredWidth() - arrowMarginStart; } if (gravity == Gravity.END) { lp.setMarginEnd(parent.getMeasuredWidth() - arrowMarginStart); } else if (gravity == Gravity.START) { lp.setMarginStart(arrowMarginStart); } requestLayout(); params.leftMargin = mActivity.getDeviceProfile().workspacePadding.left; params.rightMargin = mActivity.getDeviceProfile().workspacePadding.right; post(() -> setY(top - getHeight())); setAlpha(0); animate() .alpha(1f) .withLayer() .setStartDelay(SHOW_DELAY_MS) .setDuration(SHOW_DURATION_MS) .setInterpolator(Interpolators.DEACCEL) .start(); return this; } /** * Show the ArrowTipView (tooltip) custom aligned. * * @param text The text to be shown in the tooltip. * @param arrowXCoord The X coordinate for the arrow on the tip. The arrow is usually in the * center of ArrowTipView unless the ArrowTipView goes beyond screen margin. * @param yCoord The Y coordinate of the bottom of the tooltip. * @return The tool tip view. */ @Nullable public ArrowTipView showAtLocation(String text, int arrowXCoord, int yCoord) { ViewGroup parent = mActivity.getDragLayer(); @Px int parentViewWidth = parent.getWidth(); @Px int textViewWidth = getContext().getResources() .getDimensionPixelSize(R.dimen.widget_picker_education_tip_width); @Px int minViewMargin = getContext().getResources() .getDimensionPixelSize(R.dimen.widget_picker_education_tip_min_margin); if (parentViewWidth < textViewWidth + 2 * minViewMargin) { Log.w(TAG, "Cannot display tip on a small screen of size: " + parentViewWidth); return null; } TextView textView = findViewById(R.id.text); textView.setText(text); textView.setWidth(textViewWidth); parent.addView(this); requestLayout(); post(() -> setY(yCoord - getHeight())); post(() -> { float halfWidth = getWidth() / 2f; float xCoord; if (arrowXCoord - halfWidth < minViewMargin) { xCoord = minViewMargin; } else if (arrowXCoord + halfWidth > parentViewWidth - minViewMargin) { xCoord = parentViewWidth - minViewMargin - getWidth(); } else { xCoord = arrowXCoord - halfWidth; } setX(xCoord); findViewById(R.id.arrow).setX(arrowXCoord - xCoord); requestLayout(); }); setAlpha(0); animate() .alpha(1f) .withLayer() .setStartDelay(SHOW_DELAY_MS) .setDuration(SHOW_DURATION_MS) .setInterpolator(Interpolators.DEACCEL) .start(); return this; } /** * Register a callback fired when toast is hidden */ public ArrowTipView setOnClosedCallback(Runnable runnable) { mOnClosed = runnable; return this; } }