From 5234537f3ea57d298396e25b75b790ed0fc70cc6 Mon Sep 17 00:00:00 2001 From: Dan Siegel Date: Wed, 23 Oct 2024 18:42:41 -0600 Subject: [PATCH] docs: adding documentation on the Notifications API --- .../essentials/notifications/actionsheets.md | 18 +++++++++++++ .../essentials/notifications/alerts.md | 21 +++++++++++++++ .../images/simple-actionsheet.png | Bin 0 -> 9600 bytes .../notifications/images/simple-alert.png | Bin 0 -> 6107 bytes .../notifications/images/simple-prompt.png | Bin 0 -> 7696 bytes .../notifications/images/two-button-alert.png | Bin 0 -> 7784 bytes .../plugins/essentials/notifications/index.md | 24 ++++++++++++++++++ .../essentials/notifications/prompts.md | 22 ++++++++++++++++ docs/plugins/essentials/notifications/toc.yml | 8 ++++++ docs/plugins/essentials/toc.yml | 2 ++ 10 files changed, 95 insertions(+) create mode 100644 docs/plugins/essentials/notifications/actionsheets.md create mode 100644 docs/plugins/essentials/notifications/alerts.md create mode 100644 docs/plugins/essentials/notifications/images/simple-actionsheet.png create mode 100644 docs/plugins/essentials/notifications/images/simple-alert.png create mode 100644 docs/plugins/essentials/notifications/images/simple-prompt.png create mode 100644 docs/plugins/essentials/notifications/images/two-button-alert.png create mode 100644 docs/plugins/essentials/notifications/index.md create mode 100644 docs/plugins/essentials/notifications/prompts.md create mode 100644 docs/plugins/essentials/notifications/toc.yml diff --git a/docs/plugins/essentials/notifications/actionsheets.md b/docs/plugins/essentials/notifications/actionsheets.md new file mode 100644 index 0000000..a793c6f --- /dev/null +++ b/docs/plugins/essentials/notifications/actionsheets.md @@ -0,0 +1,18 @@ +--- +uid: Plugins.Essentials.Notifications.ActionSheets +--- + +# ActionSheets + +An ActionSheet presents the user with a set of alternatives for how to proceed with a task. To display an ActionSheet you can use the `IActionSheet` directly or you can use the aggregate `INotifications` interface as follows: + +```cs +await notifications.ActionSheet.DisplayAsync("Send to:", + ActionSheetButton.CreateButton("Email", SendEmail), + ActionSheetButton.CreateButton("Twitter", SendTweet), + ActionSheetButton.CreateButton("Facebook Messenger", SendFacebookMessage)); +``` + +![Simple ActionSheet](images/simple-actionsheet.png) + +ActionSheets also provide the capability to provide an explicit Cancel or Destroy button. diff --git a/docs/plugins/essentials/notifications/alerts.md b/docs/plugins/essentials/notifications/alerts.md new file mode 100644 index 0000000..78c1dd3 --- /dev/null +++ b/docs/plugins/essentials/notifications/alerts.md @@ -0,0 +1,21 @@ +--- +uid: Plugins.Essentials.Notifications.Alerts +--- + +# Alerts + +To display an Alert you can use the `IAlerts` interface directly or through the aggregate service `INotifications` as follows: + +```cs +await notifications.Alert.DisplayAsync("Alert", "You have been alerted"); +``` + +![Simple Alert](images/simple-alert.png) + +The Alert can also be used to prompt a user for a boolean (yes/no) response. + +```cs +await notifications.Alert.DisplayAsync("Question?", "Would you like to play a game", "Yes", "No"); +``` + +![Two Button Alert](images/two-button-alert.png) diff --git a/docs/plugins/essentials/notifications/images/simple-actionsheet.png b/docs/plugins/essentials/notifications/images/simple-actionsheet.png new file mode 100644 index 0000000000000000000000000000000000000000..f8f4cec65eaacd0a7d0f1d7b24d56040f44f0a7d GIT binary patch literal 9600 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 literal 0 HcmV?d00001 diff --git a/docs/plugins/essentials/notifications/images/simple-alert.png b/docs/plugins/essentials/notifications/images/simple-alert.png new file mode 100644 index 0000000000000000000000000000000000000000..1404312fecf0a056c324c10f3d3e7efdbbf72170 GIT binary patch literal 6107 zcmeHLc{r49+n*UDW6N05Sjrd_kr`tb(wMSmYa!B%F*F%wG81Equ|D2~dB4BDbn#KnQEDepX#y-GqFam73=2I)H!=@a(GvU9+!w=q+>>`R$%MNA2U8 zE!YPm$K!3pRByc!^TBGox&|st?i}(!F7d^_OcXqAi9jG6!>RA56Cv<29*(36#6W

