summaryrefslogtreecommitdiff
path: root/src/com/android/launcher3/anim/KeyboardInsetAnimationCallback.java
blob: b911928e3615aa72637f0a5b34f105f5818663d2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
/*
 * Copyright (C) 2021 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.anim;

import android.os.Build;
import android.view.View;
import android.view.WindowInsets;
import android.view.WindowInsetsAnimation;

import androidx.annotation.RequiresApi;

import com.android.launcher3.Utilities;

import java.util.List;

/**
 * Callback that animates views above the IME.
 * <p>
 * The expected stages of a keyboard transition are:
 * <p>
 * <ul>
 *   <li>PREPARING: Keyboard insets haven't changed yet, but are about to.</li>
 *   <li>STARTED: Keyboard insets have temporarily changed to the end state, but not drawn.</li>
 *   <li>PROGRESSING: At least one frame of the animation has been drawn.</li>
 *   <li>FINISHED: Keyboard has reached its end state, and animation is complete.</li>
 * </ul>
 */
@RequiresApi(api = Build.VERSION_CODES.R)
public class KeyboardInsetAnimationCallback extends WindowInsetsAnimation.Callback {
    private final View mView;

    private float mInitialTranslation;
    private float mTerminalTranslation;

    public KeyboardInsetAnimationCallback(View view) {
        super(DISPATCH_MODE_STOP);
        mView = view;
    }

    @Override
    public void onPrepare(WindowInsetsAnimation animation) {
        mInitialTranslation = mView.getTranslationY();
    }

    @Override
    public WindowInsetsAnimation.Bounds onStart(WindowInsetsAnimation animation,
            WindowInsetsAnimation.Bounds bounds) {
        // Final insets have temporarily been applied, so store the current translation as final.
        mTerminalTranslation = mView.getTranslationY();
        // Reset the translation in case the view is drawn before onProgress gets called.
        mView.setTranslationY(mInitialTranslation);
        if (mView instanceof KeyboardInsetListener) {
            ((KeyboardInsetListener) mView).onTranslationStart();
        }
        return super.onStart(animation, bounds);
    }

    @Override
    public WindowInsets onProgress(WindowInsets windowInsets, List<WindowInsetsAnimation> list) {
        if (list.size() == 0) {
            mView.setTranslationY(mInitialTranslation);
            return windowInsets;
        }
        WindowInsetsAnimation animation = list.get(0);

        if (animation.getDurationMillis() > -1) {
            float progress = animation.getInterpolatedFraction();
            mView.setTranslationY(
                    Utilities.mapRange(progress, mInitialTranslation, mTerminalTranslation));
        } else {
            // Manually controlled animation: Set translation to keyboard height.
            int translationY = -windowInsets.getInsets(WindowInsets.Type.ime()).bottom;
            if (mView.getParent() instanceof View) {
                // Offset any translation of the parent (e.g. All Apps parallax).
                translationY -= ((View) mView.getParent()).getTranslationY();
            }
            mView.setTranslationY(translationY);
        }

        return windowInsets;
    }

    @Override
    public void onEnd(WindowInsetsAnimation animation) {
        if (mView instanceof KeyboardInsetListener) {
            ((KeyboardInsetListener) mView).onTranslationEnd();
        }
        super.onEnd(animation);
    }

    /**
     * Interface Allowing views to listen for keyboard translation events
     */
    public interface KeyboardInsetListener {
        /**
         * Called from {@link KeyboardInsetAnimationCallback#onStart}
         */
        void onTranslationStart();

        /**
         * Called from {@link KeyboardInsetAnimationCallback#onEnd}
         */
        void onTranslationEnd();
    }
}