在Android应用开发中，Toolbar是替代传统ActionBar的常用导航组件，而menu.xml文件是配置Toolbar菜单项的核心资源文件，通过规范的XML编写可以实现各类菜单功能。
menu.xml的基础结构
menu.xml文件需要放在res/menu目录下，如果目录下没有menu文件夹可以手动创建。最基础的menu.xml结构如下：
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item
android:id="@+id/menu_item_search"
android:title="搜索"
android:icon="@drawable/ic_search"
app:showAsAction="ifRoom"/>
<item
android:id="@+id/menu_item_setting"
android:title="设置"
app:showAsAction="never"/>
</menu>
核心标签与属性说明
- menu标签：根标签，所有菜单项都需要放在这个标签内部，需要声明android和app两个命名空间。
- item标签：单个菜单项的配置标签，每个item对应一个菜单选项。
- android:id：菜单项的唯一标识，用于在代码中识别点击的菜单项。
- android:title：菜单项显示的文本，当菜单项以溢出菜单形式展示时会显示该文本。
- android:icon：菜单项的图标，当菜单项显示在Toolbar上时优先展示图标。
- app:showAsAction：控制菜单项的显示位置，常用取值有ifRoom（Toolbar空间足够时直接显示）、never（始终放在溢出菜单中）、always（始终直接显示在Toolbar上）。
为Toolbar加载menu.xml菜单
编写好menu.xml之后，需要将其关联到Toolbar上，通常有两种常见场景：使用系统ActionBar或者自定义Toolbar。
自定义Toolbar加载菜单
首先在布局文件中添加Toolbar组件：
<androidx.appcompat.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="@color/primary"
app:title="首页"/>
然后在对应的Activity中完成菜单加载和点击处理：
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 设置自定义Toolbar为ActionBar
Toolbar toolbar = findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// 加载res/menu下的menu_main.xml文件
getMenuInflater().inflate(R.menu.menu_main, menu);
return true;
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
// 处理菜单项点击事件
int id = item.getItemId();
if (id == R.id.menu_item_search) {
// 搜索菜单项点击逻辑
Toast.makeText(this, "点击了搜索", Toast.LENGTH_SHORT).show();
return true;
} else if (id == R.id.menu_item_setting) {
// 设置菜单项点击逻辑
Toast.makeText(this, "点击了设置", Toast.LENGTH_SHORT).show();
return true;
}
return super.onOptionsItemSelected(item);
}
}
使用系统ActionBar加载菜单
如果不需要自定义Toolbar，直接使用系统ActionBar的话，只需要在Activity中重写onCreateOptionsMenu和onOptionsItemSelected方法即可，不需要额外设置Toolbar，系统会自动加载菜单到顶部ActionBar中。
进阶配置技巧
分组菜单配置
如果需要对菜单项进行分组管理，可以使用group标签，分组后的菜单项可以统一设置属性：
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<group android:id="@+id/group_edit">
<item
android:id="@+id/menu_copy"
android:title="复制"
app:showAsAction="never"/>
<item
android:id="@+id/menu_paste"
android:title="粘贴"
app:showAsAction="never"/>
</group>
<item
android:id="@+id/menu_share"
android:title="分享"
android:icon="@drawable/ic_share"
app:showAsAction="ifRoom"/>
</menu>
动态修改菜单项
有时候需要根据业务场景动态修改菜单项的状态，比如登录后显示用户信息菜单，未登录时显示登录菜单，可以在onPrepareOptionsMenu方法中处理：
@Override
public boolean onPrepareOptionsMenu(Menu menu) {
MenuItem loginItem = menu.findItem(R.id.menu_login);
MenuItem userItem = menu.findItem(R.id.menu_user);
// 假设isLogin是判断登录状态的变量
if (isLogin) {
loginItem.setVisible(false);
userItem.setVisible(true);
} else {
loginItem.setVisible(true);
userItem.setVisible(false);
}
return super.onPrepareOptionsMenu(menu);
}
如果需要主动触发菜单刷新，可以调用invalidateOptionsMenu()方法，系统会重新调用onPrepareOptionsMenu更新菜单状态。
常见问题说明
注意：如果使用AndroidX库，Toolbar需要导入androidx.appcompat.widget.Toolbar，对应的Activity需要继承AppCompatActivity，否则可能出现菜单加载失败的问题。
另外，当app:showAsAction设置为ifRoom时，如果Toolbar空间不足，菜单项会自动放入溢出菜单，溢出菜单的图标不会显示，只会显示title文本，因此建议同时配置title和icon属性保证不同场景下的显示正常。