Добавление командных кнопок и обработка действий

Попробуйте Compose

Jetpack Compose – это рекомендуемый набор инструментов для создания пользовательского интерфейса в Android. Узнайте, как добавлять компоненты в Compose.

Динамическая верхняя панель приложения →

На панель приложения можно добавлять кнопки для действий пользователя. Эта функция позволяет размещать наиболее важные действия для текущего контекста в верхней части приложения. Например, в приложении для просмотра фотографий вверху могут отображаться кнопки Поделиться и Создать альбом, когда пользователь просматривает свою фотопленку. Когда пользователь просматривает отдельную фотографию, приложение может показывать кнопки Обрезать и Фильтр.

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

Рисунок 1. Значок действия в приложении Now in Android.

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

Все командные кнопки и другие элементы, доступные в меню действий, определяются в XML-файле ресурса меню. Чтобы добавить действия на панель действий, создайте новый XML-файл в каталоге res/menu/ вашего проекта.

Добавьте элемент <item> для каждого элемента, который вы хотите включить в панель действий, как показано в следующем примере XML-файла меню:

<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto">

    <!-- "Mark Favorite", must appear as action button if possible. -->
    <item
        android:id="@+id/action_favorite"
        android:icon="@drawable/ic_favorite_black_48dp"
        android:title="@string/action_favorite"
        app:showAsAction="ifRoom"/>

    <!-- Settings, must always be in the overflow. -->
    <item android:id="@+id/action_settings"
          android:title="@string/action_settings"
          app:showAsAction="never"/>

</menu>

Атрибут app:showAsAction указывает, будет ли действие показано в виде кнопки на панели приложения. Если вы установите значение app:showAsAction="ifRoom", как в примере с действием favorite, действие будет отображаться в виде кнопки, если для него есть место на панели приложения. Если места недостаточно, лишние действия отправляются в дополнительное меню. Если вы установите значение app:showAsAction="never", как в действии settings в примере кода, действие всегда будет отображаться в дополнительном меню, а не на панели приложения.

Если действие отображается на панели приложения, система использует значок действия в качестве кнопки действия. Множество полезных значков можно найти в значках Material Design.

Как реагировать на действия

Когда пользователь выбирает один из элементов панели приложения, система вызывает метод обратного вызова onOptionsItemSelected() объекта activity и передает объект MenuItem, чтобы указать, какой элемент был нажат. В реализации onOptionsItemSelected() вызовите метод MenuItem.getItemId(), чтобы определить, на какой элемент нажал пользователь. Возвращаемый идентификатор соответствует значению, которое вы указываете в атрибуте android:id элемента <item>.

Например, следующий фрагмент кода проверяет, какое действие выбирает пользователь. Если метод не распознает действие пользователя, он вызывает метод надкласса:

Kotlin

override fun onOptionsItemSelected(item: MenuItem) = when (item.itemId) {
    R.id.action_settings -> {
        // User chooses the "Settings" item. Show the app settings UI.
        true
    }

    R.id.action_favorite -> {
        // User chooses the "Favorite" action. Mark the current item as a
        // favorite.
        true
    }

    else -> {
        // The user's action isn't recognized.
        // Invoke the superclass to handle it.
        super.onOptionsItemSelected(item)
    }
}

Java

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.action_settings:
            // User chooses the "Settings" item. Show the app settings UI.
            return true;

        case R.id.action_favorite:
            // User chooses the "Favorite" action. Mark the current item as a
            // favorite.
            return true;

        default:
            // The user's action isn't recognized.
            // Invoke the superclass to handle it.
            return super.onOptionsItemSelected(item);

    }
}