Android自定义Toolbar代码设置标题与SearchView重叠问题

问题核心原因 #

重叠问题来自两个配置冲突：

• 直接调用supportActionBar设置标题时，CollapsingToolbarLayout会默认接管Toolbar的标题绘制逻辑，两套标题绘制逻辑同时生效+位置计算未考虑底部固定SearchView的占位，就会出现位置重叠
• Toolbar如果使用match_parent高度，会撑满整个CollapsingToolbarLayout的可折叠区域，标题默认垂直居中的基准高度错误，自然会压到下方固定的SearchView

实现步骤（全程无需新增XML TextView控件） #

1. 现有布局控件属性调整（仅修改已有控件属性，不新增控件） #

对consultation.xml里已有的三个核心控件做如下属性配置：

• CollapsingToolbarLayout：开启标题接管，设置app:titleEnabled="true"
• Toolbar：高度固定为系统ActionBar高度，设置android:layout_height="?attr/actionBarSize"，不要使用match_parent
• SearchView：设置app:layout_collapseMode="pin"，保证折叠时固定在AppBar底部不位移

2. 业务代码替换（Kotlin） #

把你原来在ToolbarActivity.kt里的标题配置逻辑替换为如下代码，你原有的SearchView焦点交互逻辑可以完整保留：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val binding = ConsultationBinding.inflate(layoutInflater)
    setContentView(binding.root)

    // 绑定Toolbar与ActionBar
    setSupportActionBar(binding.toolbar)
    // 仅配置返回按钮，关闭ActionBar自带的标题绘制，完全交给CollapsingToolbarLayout处理
    supportActionBar?.apply {
        setDisplayHomeAsUpEnabled(true)
        setDisplayShowTitleEnabled(false)
    }

    // 核心标题配置：直接给CollapsingToolbarLayout设置标题，自动处理展开/折叠状态的标题位移动画
    binding.collapsingToolbarLayout.apply {
        title = "替换为你实际的页面标题"
        // 给展开状态的标题预留底部SearchView的占位空间，数值替换为你项目中SearchView的实际高度
        expandedTitleMarginBottom = resources.getDimensionPixelSize(R.dimen.search_view_height)
        // 配置折叠状态下标题和返回箭头垂直居左对齐
        collapsedTitleGravity = Gravity.START or Gravity.CENTER_VERTICAL
        // 按需配置标题颜色即可
        setExpandedTitleColor(ContextCompat.getColor(this@ToolbarActivity, R.color.black))
        setCollapsedTitleTextColor(ContextCompat.getColor(this@ToolbarActivity, R.color.black))
    }

    // 原有SearchView焦点逻辑保留即可，无需额外处理标题位置
    binding.searchView.setOnQueryTextFocusChangeListener { _, hasFocus ->
        if (hasFocus) {
            binding.appBarLayout.setExpanded(false, true)
            // 原有边距调整逻辑照常写
        }
    }
}

避坑说明 #

• 禁止同时给supportActionBar和CollapsingToolbarLayout设置标题，会触发双标题重叠问题
• 不需要额外给Toolbar设置标题监听或者手动处理标题位移，CollapsingToolbarLayout原生已经实现了展开/折叠的过渡动画
• 如果返回按钮和标题间距不符合预期，直接调用binding.toolbar.contentInsetStartWithNavigation = 0调整内边距即可，不需要新增布局控件

内容的提问来源于stack exchange，提问作者Compose Learner