Android中软键盘弹出后如何强制隐藏ActionBar并保持隐藏状态

核心原因 #

尽管你在AndroidManifest.xml中配置了Theme.AppCompat.DayNight.NoActionBar主题，但部分系统版本或窗口调整逻辑可能绕过主题配置触发ActionBar自动显示；同时代码中混用actionBar和supportActionBar、调用时机不当也会导致隐藏失效。

解决方案 #

1. 强化主题配置，彻底禁用ActionBar

在res/values/styles.xml中显式禁用ActionBar和标题栏，避免系统兼容问题：

<style name="Theme.YourApp" parent="Theme.AppCompat.DayNight.NoActionBar">
    <!-- 显式禁用ActionBar -->
    <item name="windowActionBar">false</item>
    <!-- 隐藏标题栏 -->
    <item name="windowNoTitle">true</item>
    <!-- 其他主题属性配置 -->
</style>

2. 在Activity层面强制隐藏ActionBar

在宿主Activity的onCreate方法中直接设置，确保Activity启动时ActionBar就处于隐藏状态：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 强制隐藏supportActionBar
    supportActionBar?.hide()
    // 确保窗口不显示标题栏
    window.requestFeature(Window.FEATURE_NO_TITLE)
}

3. 配置软键盘窗口模式，避免触发ActionBar显示

在AndroidManifest.xml的对应Activity标签中添加windowSoftInputMode，调整软键盘弹出时的窗口行为：

<activity
    android:name=".YourActivity"
    android:theme="@style/Theme.YourApp"
    android:windowSoftInputMode="adjustPan|stateHidden">
    <!-- 其他配置 -->
</activity>

• adjustPan：窗口整体上移而非调整大小，避免系统因窗口尺寸变化触发ActionBar显示
• stateHidden：默认隐藏软键盘，可根据需求替换为stateUnchanged等

4. 修正Fragment中的代码逻辑

• 点击事件优化：替换toggleSoftInput为更精准的hideSoftInputFromWindow，确保软键盘隐藏逻辑可靠，同时统一使用supportActionBar：

view.setOnClickListener {
    val imm = context?.getSystemService(Activity.INPUT_METHOD_SERVICE) as InputMethodManager?
    // 针对当前窗口隐藏软键盘
    view.windowToken?.let { token ->
        imm?.hideSoftInputFromWindow(token, 0)
    }
    // 强制隐藏ActionBar
    (activity as? AppCompatActivity)?.supportActionBar?.hide()
}

• 新Fragment的onResume修正：移除无用的actionBar?.hide()（AppCompat主题下actionBar为null），只保留supportActionBar的调用：

override fun onResume() {
    super.onResume()
    (activity as? AppCompatActivity)?.supportActionBar?.hide()
}

5. 排查第三方库/导航组件的影响

如果使用了Navigation Component或其他UI库，检查是否有自动显示ActionBar的配置：

• 导航组件中，可在nav_graph.xml的目的地设置中添加app:defaultNavHost="true"，或在导航回调中强制隐藏ActionBar。

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