DisplayAlert & DisplayActionSheet dismiss behaviour is undocumented on Android

[mattleibow]

Type of issue

Other (describe below)

Description

I got an issue on the maui repo: dotnet/maui#15671

DisplayAlert can be dismissed by tapping outside of the alert window on Android 10, e.g.:

bool answer = await DisplayAlert("Question?", "Would you like to play a game", "Yes", "No");

In this case tapping outside the alert returns "No."

But the documentation (https://learn.microsoft.com/en-gb/dotnet/maui/user-interface/pop-ups) explicitly states that the behaviour should be modal. It behaves in a modal way on Windows 10.

Maybe this is a feature, but it would be great to have a non-dismissable option in the function, so important prompts have to be answered with one of the buttons. Same goes for DisplayActionSheet.

I would like to get an explicit answer from the user, by pressing one of the options. Tapping outside is analogical to Cancel, but the function returns only true or false. The user may not realise that by tapping outside she picked one of the options.

In case of DisplayActionSheet this can be handled, but I have to redisplay the pop up if a bad option is given by tapping outside. A non dismissible option would lead to more elegant behavior.

This is more a docs issue as although the DisplayAlert API appears to have options, it is not really meant to do anything but "accept" and "cancel" - and tapping outside the dialog counts as a "cancel" operation.

Similarly, the DisplayActionSheet API presents the user a choice of things, but the user can opt to not pick anything. This is a cancellation and will return null.

On touch platforms, you can tap outside the dialog, but on Windows you can also press escape to see similar actions... I think?

Page URL

https://learn.microsoft.com/en-gb/dotnet/maui/user-interface/pop-ups?view=net-maui-8.0

Content source URL

https://github.com/dotnet/docs-maui/blob/main/docs/user-interface/pop-ups.md

Document Version Independent Id

144c1b04-ddfc-e59b-773f-94124fbbce7a

Article author

@davidbritch

Metadata

• ID: 144c1b04-ddfc-e59b-773f-94124fbbce7a
• Product: dotnet-mobile
• Technology: dotnet-maui

---

Associated WorkItem - 187365