如何在Android Material3 Search Bar添加两个尾部图标

DevOps 小满

2026-7-18

Material 3 SearchBar 添加多个尾部图标实现思路

SearchBar的app:menu属性支持加载包含多个菜单项的menu资源，只需在menu文件中定义多个item，并通过app:showAsAction控制显示方式：

打开你的explorer_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">
    <!-- 第一个尾部图标，始终显示在SearchBar右侧 -->
    <item
        android:id="@+id/action_custom_icon"
        android:icon="@drawable/ic_custom_icon"
        android:title="自定义操作"
        app:showAsAction="always"/>
    <!-- 三点菜单图标，点击弹出下拉菜单 -->
    <item
        android:id="@+id/action_more"
        android:icon="@drawable/ic_more_vert"
        android:title="更多选项"
        app:showAsAction="never"/>
</menu>

app:showAsAction="always"：让图标直接显示在SearchBar尾部
app:showAsAction="never"：让图标以三点菜单形式隐藏，点击展开

保持你原有的布局代码不变，SearchBar会自动加载menu中的多个图标。

方法二：动态添加菜单项（代码层面控制）

如果需要在运行时动态添加或调整图标，可以通过SearchBar的getMenu()方法操作：

在Activity/Fragment的初始化代码中添加：

val searchBar = findViewById<SearchBar>(R.id.searchBar)
// 添加第一个自定义图标
searchBar.menu.add("自定义操作")
    .setIcon(R.drawable.ic_custom_icon)
    .setShowAsAction(MenuItem.SHOW_AS_ACTION_ALWAYS)
    .setOnMenuItemClickListener {
        // 处理点击事件
        true
    }
// 添加三点菜单
searchBar.menu.add("更多选项")
    .setIcon(R.drawable.ic_more_vert)
    .setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER)
    .setOnMenuItemClickListener {
        // 处理菜单点击
        true
    }