应用栏允许您为用户操作添加按钮。此功能允许您将当前上下文中最重要的操作放在应用的顶部。例如,当用户查看其照片卷时,照片浏览应用可能会在顶部显示分享和创建相册按钮。当用户查看单个照片时,应用可能会显示裁剪和滤镜按钮。
应用栏中的空间有限。如果应用声明的操作多于应用栏所能容纳的操作,则应用栏会将多余的操作发送到溢出菜单。应用还可以指定某个操作始终显示在溢出菜单中,而不是显示在应用栏中。
添加操作按钮
操作溢出菜单中提供的所有操作按钮和其他项目都在 XML 菜单资源中定义。要向操作栏添加操作,请在项目的 res/menu/
目录中创建一个新的 XML 文件。
为要包含在操作栏中的每个项目添加一个 <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"
设置为 — 如示例代码中的收藏操作 — 操作将显示为按钮(如果应用栏中有足够的空间)。如果没有足够的空间,则多余的操作将发送到溢出菜单。如果将 app:showAsAction="never"
设置为 — 如示例代码中的设置操作 — 操作将始终列在溢出菜单中,而不是显示在应用栏中。
如果操作显示在应用栏中,则系统会使用操作的图标作为操作按钮。您可以在 Material Icons 中找到许多有用的图标。
响应操作
当用户选择其中一个应用栏项目时,系统会调用活动的 onOptionsItemSelected()
回调方法,并传递一个 MenuItem
对象以指示哪个项目被点击。在 onOptionsItemSelected()
的实现中,调用 MenuItem.getItemId()
方法以确定哪个项目被点击。返回的 ID 与您在相应的 <item>
元素的 android:id
属性中声明的值匹配。
例如,以下代码片段检查用户选择了哪个操作。如果该方法无法识别用户的操作,则会调用超类方法
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); } }