如何在ConstraintLayout中根据软键盘状态灵活隐藏/显示视图

我明白你想要实现的效果——软键盘弹出时隐藏Logo，就像Payoneer应用那样，而且你已经尝试用ConstraintLayout结合EditText焦点监听的方式，但觉得ConstraintLayout隐藏视图时不够灵活。咱们来看看怎么优化这个方案，或者换更合适的实现方式：

方案1：优化ConstraintLayout的过渡动画（解决"不灵活"问题） #

你觉得ConstraintLayout隐藏视图生硬，大概率是直接设置visibility没有过渡效果导致的。我们可以用TransitionManager来实现平滑的约束变化，同时调整控件的可见性：

步骤1：在Activity中监听键盘状态 #

相比只监听EditText焦点，监听全局布局变化能更可靠地判断键盘是否弹出（比如用户按返回键收起键盘时，焦点可能还在EditText上）：

val rootView = findViewById<View>(android.R.id.content)
rootView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
    override fun onGlobalLayout() {
        val displayFrame = Rect()
        rootView.getWindowVisibleDisplayFrame(displayFrame)
        val screenHeight = rootView.rootView.height
        val keyboardHeight = screenHeight - displayFrame.bottom

        val logo = findViewById<ImageView>(R.id.logo)
        val loginLabel = findViewById<TextView>(R.id.login_label)
        val container = findViewById<ConstraintLayout>(R.id.container)

        if (keyboardHeight > screenHeight * 0.15) { // 键盘弹出（阈值可调整）
            TransitionManager.beginDelayedTransition(container)
            // 隐藏Logo
            logo.visibility = View.GONE
            // 让登录标题上移到原来Logo的位置
            val loginLabelParams = loginLabel.layoutParams as ConstraintLayout.LayoutParams
            loginLabelParams.topToTop = ConstraintLayout.LayoutParams.PARENT_ID
            loginLabelParams.topMargin = resources.getDimensionPixelSize(R.dimen.logo_top_margin) // 对应原来Logo的60dp
            loginLabel.layoutParams = loginLabelParams
        } else { // 键盘收起
            TransitionManager.beginDelayedTransition(container)
            // 显示Logo
            logo.visibility = View.VISIBLE
            // 恢复登录标题的约束
            val loginLabelParams = loginLabel.layoutParams as ConstraintLayout.LayoutParams
            loginLabelParams.topToBottom = R.id.logo
            loginLabelParams.topMargin = 0
            loginLabel.layoutParams = loginLabelParams
        }
    }
})

记得在XML里给Logo的topMargin定义成dimen资源，方便复用：

<dimen name="logo_top_margin">60dp</dimen>

方案2：改用ScrollView包裹布局（更简单的适配） #

如果ConstraintLayout的约束调整还是觉得麻烦，可以把整个内容放在ScrollView里，这样键盘弹出时ScrollView会自动滚动，同时我们再配合隐藏Logo，体验会更流畅：

修改XML根布局 #

<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fillViewport="true">

    <androidx.constraintlayout.widget.ConstraintLayout
        android:id="@+id/container"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <!-- 你的原有布局内容完全保留 -->

    </androidx.constraintlayout.widget.ConstraintLayout>
</ScrollView>

然后同样用上面的全局布局监听代码来隐藏/显示Logo即可，ScrollView会自动确保登录输入框处于可视区域。

方案3：使用WindowInsets监听（Android 11+推荐） #

如果你的应用最低支持Android 11（API 30），可以用系统提供的WindowInsets API来监听键盘状态，代码更简洁可靠：

val container = findViewById<ConstraintLayout>(R.id.container)
val logo = findViewById<ImageView>(R.id.logo)

container.setOnApplyWindowInsetsListener { _, insets ->
    val isKeyboardVisible = insets.isVisible(WindowInsets.Type.ime())
    if (isKeyboardVisible) {
        // 平滑隐藏Logo
        logo.animate()
            .alpha(0f)
            .setDuration(200)
            .withEndAction { logo.visibility = View.GONE }
    } else {
        // 平滑显示Logo
        logo.visibility = View.VISIBLE
        logo.animate().alpha(1f).setDuration(200)
    }
    insets
}

这种方式不需要手动计算屏幕高度，系统直接告知键盘状态，是目前最优雅的实现方式。

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