lynnliu/Rg.Plugins.Popup

Xamarin Forms popup plugin

Popup Page Plugin for Xamarin Forms

The plugin allows you to open any page as a popup.

Nuget: https://www.nuget.org/packages/Rg.Plugins.Popup/

Support platforms

• Android
• iOS
• WinPhone (v1.0.0-pre1)
• UWP (v1.0.0-pre1)

Prerelease supported WinPhone and UWP: https://www.nuget.org/packages/Rg.Plugins.Popup/1.0.0-pre1

Support Events

• OnAppearing
• OnDisappearing
• OnBackButtonPressed
• BackgroundClicked: Called when clicked on background

Animations

Fade Animation

• Fade

Scale Animation

• ScaleCenterUp
• ScaleTopUp
• ScaleTopBottomUp
• ScaleBottomUp
• ScaleBottomTopUp
• ScaleLeftUp
• ScaleLeftRightUp
• ScaleRightUp
• ScaleRightLeftUp
• ScaleCenterDown
• ScaleTopDown
• ScaleTopBottomDown
• ScaleBottomDown
• ScaleBottomTopDown
• ScaleLeftDown
• ScaleLeftRightDown
• ScaleRightDown
• ScaleRightLeftDown

Move Animation

• MoveTop
• MoveTopBottom
• MoveBottom
• MoveBottomTop
• MoveLeft
• MoveLeftRight
• MoveRight
• MoveRightLeft

Initialize

Android

Not required

iOS

public partial class AppDelegate : global::Xamarin.Forms.Platform.iOS.FormsApplicationDelegate
{
    public override bool FinishedLaunching(UIApplication app, NSDictionary options)
    {
        Rg.Plugins.Popup.IOS.Popup.Init(); // Init Popup
        
        global::Xamarin.Forms.Forms.Init();
        LoadApplication(new App());
        return base.FinishedLaunching(app, options);
    }
}

PopupPage Properties

• BackgroundColor: Hex #80FF5C5C where #80 opacity Range

• IsBackgroundAnimating

• IsAnimating

• IsCloseOnBackgroundClick: Close pop-up when click on the background

• AnimationName: In default animations

• IsSystemPadding: Enabled/Disabled system padding offset (Only for Content not for Background)

  

• SystemPadding: (ReadOnly) Thickness

How Use

<?xml version="1.0" encoding="utf-8" ?>
<pages:PopupPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:pages="clr-namespace:Rg.Plugins.Popup.Pages;assembly=Rg.Plugins.Popup"
             x:Class="Demo.Pages.MyPopupPage">
  <!-- Content -->
</pages:PopupPage>

public partial class MyPopupPage : PopupPage
    {
        public SecondPopupPage()
        {
            InitializeComponent();
        }

        protected override void OnAppearing()
        {
            base.OnAppearing();
        }

        protected override void OnDisappearing()
        {
            base.OnDisappearing();
        }

        protected override bool OnBackButtonPressed()
        {
            // Prevent hide popup
            //return base.OnBackButtonPressed();
            return true; 
        }
    }
    
    // Main Page
    
    public partial class MainPage : ContentPage
    {
        public MainPage()
        {
            InitializeComponent();
        }
        
        // Button Click
        private async void OnOpenPupup(object sender, EventArgs e)
        {
            var page = new MyPopupPage();
            
            await Navigation.PushPopupAsync(page);
            // or
            PopupNavigation.PushAsync(page);
        }
    }

User Animation

    // User animation
    class UserAnimation : IPopupAnimation
    {
        // Call Before OnAppering
        public void Preparing(View content, PopupPage page)
        {
            // Preparing content and page
            content.Opacity = 0;
        }

		// Call After OnDisappering
        public void Disposing(View content, PopupPage page)
        {
			// Dispose Unmanaged Code
        }
        
        // Call After OnAppering
        public async Task Appearing(View content, PopupPage page)
        {
            // Show animation
            await content.FadeTo(1);
        }
        
        // Call Before OnDisappering
        public async Task Disappearing(View content, PopupPage page)
        {
            // Hide animation
            await content.FadeTo(0);
        }
    }
    
    // Popup Page
    public partial class UserPopupPage : PopupPage
    {
        public SecondPopupPage()
        {
            InitializeComponent();
            Animation = new UserAnimation();
        }
    }

Thanks

• xam-forms-transparent-modal