/Rg.Plugins.Popup

Xamarin Forms popup plugin

Primary LanguageC#

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/

Android iOS

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)

    Android Android

  • 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