/* * Copyright (C) 2015 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.allapps; import android.content.Context; import android.graphics.Rect; import android.text.Editable; import android.text.TextWatcher; import android.view.KeyEvent; import android.view.View; import android.view.ViewGroup; import android.view.inputmethod.EditorInfo; import android.view.inputmethod.InputMethodManager; import android.widget.TextView; import android.widget.TextView.OnEditorActionListener; import com.android.launcher3.ExtendedEditText; import com.android.launcher3.Utilities; import com.android.launcher3.util.ComponentKey; import java.util.ArrayList; import java.util.List; /** * An interface to a search box that AllApps can command. */ public abstract class AllAppsSearchBarController implements TextWatcher, OnEditorActionListener, ExtendedEditText.OnBackKeyListener { private static final boolean ALLOW_SINGLE_APP_LAUNCH = true; protected AllAppsRecyclerView mAppsRecyclerView; protected AlphabeticalAppsList mApps; protected Callbacks mCb; protected ExtendedEditText mInput; protected DefaultAppSearchAlgorithm mSearchAlgorithm; protected InputMethodManager mInputMethodManager; /** * Sets the references to the apps model and the search result callback. */ public final void initialize( AlphabeticalAppsList apps, ExtendedEditText input, AllAppsRecyclerView recycleView, Callbacks cb) { mApps = apps; mCb = cb; mAppsRecyclerView = recycleView; mInput = input; mInput.addTextChangedListener(this); mInput.setOnEditorActionListener(this); mInput.setOnBackKeyListener(this); mInputMethodManager = (InputMethodManager) mInput.getContext().getSystemService(Context.INPUT_METHOD_SERVICE); mSearchAlgorithm = onInitializeSearch(); } /** * To be overridden by subclasses. This method will get called when the controller is set. */ protected DefaultAppSearchAlgorithm onInitializeSearch() { return null; } @Override public void beforeTextChanged(CharSequence s, int start, int count, int after) { // Do nothing } @Override public void onTextChanged(CharSequence s, int start, int before, int count) { // Do nothing } @Override public void afterTextChanged(final Editable s) { String query = s.toString(); if (query.isEmpty()) { mSearchAlgorithm.cancel(true); mCb.clearSearchResult(); } else { mSearchAlgorithm.cancel(false); mSearchAlgorithm.doSearch(query, mCb); } } @Override public boolean onEditorAction(TextView v, int actionId, KeyEvent event) { // Skip if we disallow app-launch-on-enter if (!ALLOW_SINGLE_APP_LAUNCH) { return false; } // Skip if it's not the right action if (actionId != EditorInfo.IME_ACTION_SEARCH) { return false; } // Skip if there are more than one icon if (mApps.getNumFilteredApps() > 1) { return false; } // Otherwise, find the first icon, or fallback to the search-market-view and launch it List items = mApps.getAdapterItems(); for (int i = 0; i < items.size(); i++) { AlphabeticalAppsList.AdapterItem item = items.get(i); switch (item.viewType) { case AllAppsGridAdapter.ICON_VIEW_TYPE: case AllAppsGridAdapter.SEARCH_MARKET_VIEW_TYPE: mAppsRecyclerView.getChildAt(i).performClick(); mInputMethodManager.hideSoftInputFromWindow(mInput.getWindowToken(), 0); return true; } } return false; } @Override public boolean onBackKey() { // Only hide the search field if there is no query, or if there // are no filtered results String query = Utilities.trim(mInput.getEditableText().toString()); if (query.isEmpty() || mApps.hasNoFilteredResults()) { reset(); return true; } return false; } /** * Resets the search bar state. */ public void reset() { unfocusSearchField(); mCb.clearSearchResult(); mInput.setText(""); mInputMethodManager.hideSoftInputFromWindow(mInput.getWindowToken(), 0); } protected void unfocusSearchField() { View nextFocus = mInput.focusSearch(View.FOCUS_DOWN); if (nextFocus != null) { nextFocus.requestFocus(); } } /** * Returns the search bar view. * @param parent the parent to attach the search bar view to. */ public View getView(ViewGroup parent) { return null; } /** * Focuses the search field to handle key events. */ public void focusSearchField() { mInput.requestFocus(); mInputMethodManager.showSoftInput(mInput, InputMethodManager.SHOW_IMPLICIT); } /** * Returns whether the search field is focused. */ public boolean isSearchFieldFocused() { return mInput.isFocused(); } /** * Returns whether the prediction bar should currently be visible depending on the state of * the search bar. */ public boolean shouldShowPredictionBar() { return false; } /** * Callback for getting search results. */ public interface Callbacks { /** * Called when the bounds of the search bar has changed. */ void onBoundsChanged(Rect newBounds); /** * Called when the search is complete. * * @param apps sorted list of matching components or null if in case of failure. */ void onSearchResult(String query, ArrayList apps); /** * Called when the search results should be cleared. */ void clearSearchResult(); } }