`vIp_gmsAe=4>oS3bdyXhn^c=N`Ca&pmj3gV{X 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 literal 0 HcmV?d00001 diff --git a/docs/plugins/essentials/notifications/images/simple-prompt.png b/docs/plugins/essentials/notifications/images/simple-prompt.png new file mode 100644 index 0000000000000000000000000000000000000000..642b7a12b89ca37e91d29c688bc4aa5eb4e61aa1 GIT binary patch literal 7696 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 literal 0 HcmV?d00001 diff --git a/docs/plugins/essentials/notifications/images/two-button-alert.png b/docs/plugins/essentials/notifications/images/two-button-alert.png new file mode 100644 index 0000000000000000000000000000000000000000..1c952b14c0397b79fa29b98d752b58ab5b62a912 GIT binary patch literal 7784 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 Q|6xx_UR~~qtZC5y0Io$#$p8QV literal 0 HcmV?d00001 diff --git a/docs/plugins/essentials/notifications/index.md b/docs/plugins/essentials/notifications/index.md new file mode 100644 index 0000000..8075dbc --- /dev/null +++ b/docs/plugins/essentials/notifications/index.md @@ -0,0 +1,24 @@ +--- +uid: Plugins.Essentials.Notifications +--- + +# Notifications + +Displaying an alert, asking a user to make a choice, or displaying a prompt is a common UI task. The Notifications API from Prism Essentials is designed as a cross platform replacement API for the PageDialogService in Prism.Forms and Prism.Maui. For those migrating from Prism.Forms it is recommended to migrate to this API as this will better help you to migrate your code to a more future proof API which will work well into the future without the need to change your code should you choose to switch between Uno Platform and .NET MAUI. Additionally this API will be providing support with WPF making your WPF apps easier to migrate to mobile in the future. + +## Getting Started + +To use the Notifications API you must either call `UsePrismEssentials` or `RegisterNotifications`. + +```cs +public class MyViewModel(INotifications notifications) +``` + +## Next Steps + +- [ActionSheets](xref:Prism.Essentials.Notifications.ActionSheets) +- [Alerts](xref:Prism.Essentials.Notifications.Alerts) +- [Prompts](xref:Prism.Essentials.Notifications.Prompts) + +> [!NOTE] +> This is currently only supported on Android, iOS, MacCatalyst, & WinUI for .NET MAUI and Uno Platform. This feature is planned for future expansion to all Uno Platform platforms and WPF. diff --git a/docs/plugins/essentials/notifications/prompts.md b/docs/plugins/essentials/notifications/prompts.md new file mode 100644 index 0000000..4a4668a --- /dev/null +++ b/docs/plugins/essentials/notifications/prompts.md @@ -0,0 +1,22 @@ +--- +uid: Plugins.Essentials.Notifications.ActionSheets +--- + +# Prompts + +To display a prompt you can use the `IPrompts` interface directly or the aggregate `INotifications` as follows: + +```cs +var value = await notifications.Prompts.DisplayAsync("Question", "What's your name?"); +``` + +![Simple Prompt](images/simple-prompt.png) + +The Display method also provides additional optional parameters: + +- `accept` - the text for the accept button. +- `cancel` - the text for the cancel button. +- `placeholder` - the placeholder text to display in the user prompt. +- `maxlength` - the max length of the user's response. +- `keyboard` - the keyboard type to use. This is provided via an enum value. +- `initialValue` - a predefined default value for the user to provide. diff --git a/docs/plugins/essentials/notifications/toc.yml b/docs/plugins/essentials/notifications/toc.yml new file mode 100644 index 0000000..170d83c --- /dev/null +++ b/docs/plugins/essentials/notifications/toc.yml @@ -0,0 +1,8 @@ +- name: Getting Started + href: index.md +- name: ActionSheets + href: actionsheets.md +- name: Alerts + href: alerts.md +- name: Prompts + href: prompts.md \ No newline at end of file diff --git a/docs/plugins/essentials/toc.yml b/docs/plugins/essentials/toc.yml index 1cd3074..2962737 100644 --- a/docs/plugins/essentials/toc.yml +++ b/docs/plugins/essentials/toc.yml @@ -10,6 +10,8 @@ href: latestversion.md - name: Main Thread href: mainthread.md +- name: Notifications + href: notifications/toc.yml - name: Permissions href: permissions.md - name: Phone Dialer