{% setvar book_path %}/reference/androidx/_book.yaml{% endsetvar %} {% include "_shared/_reference-head-tags.html" %}

AndroidDialogKt

public final class AndroidDialogKt


Summary

Public methods

static final void
@Composable
Dialog(
    @NonNull Function0<Unit> onDismissRequest,
    @NonNull DialogProperties properties,
    @Composable @NonNull Function0<Unit> content
)

Opens a dialog with the given content.

Public methods

Dialog

@Composable
public static final void Dialog(
    @NonNull Function0<Unit> onDismissRequest,
    @NonNull DialogProperties properties,
    @Composable @NonNull Function0<Unit> content
)

Opens a dialog with the given content.

A dialog is a small window that prompts the user to make a decision or enter additional information. A dialog does not fill the screen and is normally used for modal events that require users to take an action before they can proceed.

The dialog is visible as long as it is part of the composition hierarchy. In order to let the user dismiss the Dialog, the implementation of onDismissRequest should contain a way to remove the dialog from the composition hierarchy.

Example usage:

import androidx.compose.foundation.background
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.size
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.unit.dp
import androidx.compose.ui.window.Dialog

val openDialog = remember { mutableStateOf(true) }
val dialogWidth = 200.dp
val dialogHeight = 50.dp

if (openDialog.value) {
    Dialog(onDismissRequest = { openDialog.value = false }) {
        // Draw a rectangle shape with rounded corners inside the dialog
        Box(Modifier.size(dialogWidth, dialogHeight).background(Color.White))
    }
}
Parameters
@NonNull Function0<Unit> onDismissRequest

Executes when the user tries to dismiss the dialog.

@NonNull DialogProperties properties

DialogProperties for further customization of this dialog's behavior.

@Composable @NonNull Function0<Unit> content

The content to be displayed inside the dialog.