如何限制BottomSheetDialogFragment的最大展开高度？

我们基于BottomSheetDialogFragment、NestedScrollView和EditText实现了一个输入弹窗，当前存在以下问题：用户输入多行内容时，弹窗高度会持续增加直至铺满全屏。我们需要实现的效果是：弹窗高度增长到指定上限后停止，超过上限时NestedScrollView自动变为可滚动状态。

以下是三种可行的实现方案，可根据需求选择：

方案1：通过BottomSheetBehavior控制弹窗最大高度 #

直接控制BottomSheet的整体最大高度，是最直接的全局控制方式。

修改TodoInputDialogFragment.kt #

在onCreateDialog方法中添加BottomSheetBehavior的配置：

override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
    val dialog = super.onCreateDialog(savedInstanceState)

    // 保留原有软键盘适配代码
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
        dialog.window?.also {
            it.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)
        }
    }

    // 设置BottomSheet最大高度
    dialog.setOnShowListener {
        val bottomSheet = dialog.findViewById<FrameLayout>(com.google.android.material.R.id.design_bottom_sheet)
        bottomSheet?.let { sheet ->
            val behavior = BottomSheetBehavior.from(sheet)
            // 设置最大高度为屏幕高度的60%，可根据需求调整比例或固定值
            val maxHeight = (resources.displayMetrics.heightPixels * 0.6).toInt()
            behavior.maxHeight = maxHeight
            // 可选：若需固定高度而非可拖拽展开，将peekHeight设置为与maxHeight一致
            behavior.peekHeight = maxHeight
            behavior.isDraggable = false // 按需开启/关闭拖拽功能
        }
    }

    return dialog
}

原理说明 #

BottomSheetBehavior的maxHeight属性会限制弹窗的最大展开高度，当内部内容超过该高度时，NestedScrollView会自动接管滚动逻辑。

方案2：给NestedScrollView设置最大高度 #

仅限制输入区域的高度，弹窗底部的按钮始终保持可见，适合不需要控制整个弹窗高度的场景。

方式1：静态XML设置 #

修改todo_input_dialog_fragment.xml中的NestedScrollView：

<androidx.core.widget.NestedScrollView
    android:id="@+id/scroll_view"
    android:layout_width="match_parent"
    android:layout_height="0dp"
    android:layout_weight="1"
    android:fillViewport="true"
    <!-- 静态设置最大高度，比如400dp -->
    android:maxHeight="400dp">

    <!-- 内部EditText代码保持不变 -->
</androidx.core.widget.NestedScrollView>

方式2：动态代码设置（适配屏幕） #

在onViewCreated中动态计算并设置最大高度：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    
    // 设置输入区域最大高度为屏幕高度的50%
    val maxScrollHeight = (resources.displayMetrics.heightPixels * 0.5).toInt()
    binding.scrollView.maxHeight = maxScrollHeight
    
    // 保留原有软键盘唤起代码
    focusAndShowKeyboard(requireActivity(), binding.editText)
}

方案3：使用ConstraintLayout约束高度 #

将根布局替换为ConstraintLayout，通过布局约束更灵活地控制输入区域的最大高度，适合复杂布局场景。

修改todo_input_dialog_fragment.xml #

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <androidx.core.widget.NestedScrollView
        android:id="@+id/scroll_view"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:fillViewport="true"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintBottom_toTopOf="@+id/submit_button"
        <!-- 设置最大高度为屏幕高度的60% -->
        app:layout_constraintHeight_max="60%p"
        app:layout_constraintHeight_min="wrap_content">

        <EditText
            android:id="@+id/edit_text"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:background="@android:color/transparent"
            android:fontFamily="@font/open_sans_regular"
            android:hint="Add a Todo"
            android:inputType="textMultiLine"
            android:padding="16dp"
            android:textColor="?attr/primaryTextColor"
            android:textSize="18sp" />
    </androidx.core.widget.NestedScrollView>

    <com.google.android.material.button.MaterialButton
        android:id="@+id/submit_button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:minHeight="56dp"
        android:layout_marginStart="16dp"
        android:layout_marginEnd="16dp"
        android:layout_marginBottom="8dp"
        android:gravity="center"
        android:elevation="4dp"
        android:translationZ="4dp"
        android:stateListAnimator="@null"
        app:cornerRadius="28dp"
        app:backgroundTint="@color/colorAccentLight"
        app:rippleColor="#7fffffff"
        app:iconTint="@color/primaryTextColorDark"
        app:iconGravity="textStart"
        app:iconPadding="0dp"
        app:icon="@drawable/send_24px"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"/>

</androidx.constraintlayout.widget.ConstraintLayout>

• 若需要控制整个弹窗的最大高度，优先选择方案1；
• 若仅需限制输入区域高度，按钮始终显示，优先选择方案2；
• 若弹窗布局复杂，需要更多灵活约束，优先选择方案3。

内容的提问来源于stack exchange，提问作者Cheok Yan Cheng