如何实现SearchView点击展开时占满ActionBar全宽且隐藏其他菜单项

问题现象 #

配置可折叠SearchView时，预期点击搜索图标展开后能占满ActionBar全部宽度，实际效果为展开后ActionBar仍显示其他常驻菜单项，搜索栏宽度受限未达预期。

现有实现配置 #

菜单资源XML #

<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">
    <item
        android:id="@+id/action_settings"
        android:title="Settings"
        app:showAsAction="never"/>
    <item
        android:id="@+id/about"
        android:title="About"
        app:showAsAction="never"/>
    <item
        android:id="@+id/edit"
        android:icon="@drawable/ic_baseline_sort_24"
        app:showAsAction="always"
        android:title="Edit"/>
   
    <item android:id="@+id/search"
        android:title="search_title"
        android:icon="@drawable/ic_search"
        app:showAsAction="always|collapseActionView"
        app:actionViewClass="androidx.appcompat.widget.SearchView" />
</menu>

已尝试的代码逻辑 #

androidx.appcompat.widget.SearchView searchView = (androidx.appcompat.widget.SearchView) item.getActionView();
searchView.setMaxWidth(Integer.MAX_VALUE);

问题根因 #

当前实现仅设置了SearchView的最大宽度，但没有对SearchView的展开状态做联动处理：系统默认逻辑不会在SearchView展开时自动隐藏其他设置了showAsAction="always"的常驻菜单项，这部分控件会持续占位，导致SearchView无法占满ActionBar全部宽度。仅靠设置setMaxWidth无法绕过系统的菜单布局占位逻辑。

修复实现 #

• 保留现有SearchView的showAsAction="always|collapseActionView"配置，不要修改其他菜单项的showAsAction属性
• 给SearchView对应的菜单项绑定展开/折叠状态监听，在SearchView展开时临时隐藏所有非搜索相关的菜单项，收起时再恢复显示
• 确认SearchView的最大宽度配置生效，无主题层面的宽度限制

核心实现代码 #

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // 加载现有菜单资源
    getMenuInflater().inflate(R.menu.menu_main, menu);
    // 获取搜索菜单项和对应的SearchView实例
    MenuItem searchItem = menu.findItem(R.id.search);
    SearchView searchView = (SearchView) searchItem.getActionView();
    // 设置搜索栏最大宽度为满宽
    searchView.setMaxWidth(Integer.MAX_VALUE);

    // 绑定搜索视图状态监听
    searchItem.setOnActionExpandListener(new MenuItem.OnActionExpandListener() {
        @Override
        public boolean onMenuItemActionExpand(MenuItem item) {
            // 搜索展开时隐藏所有其他菜单项，释放ActionBar空间
            menu.findItem(R.id.edit).setVisible(false);
            menu.findItem(R.id.action_settings).setVisible(false);
            menu.findItem(R.id.about).setVisible(false);
            return true;
        }

        @Override
        public boolean onMenuItemActionCollapse(MenuItem item) {
            // 搜索收起时恢复所有其他菜单项的显示状态
            menu.findItem(R.id.edit).setVisible(true);
            menu.findItem(R.id.action_settings).setVisible(true);
            menu.findItem(R.id.about).setVisible(true);
            return true;
        }
    });
    return super.onCreateOptionsMenu(menu);
}

注意事项 #

• 不要直接把其他菜单项的showAsAction改成never，否则SearchView收起后这些菜单项会直接进入溢出菜单，无法在ActionBar上直接展示
• 如果使用Material3主题，需要检查主题配置中是否存在对SearchView的默认宽度硬编码限制，避免满宽设置失效
• 若需要搜索展开时完全隐藏ActionBar的标题、导航按钮，可在状态监听回调中同步调用ActionBar的相关API做适配

内容的提问来源于stack exchange，提问作者M Baig