BottomSheetDialogFragment无法填充指定高度，始终包裹内容求助

问题描述 #

实现BottomSheetDialogFragment时，期望初始占半屏、可上拉全屏/下拉关闭。测试发现：

• 设置STATE_HALF_EXPANDED后，弹窗顶部处于屏幕中点，但红色背景仅包裹TextView，未填满下半空间
• 拖动至全屏后问题依旧，移除TextView则仅显示半透明遮罩
• 嵌套CoordinatorLayout无改善

需求：初始半屏背景填满，TextView居中；后续内容可多可少，但保持初始半屏+拖动全屏/关闭功能。

问题根源 #

BottomSheetDialogFragment默认开启fitToContents=true，会让内容容器自适应内容高度，而非强制填充到设置的peekHeight或半屏高度。

解决方案 #

1. 布局文件（test.xml） #

保持原布局，根布局设置android:layout_height="match_parent"确保能填充可用空间：

<?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="match_parent"
    android:background="#ff0000">

    <TextView
        android:id="@+id/textView20"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="TextView"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.5"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.5" />

</androidx.constraintlayout.widget.ConstraintLayout>

2. 修改BottomSheetDialogFragment代码 #

核心是关闭fitToContents，强制BottomSheet按设置的高度显示：

class TestBottomSheet: BottomSheetDialogFragment() {

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

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        // 获取BottomSheetDialog的核心容器View
        val bottomSheet = dialog?.findViewById<View>(com.google.android.material.R.id.design_bottom_sheet)
        bottomSheet?.let {
            val behavior = BottomSheetBehavior.from(it)
            val screenHeight = resources.displayMetrics.heightPixels
            
            behavior.peekHeight = screenHeight / 2 // 初始半屏高度
            behavior.fitToContents = false // 关键：禁止内容自适应高度
            behavior.expandedHeight = ViewGroup.LayoutParams.MATCH_PARENT // 全屏时填满屏幕
            behavior.isHideable = true // 允许下拉关闭
            behavior.isDraggable = true // 允许拖动
            behavior.state = BottomSheetBehavior.STATE_HALF_EXPANDED // 初始半屏状态
        }
    }
}

3. 效果说明 #

• 初始状态：红色背景填满屏幕下半部分，TextView居中
• 上拉拖动：可展开至全屏，背景填满整个屏幕
• 下拉拖动：可关闭弹窗；若后续内容高度超过半屏，BottomSheet会自动适配内容高度，仍支持拖动全屏/关闭

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