Android开发：菜单栏Menu用法讲解

最新推荐文章于 2025-10-26 09:00:15 发布

原创最新推荐文章于 2025-10-26 09:00:15 发布 · 10w+ 阅读

58 ·

CC 4.0 BY-SA版权

文章标签：

#Android #Menu #菜单

Android 专栏收录该内容

10 篇文章

订阅专栏

本文详细介绍了Android应用中的菜单类型，包括选项菜单、上下文菜单和弹出菜单。重点讨论了如何使用XML定义菜单，包括在res/menu下创建XML文件，通过、和元素构建菜单结构。同时，展示了如何在Java代码中加载和处理菜单项，以及创建包含多级子菜单的选项菜单。最后，通过实例展示了菜单的显示效果。

菜单的分类

菜单是Android应用中非常重要且常见的组成部分，主要可以分为三类：选项菜单、上下文菜单/上下文操作模式以及弹出菜单。它们的主要区别如下：

选项菜单是一个应用的主菜单项，用于放置对应用产生全局影响的操作，如搜索/设置。
上下文菜单是用户长按某一元素时出现的浮动菜单。它提供的操作将影响所选内容，主要应用于列表中的每一项元素（如长按列表项弹出删除对话框）。上下文操作模式将在屏幕顶部栏（菜单栏）显示影响所选内容的操作选项，并允许用户选择多项，一般用于对列表类型的数据进行批量操作。
弹出菜单以垂直列表形式显示一系列操作选项，一般由某一控件触发，弹出菜单将显示在对应控件的上方或下方。它适用于提供与特定内容相关的大量操作。

使用XML定义Menu

理论上而言，使用XML和Java代码都可以创建Menu。但是在实际开发中，往往通过XML文件定义Menu，这样做有以下几个好处：

使用XML可以获得更清晰的菜单结构
将菜单内容与应用的逻辑代码分离
可以使用应用资源框架，为不同的平台版本、屏幕尺寸创建最合适的菜单（如对drawable、string等系统资源的使用）

要定义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文件中定义各个菜单项，具体代码如下：

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>

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

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

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

Java代码：

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater=getMenuInflater();
    inflater.inflate(R.menu.option_menu_normal,menu);
    return true;
}

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()){
        case R.id.option_normal_1:
            break;
        case R.id.option_normal_2:
            break;
        case R.id.option_normal_3:
            break;
        case R.id.option_normal_4:
            break;
        default:
            return super.onOptionsItemSelected(item);
    }
}

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

//获取MenuInflater
MenuInflater inflater=getMenuInflater();
//加载Menu资源
inflater.inflate(R.menu.option_menu_normal,menu);

需要注意的是，这个方法必须返回true，否则Menu将不会显示。在onOptionsItemSelected方法中，我们实现了菜单项的点击监听。

效果截图：

点击右上角三个点就可以展开菜单列表。

包含多级子菜单的选项菜单

我们在前面提到过，<item>是可以嵌套<menu>的，而<menu>又是<item>的容器。因此，我们可以在应用中实现具有层级结构的子菜单。下面给出一个实际的例子：

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_sub_file"
        android:title="文件"
        app:showAsAction="ifRoom">
        <menu>
            <item android:id="@+id/file_new"
                android:title="新建"/>
            <item android:id="@+id/file_save"
                android:title="保存"/>

            <item android:id="@+id/file_more"
                android:title="更多">
                <menu>
                    <item android:id="@+id/file_more_1"
                        android:title="更多1"/>
                    <item android:id="@+id/file_more_2"
                        android:title="更多2"/>

                    <item android:id="@+id/file_more_more"
                        android:title="更多更多">
                        <menu>
                            <item android:id="@+id/file_more_more_1"
                                android:title="更多更多1"/>
                            <item android:id="@+id/file_more_more_2"
                                android:title="更多更多2"/>
                        </menu>
                    </item>
                </menu>
            </item>
        </menu>
    </item>
</menu>

上面的代码实现了一个三级子菜单结构。理论上来说，子菜单的层级是没有限制的。但是在实际应用中，由于移动设备的显示特点，建议菜单层级不要超过两层，否则会给用户的操作带来诸多不便。

效果截图：