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
. Если в панели приложений нет места, приложение добавляет действие в меню переполнения.
Когда пользователь нажимает на значок или элемент меню, виджет расширяется, чтобы заполнить панель инструментов, позволяя пользователю взаимодействовать с ним.
Если вам нужно настроить действие, сделайте это в 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
для получения дополнительной информации о создании пользовательского поставщика действий.