Android Menu的用法

使用xml定义Menu

理论上而言,使用xml和java代码都可以创建Menu.但是在实际开发中，往往通过xml定义Menu,这样做的好处有

• 使用xml可以获得更清晰的菜单结构
• 将菜单内容与应用逻辑代码分离
• 可以使用应用资源框架，为不同的平台版本、屏幕尺寸创建最合适的菜单

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

    <item android:id="@+id/option_normal_1"
        android:icon="@mipmap/ic_vpn_key_white_24dp"
        android:title="普通菜单1"
        app:showAsAction="ifRoom"/>

    <item android:id="@+id/option_normal_2"
        android:icon="@mipmap/ic_email_white_24dp"
        android:title="普通菜单2"
        app:showAsAction="always"/>

    <item android:id="@+id/option_normal_3"
        android:icon="@mipmap/ic_vpn_key_white_24dp"
        android:title="普通菜单3"
        app:showAsAction="withText|always"/>

    <item android:id="@+id/option_normal_4"
        android:title="普通菜单4"
        app:showAsAction="never"/>
</menu>

定义Menu,我们首先要在res文件下新建menu文件夹，它将用于存储与Menu相关的XML文件
我们可以使用menu 、item、group三种XML元素定义Menu。

menu是菜单项的容器。menu元素必须是该文件的根节点，并且能够包含一个或多个item和group元素。
item是菜单项，用于定义MenuItem，可以嵌套menu元素，以便创建子菜单。
group是item元素的不可见容器（可选）。可以使用它对菜单项进行分组，使一组菜单项共享可用性和可见性等属性。

其中，item是我们主要需要关注的元素，它的常见属性如下：

android:id：菜单项(MenuItem)的唯一标识
android:icon：菜单项的图标（可选）
android:title：菜单项的标题（必选）
android:showAsAction：指定菜单项的显示方式。常用的有ifRoom、never、always、withText，多个属性值之间可以使用|隔开。

可以看到，我们在XML文件中定义了四个普通的菜单项。同时，每一个都有一个独特的showAsAction属性。

我们需要知道，菜单栏中的菜单项会分为两个部分。一部分可以直接在菜单栏中看见，我们可以称之为常驻菜单；另一部分会被集中收纳到溢出菜单中（就是菜单栏右侧的小点状图标）。一般情况下，常驻菜单项以图标形式显示（需要定义icon属性），而溢出菜单项则以文字形式显示（通过title属性定义）。showAsAction的差异如下所示：

always：菜单项永远不会被收纳到溢出菜单中，因此在菜单项过多的情况下可能超出菜单栏的显示范围。
ifRoom：在空间足够时，菜单项会显示在菜单栏中，否则收纳入溢出菜单中。
withText：无论菜单项是否定义了icon属性，都只会显示它的标题，而不会显示图标。使用这种方式的菜单项默认会被收纳入溢出菜单中。
never：菜单项永远只会出现在溢出菜单中。

现在我们已经在XML文件中将Menu定义完毕了，接下来还需要在Java代码中进行加载，

@Override
  public boolean onCreateOptionsMenu(Menu menu) {
      getMenuInflater().inflate(R.menu.main_menu_home, menu);
      return true;
  }

  @Override
  public boolean onOptionsItemSelected(MenuItem item) {
      switch (item.getItemId()) {
          case R.id.option_normal_1:
              ToastUtil.showToast(this,"二维码扫描");
              break;
          case R.id.option_normal_2:
              ActivityUtils.startActivity(SelectFollowActivity.class);
              break;
          default:
              break;
      }
      return super.onOptionsItemSelected(item);
  }

可以看见，我们在Activity中重写了onCreateOptionsMenu方法，在这个方法中完成加载Menu资源的操作，关键代码如下：

getMenuInflater().inflate(R.menu.main_menu_home, menu);
return true;

需要注意的是，这个方法必须返回true，否则Menu将不会显示。

在onOptionsItemSelected方法中，我们实现了菜单项的点击监听。可以看见，这里是通过MenuItem的id进行区分的，对应着XML文件中的id属性。每次处理完点击事件后，记得要返回true，对系统而言这次点击事情才算是真正结束了。此外，在default分支下，推荐调用父类的默认实现，即super.onOptionsItemSelected(item)，避免在多个Activity使用公有父类的情况下菜单项点击事件无法触发（下文会详细解释）。

效果截图：