Android Kotlin Fragment中ActionBar标题设置问题排查

1. 如何在Android Kotlin的Fragment中设置ActionBar标题？ #

在Fragment里设置ActionBar标题，核心是先拿到Activity的supportActionBar实例，再调用标题设置方法。这里给你两种常用且靠谱的实现方式：

• 方式一：在onActivityCreated中设置（推荐）
  这个生命周期方法会在Activity完全初始化后触发，能避免因Activity未就绪导致的异常：

override fun onActivityCreated(savedInstanceState: Bundle?) {
    super.onActivityCreated(savedInstanceState)
    // 安全转换Activity类型，避免空指针
    (activity as? AppCompatActivity)?.supportActionBar?.apply {
        setDisplayShowTitleEnabled(true) // 确保标题可显示
        title = "你的自定义标题"
    }
}

• 方式二：在onCreateView中设置
  如果要在加载布局时就设置标题，记得先确保Activity不为空：

override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
    val view = inflater.inflate(R.layout.fragment_your_layout, container, false)
    activity?.let {
        (it as AppCompatActivity).supportActionBar?.apply {
            setDisplayShowTitleEnabled(true)
            title = "你的自定义标题"
        }
    }
    return view
}

2. 你的代码为什么标题不显示？ #

看完你的代码，有两个关键问题导致标题无法正常显示：

问题1：ActionBar背景全透明，标题文字和背景融合 #

在MainActivity的onCreate里，你设置了：

actionBar.setBackgroundDrawable(ColorDrawable(Color.parseColor("#00FFFFFF")))

#00FFFFFF是全透明的ARGB值（第一个00代表Alpha通道完全透明），如果标题文字是默认的白色，而页面背景也是浅色，标题就会和背景完全重叠，肉眼根本看不到。

问题2：Fragment设置标题的时机过早，且存在不安全的非空断言 #

你在onCreateView里用了actionBar!!这种非空断言，一旦supportActionBar为空（比如Activity用了无ActionBar的主题），直接就会崩溃。而且onCreateView阶段Activity的UI还没完全就绪，此时设置ActionBar属性可能不会生效。

修复方案 #

按照以下步骤修改代码即可解决问题：

1. 修改MainActivity的ActionBar背景
   把全透明背景改成不透明或半透明的颜色，比如：

actionBar.setBackgroundDrawable(ColorDrawable(Color.parseColor("#2196F3"))) // 蓝色背景

2. 调整Fragment中设置标题的逻辑
   把设置标题的代码移到onActivityCreated中，并用安全调用替代非空断言：

override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
    setHasOptionsMenu(true)
    return inflater.inflate(R.layout.fragment_me, container, false)
}

override fun onActivityCreated(savedInstanceState: Bundle?) {
    super.onActivityCreated(savedInstanceState)
    (activity as MainActivity).supportActionBar?.apply {
        setDisplayShowTitleEnabled(true)
        setTitle("Tutorial")
        // 可选：如果图标挤压了标题空间，可以隐藏图标
        // setDisplayShowHomeEnabled(false)
        // setIcon(null)
    }
}

3. 可选：调整标题文字颜色
   如果标题和背景还是不匹配，可以在styles.xml中修改标题文字颜色：

<style name="AppTheme" parent="Theme.MaterialComponents.Light.DarkActionBar">
    <item name="android:actionBarStyle">@style/MyActionBarStyle</item>
</style>

<style name="MyActionBarStyle" parent="@style/Widget.MaterialComponents.ActionBar.Solid">
    <item name="android:titleTextColor">@android:color/white</item> <!-- 设置白色标题 -->
</style>

这样修改后，Fragment页面的标题应该就能正常显示了。

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