Используйте представления действий и поставщиков действий.

Toolbar библиотеки Androidx предоставляет пользователям различные способы взаимодействия с вашим приложением. Добавить и обрабатывать действия описывает, как определить действие , которое может быть кнопкой или элементом меню. В этом документе описывается, как добавить два универсальных компонента:

  • Представление действия - это действие, которое обеспечивает богатую функциональность в панели приложений. Например, представление о поиске позволяет пользователю вводить свой текст поиска в панели приложений без необходимости менять действия или фрагменты.
  • Поставщик действий - это действие с собственным индивидуальным макетом. Действие изначально появляется как кнопка или пункт меню; когда пользователь касается действия, поставщик действия управляет поведением действия любым способом, который вы определяете. Например, поставщик действий может реагировать на нажатие, отображая меню.

AndroidX предоставляет несколько специализированных виджетов представления действий и поставщиков действий. Например, виджет SearchView реализует представление действий для ввода поисковых запросов. Виджет ShareActionProvider реализует поставщик действий для обмена информацией с другими приложениями. Вы также можете определить свои собственные представления действий и поставщиков действий.

Добавить представление действий

Чтобы добавить представление действий, создайте элемент <item> в ресурсе меню панели инструментов, как описано в разделе Добавление и обработка действий . Добавьте к элементу <item> один из следующих атрибутов:

  • actionViewClass : класс виджета, реализующего действие.
  • actionLayout : ресурс макета, описывающий компоненты действия.

Установите для атрибута showAsAction значение "ifRoom|collapseActionView" или "never|collapseActionView" . Флаг collapseActionView указывает, как отображать виджет, когда пользователь с ним не взаимодействует. Если виджет находится на панели приложения, приложение отображает виджет в виде значка. Если виджет находится в дополнительном меню, приложение отображает виджет как элемент меню. Когда пользователь взаимодействует с представлением действий, оно расширяется и заполняет панель приложения.

Например, следующий код добавляет виджет SearchView в строку приложений:

<item android:id="@+id/action_search"
     android:title="@string/action_search"
     android:icon="@drawable/ic_search"
     app:showAsAction="ifRoom|collapseActionView"
     app:actionViewClass="androidx.appcompat.widget.SearchView" />

Если пользователь не взаимодействует с виджетом, приложение отображает виджет как значок, указанный android:icon . Если в панели приложений нет места, приложение добавляет действие в меню переполнения.

Изображение, показывающее строку поиска с ведущими и запекающими значками.
Рисунок 1. Поиск панели с ведущими и следственными значками.

Когда пользователь нажимает на значок или элемент меню, виджет расширяется, чтобы заполнить панель инструментов, позволяя пользователю взаимодействовать с ним.

Изображение, показывающее открытое представление поиска после того, как строка поиска сосредоточена.
Рисунок 2. Вид поиска открывается после того, как строка поиска сосредоточена.

Если вам нужно настроить действие, сделайте это в onCreateOptionsMenu() вызове вашей деятельности. Вы можете получить ссылку на объект представления действия, вызывая метод getActionView() . Например, следующий код получает ссылку на объект для виджета SearchView , определенного в предыдущем примере кода:

Котлин

override fun onCreateOptionsMenu(menu: Menu?): Boolean {
    menuInflater.inflate(R.menu.main_activity_actions, menu)

    val searchItem = menu?.findItem(R.id.action_search)
    val searchView = searchItem?.actionView as SearchView

    // Configure the search info and add any event listeners.

    return super.onCreateOptionsMenu(menu)
}

Ява

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.main_activity_actions, menu);

    MenuItem searchItem = menu.findItem(R.id.action_search);
    SearchView searchView =
            (SearchView) searchItem.getActionView();

    // Configure the search info and add any event listeners.

    return super.onCreateOptionsMenu(menu);
}

Реагировать на расширение представления действий

Если элемент <item> действия имеет флаг collapseActionView , приложение отображает представление действия в виде значка, пока пользователь не взаимодействует с представлением действия. Когда пользователь нажимает на значок, встроенный обработчик для onOptionsItemSelected() расширяет представление действия. Если ваш подкласс активности переопределяет метод onOptionsItemSelected() , ваш метод переопределения должен вызывать super.onOptionsItemSelected() , чтобы суперкласс мог расширить представление действий.

Если вы хотите что-то сделать, когда действие развернуто или свернуто, вы можете определить класс, реализующий MenuItem.OnActionExpandListener , и передать член этого класса в setOnActionExpandListener() . Например, вы можете обновить деятельность на основе того, расширяется ли представление действия или разрушено. Следующий фрагмент кода показывает, как определить и передать слушателя:

Котлин

override fun onCreateOptionsMenu(menu: Menu?): Boolean {
    menuInflater.inflate(R.menu.options, menu)

    // Define the listener.
    val expandListener = object : MenuItem.OnActionExpandListener {
        override fun onMenuItemActionCollapse(item: MenuItem): Boolean {
            // Do something when the action item collapses.
            return true // Return true to collapse the action view.
        }

        override fun onMenuItemActionExpand(item: MenuItem): Boolean {
            // Do something when it expands.
            return true // Return true to expand the action view.
        }
    }

    // Get the MenuItem for the action item.
    val actionMenuItem = menu?.findItem(R.id.myActionItem)

    // Assign the listener to that action item.
    actionMenuItem?.setOnActionExpandListener(expandListener)

    // For anything else you have to do when creating the options menu,
    // do the following:

    return true
}

Ява

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.options, menu);

    // Define the listener.
    OnActionExpandListener expandListener = new OnActionExpandListener() {
        @Override
        public boolean onMenuItemActionCollapse(MenuItem item) {
            // Do something when the action item collapses.
            return true;  // Return true to collapse action view.
        }

        @Override
        public boolean onMenuItemActionExpand(MenuItem item) {
            // Do something when it expands.
            return true;  // Return true to expand the action view.
        }
    };

    // Get the MenuItem for the action item.
    MenuItem actionMenuItem = menu.findItem(R.id.myActionItem);

    // Assign the listener to that action item.
    MenuItemCompat.setOnActionExpandListener(actionMenuItem, expandListener);

    // For anything else you have to do when creating the options menu,
    // do the following:

    return true;
}

Добавить поставщика действий

Чтобы объявить поставщика действий, создайте элемент <item> в ресурсе меню панели инструментов, как описано в Add and Have Goans . Добавьте атрибут actionProviderClass и установите его на полностью квалифицированное имя класса для класса поставщика действий.

Например, следующий код объявляет ShareActionProvider — виджет, определенный в библиотеке AndroidX, который позволяет вашему приложению обмениваться данными с другими приложениями:

<item android:id="@+id/action_share"
    android:title="@string/share"
    app:showAsAction="ifRoom"
    app:actionProviderClass="androidx.appcompat.widget.ShareActionProvider"/>

В этом случае не нужно объявлять значок для виджета, поскольку ShareActionProvider предоставляет свою собственную графику. Если вы используете пользовательское действие, объявите значок.

Дополнительные ресурсы

  • См. ShareActionProvider для примера добавления действия в верхней панели приложений.
  • См. ActionProvider для получения дополнительной информации о создании пользовательского поставщика действий.