1 /*
2  * Copyright (C) 2015 The Android Open Source Project
3  *
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 
17 package com.android.launcher3.accessibility;
18 
19 import android.content.Context;
20 import android.graphics.Rect;
21 import android.text.TextUtils;
22 import android.view.View;
23 
24 import com.android.launcher3.AppInfo;
25 import com.android.launcher3.CellLayout;
26 import com.android.launcher3.FolderInfo;
27 import com.android.launcher3.ItemInfo;
28 import com.android.launcher3.Launcher;
29 import com.android.launcher3.R;
30 import com.android.launcher3.WorkspaceItemInfo;
31 import com.android.launcher3.accessibility.LauncherAccessibilityDelegate.DragType;
32 import com.android.launcher3.dragndrop.DragLayer;
33 
34 import androidx.core.view.accessibility.AccessibilityNodeInfoCompat;
35 
36 /**
37  * Implementation of {@link DragAndDropAccessibilityDelegate} to support DnD on workspace.
38  */
39 public class WorkspaceAccessibilityHelper extends DragAndDropAccessibilityDelegate {
40 
41     private final Rect mTempRect = new Rect();
42     private final int[] mTempCords = new int[2];
43 
WorkspaceAccessibilityHelper(CellLayout layout)44     public WorkspaceAccessibilityHelper(CellLayout layout) {
45         super(layout);
46     }
47 
48     /**
49      * Find the virtual view id corresponding to the top left corner of any drop region by which
50      * the passed id is contained. For an icon, this is simply
51      */
52     @Override
intersectsValidDropTarget(int id)53     protected int intersectsValidDropTarget(int id) {
54         int mCountX = mView.getCountX();
55         int mCountY = mView.getCountY();
56 
57         int x = id % mCountX;
58         int y = id / mCountX;
59         LauncherAccessibilityDelegate.DragInfo dragInfo = mDelegate.getDragInfo();
60 
61         if (dragInfo.dragType == DragType.WIDGET && !mView.acceptsWidget()) {
62             return INVALID_POSITION;
63         }
64 
65         if (dragInfo.dragType == DragType.WIDGET) {
66             // For a widget, every cell must be vacant. In addition, we will return any valid
67             // drop target by which the passed id is contained.
68             boolean fits = false;
69 
70             // These represent the amount that we can back off if we hit a problem. They
71             // get consumed as we move up and to the right, trying new regions.
72             int spanX = dragInfo.info.spanX;
73             int spanY = dragInfo.info.spanY;
74 
75             for (int m = 0; m < spanX; m++) {
76                 for (int n = 0; n < spanY; n++) {
77 
78                     fits = true;
79                     int x0 = x - m;
80                     int y0 = y - n;
81 
82                     if (x0 < 0 || y0 < 0) continue;
83 
84                     for (int i = x0; i < x0 + spanX; i++) {
85                         if (!fits) break;
86                         for (int j = y0; j < y0 + spanY; j++) {
87                             if (i >= mCountX || j >= mCountY || mView.isOccupied(i, j)) {
88                                 fits = false;
89                                 break;
90                             }
91                         }
92                     }
93                     if (fits) {
94                         return x0 + mCountX * y0;
95                     }
96                 }
97             }
98             return INVALID_POSITION;
99         } else {
100             // For an icon, we simply check the view directly below
101             View child = mView.getChildAt(x, y);
102             if (child == null || child == dragInfo.item) {
103                 // Empty cell. Good for an icon or folder.
104                 return id;
105             } else if (dragInfo.dragType != DragType.FOLDER) {
106                 // For icons, we can consider cells that have another icon or a folder.
107                 ItemInfo info = (ItemInfo) child.getTag();
108                 if (info instanceof AppInfo || info instanceof FolderInfo ||
109                         info instanceof WorkspaceItemInfo) {
110                     return id;
111                 }
112             }
113             return INVALID_POSITION;
114         }
115     }
116 
117     @Override
getConfirmationForIconDrop(int id)118     protected String getConfirmationForIconDrop(int id) {
119         int x = id % mView.getCountX();
120         int y = id / mView.getCountX();
121         LauncherAccessibilityDelegate.DragInfo dragInfo = mDelegate.getDragInfo();
122 
123         View child = mView.getChildAt(x, y);
124         if (child == null || child == dragInfo.item) {
125             return mContext.getString(R.string.item_moved);
126         } else {
127             ItemInfo info = (ItemInfo) child.getTag();
128             if (info instanceof AppInfo || info instanceof WorkspaceItemInfo) {
129                 return mContext.getString(R.string.folder_created);
130 
131             } else if (info instanceof FolderInfo) {
132                 return mContext.getString(R.string.added_to_folder);
133             }
134         }
135         return "";
136     }
137 
138     @Override
onPopulateNodeForVirtualView(int id, AccessibilityNodeInfoCompat node)139     protected void onPopulateNodeForVirtualView(int id, AccessibilityNodeInfoCompat node) {
140         super.onPopulateNodeForVirtualView(id, node);
141 
142 
143         // ExploreByTouchHelper does not currently handle view scale.
144         // Update BoundsInScreen to appropriate value.
145         DragLayer dragLayer = Launcher.getLauncher(mView.getContext()).getDragLayer();
146         mTempCords[0] = mTempCords[1] = 0;
147         float scale = dragLayer.getDescendantCoordRelativeToSelf(mView, mTempCords);
148 
149         node.getBoundsInParent(mTempRect);
150         mTempRect.left = mTempCords[0] + (int) (mTempRect.left * scale);
151         mTempRect.right = mTempCords[0] + (int) (mTempRect.right * scale);
152         mTempRect.top = mTempCords[1] + (int) (mTempRect.top * scale);
153         mTempRect.bottom = mTempCords[1] + (int) (mTempRect.bottom * scale);
154         node.setBoundsInScreen(mTempRect);
155     }
156 
157     @Override
getLocationDescriptionForIconDrop(int id)158     protected String getLocationDescriptionForIconDrop(int id) {
159         int x = id % mView.getCountX();
160         int y = id / mView.getCountX();
161         LauncherAccessibilityDelegate.DragInfo dragInfo = mDelegate.getDragInfo();
162 
163         View child = mView.getChildAt(x, y);
164         if (child == null || child == dragInfo.item) {
165             return mView.getItemMoveDescription(x, y);
166         } else {
167             return getDescriptionForDropOver(child, mContext);
168         }
169     }
170 
getDescriptionForDropOver(View overChild, Context context)171     public static String getDescriptionForDropOver(View overChild, Context context) {
172         ItemInfo info = (ItemInfo) overChild.getTag();
173         if (info instanceof WorkspaceItemInfo) {
174             return context.getString(R.string.create_folder_with, info.title);
175         } else if (info instanceof FolderInfo) {
176             if (TextUtils.isEmpty(info.title)) {
177                 // Find the first item in the folder.
178                 FolderInfo folder = (FolderInfo) info;
179                 WorkspaceItemInfo firstItem = null;
180                 for (WorkspaceItemInfo shortcut : folder.contents) {
181                     if (firstItem == null || firstItem.rank > shortcut.rank) {
182                         firstItem = shortcut;
183                     }
184                 }
185 
186                 if (firstItem != null) {
187                     return context.getString(R.string.add_to_folder_with_app, firstItem.title);
188                 }
189             }
190             return context.getString(R.string.add_to_folder, info.title);
191         }
192         return "";
193     }
194 }
195