如何让BottomSheetDialogFragment打开时自动全屏展开至屏幕顶部？

问题根源 #

1. 布局嵌套冗余：外层额外添加的CoordinatorLayout属于重复嵌套，BottomSheetDialogFragment内部已自带该容器，会导致BottomSheetBehavior无法正确绑定内容布局。
2. 固定高度限制：给内容布局设置900dp固定高度，既无法适配不同屏幕尺寸，也限制了布局的自适应能力。
3. Behavior配置不全：仅设置STATE_EXPANDED不足以强制全屏，缺少跳过折叠状态、适配内容高度等关键配置。

解决方案 #

步骤1：修正布局文件 #

移除外层多余的CoordinatorLayout，直接以ConstraintLayout作为根布局，将高度改为wrap_content让布局自适应内容：

<?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:id="@+id/mainLayoutConstraint"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:layout_behavior="com.google.android.material.bottomsheet.BottomSheetBehavior">

    <com.safetyheads.akademiaandroida.MyTest2View
        android:id="@+id/myTest2View"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:hint="type something"
        app:layout_constraintBottom_toTopOf="@+id/textView4"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:name="First nameno"
        app:visibility="visible">
    </com.safetyheads.akademiaandroida.MyTest2View>

    <TextView
        android:id="@+id/textView4"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="TextView"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/myTest2View" />

    <TextView
        android:id="@+id/textView5"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="TextView"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textView4" />

    <TextView
        android:id="@+id/textView7"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="TextView"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textView5" />

    <TextView
        android:id="@+id/textView8"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="TextView"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textView7" />

</androidx.constraintlayout.widget.ConstraintLayout>

步骤2：修改BottomSheetDialogFragment代码 #

正确获取BottomSheet核心布局，补充配置强制跳过折叠状态、适配内容并展开至全屏：

import android.annotation.SuppressLint
import android.app.Dialog
import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.FrameLayout
import com.google.android.material.bottomsheet.BottomSheetBehavior
import com.google.android.material.bottomsheet.BottomSheetDialog
import com.google.android.material.bottomsheet.BottomSheetDialogFragment
import com.safetyheads.akademiaandroida.databinding.FragmentBottomSheetWriteToUsBinding

class BottomSheetWriteToUsFragment : BottomSheetDialogFragment() {

    private lateinit var binding: FragmentBottomSheetWriteToUsBinding

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        binding = FragmentBottomSheetWriteToUsBinding.inflate(inflater, container, false)
        return binding.root
    }

    @SuppressLint("RestrictedApi")
    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
        val bottomSheetDialog = super.onCreateDialog(savedInstanceState) as BottomSheetDialog
        
        bottomSheetDialog.setOnShowListener { dialog ->
            // 获取BottomSheetDialog内部的核心布局
            val bottomSheet = (dialog as BottomSheetDialog)
                .findViewById<FrameLayout>(com.google.android.material.R.id.design_bottom_sheet)
            
            bottomSheet?.let { sheet ->
                val behavior = BottomSheetBehavior.from(sheet)
                // 跳过折叠状态，直接在展开/收起间切换
                behavior.skipCollapsed = true
                // 让BottomSheet高度适配内容
                behavior.isFitToContents = true
                // 设置为展开状态
                behavior.state = BottomSheetBehavior.STATE_EXPANDED
                
                // 若需强制占满屏幕，可设置peekHeight为屏幕高度
                val displayMetrics = resources.displayMetrics
                behavior.peekHeight = displayMetrics.heightPixels
            }
        }
        
        return bottomSheetDialog
    }
}

额外说明 #

• 避免给内容布局设置固定高度，wrap_content配合isFitToContents = true可确保内容完整显示。
• skipCollapsed = true能防止BottomSheet停留在中间折叠状态，提升交互流畅度。
• 如果布局内容需要强制占满全屏，设置peekHeight为屏幕高度即可实现。

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