Android Studio中如何让弹窗Dialog占满整个屏幕

问题场景 #

开发移动端应用时，点击剧集列表项会弹出Dialog展示剧集完整信息，但当前Dialog仅占据屏幕一小部分空间，即使将弹窗根布局的宽高设为match_parent也无法实现全屏效果，需解决Dialog全屏显示的问题。

现有代码 #

弹窗类实现 #

class ShowPopup(private val adapter : ShowAdapter, private val currentShow : ShowModel) : Dialog(adapter.context) {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        requestWindowFeature(Window.FEATURE_NO_TITLE)
        setContentView(R.layout.popup_show_details)
        setupComponents() // 初始化弹窗各字段内容
    }
}

列表项点击触发弹窗代码 #

override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    // 获取剧集信息
    val currentShow = showList[position]

    holder.itemView.setOnClickListener{
        ShowPopup(this, currentShow).show()
    }
}

弹窗布局代码 #

<androidx.constraintlayout.widget.ConstraintLayout 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">

    <!-- 弹窗内容控件 -->

</androidx.constraintlayout.widget.ConstraintLayout>

解决方案 #

Dialog默认带有窗口边距和尺寸限制，仅设置布局宽高无法覆盖系统默认配置，需通过修改窗口参数或样式实现全屏：

方法一：直接在Dialog中设置窗口参数 #

修改ShowPopup的onCreate方法，添加窗口属性配置：

class ShowPopup(private val adapter : ShowAdapter, private val currentShow : ShowModel) : Dialog(adapter.context) {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        requestWindowFeature(Window.FEATURE_NO_TITLE)
        setContentView(R.layout.popup_show_details)
        
        // 配置全屏窗口参数
        window?.run {
            // 移除默认窗口背景，避免出现边距
            setBackgroundDrawable(ColorDrawable(Color.TRANSPARENT))
            val params = attributes
            // 设置窗口宽高匹配屏幕
            params.width = WindowManager.LayoutParams.MATCH_PARENT
            params.height = WindowManager.LayoutParams.MATCH_PARENT
            // 确保窗口从屏幕顶部开始（覆盖状态栏）
            params.gravity = Gravity.TOP
            attributes = params
        }
        
        setupComponents()
    }
}

方法二：通过自定义样式实现全屏 #

1. 在res/values/styles.xml中添加全屏Dialog样式：

<style name="FullScreenDialogStyle" parent="Theme.AppCompat.Dialog">
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowFullscreen">true</item>
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowIsFloating">false</item>
</style>

2. 修改ShowPopup构造函数，指定使用该样式：

class ShowPopup(private val adapter : ShowAdapter, private val currentShow : ShowModel) : Dialog(adapter.context, R.style.FullScreenDialogStyle) {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.popup_show_details)
        setupComponents()
    }
}

方法三：适配Android 11+版本 #

针对Android 11（API 30）及以上系统，需额外处理系统窗口适配，避免刘海屏、状态栏等影响全屏效果，可在窗口参数中添加：

window?.run {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        setLayout(WindowManager.LayoutParams.MATCH_PARENT, WindowManager.LayoutParams.MATCH_PARENT)
        // 允许窗口延伸至系统UI区域
        setDecorFitsSystemWindows(false)
    } else {
        setLayout(WindowManager.LayoutParams.MATCH_PARENT, WindowManager.LayoutParams.MATCH_PARENT)
    }
}

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