MPowerKit.Popups 1.3.0

MPowerKit.Popups

.NET MAUI popup library which allows you to open MAUI pages as a popup. Also the library allows you to use very simple and flexible animations for showing popup pages.

Inspired by Rg.Plugins.Popup and Mopups, but implementation is completely different.

• It has almost the same PopupPage API as packages above, but improved animations, removed redundant properties as KeyboardOffset, changed names of some properties.

• Improved code and fixed some known bugs, eg Android window insets (system padding) or animation flickering.

• Changed API of PopupService, now you have an ability to choose a window to show/hide popup on.

• Under the hood platform specific code does not use custom renderers for PopupPage.

• Hiding keyboard when tapping anywhere on popup except entry field

• PopupStack is not static from now.

• All API's are public or protected from now, so you can easily override and change implementation as you want

Supported Platforms

• .NET8
• .NET8 for Android (min 23)
• .NET8 for iOS (min 13.0)
• .NET8 for MacCatalyst (min 13.1)
• .NET8 for Windows (min 10.0.17763.0)

Note: .NET8 for Tizen is not supported, but your PRs are welcome.

Setup

Add UseMPowerKitPopups() to your MauiProgram.cs file as next

builder
    .UseMauiApp<App>()
    .UseMPowerKitPopups();

Usage

You can use both registered IPopupService or static singletone PopupService.Current

Inherit your popup page from PopupPage:

public class YourCustomPopup : PopupPage...

Show popup:

IPopupService _popupService;

YourCustomPopup _popup;

await _popupService.ShowPopupAsync(_popup, animated);

It has overload for showing popup which accepts a window of type Window, on which the popup will be shown:

IPopupService _popupService;

YourCustomPopup _popup;

await _popupService.ShowPopupAsync(_popup, desiredWindow, animated);

Hide popup (the last one from PopupStack):

IPopupService _popupService;

await _popupService.HidePopupAsync(animated);

And overload for hiding desired popup:

IPopupService _popupService;

YourCustomPopup _popup;

await _popupService.HidePopupAsync(_popup, animated);

Note: Don't forget to catch informative exceptions;