CustomShellMaui 1.0.3

There is a newer version of this package available.
See the version list below for details.
dotnet add package CustomShellMaui --version 1.0.3                
NuGet\Install-Package CustomShellMaui -Version 1.0.3                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="CustomShellMaui" Version="1.0.3" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add CustomShellMaui --version 1.0.3                
#r "nuget: CustomShellMaui, 1.0.3"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install CustomShellMaui as a Cake Addin
#addin nuget:?package=CustomShellMaui&version=1.0.3

// Install CustomShellMaui as a Cake Tool
#tool nuget:?package=CustomShellMaui&version=1.0.3                

Custom Shell Maui

Custom Shell Navigation with custom animation transition. A .NET MAUI library for easily customizable animations of transitions of pages.

Thanks github.com/jsuarezruiz for inspiring this project. Xamarin.Forms Page Transitions

The library consists of one NuGet packages:

NuGet

Sample

To use, simply install the package and add use to your builder:

var builder = MauiApp.CreateBuilder();
    builder
      .UseMauiApp<App>()
      .UseCustomShellMaui()

Animations are divided into Root, Push, Pop.

Configure animations for the current page and next page

<img src="images/above1.png" height="200"> <img src="images/above2.png" height="200">
Current as above Next as above

Also configure which page will be on top of the other with the above option

You can use the default animations:

Shell.Current.CustomShellMaui(new Models.Transitions
    {
        Root = new Models.TransitionRoot
        {
            CurrentPage = Enum.TransitionType.FadeOut //is Above by default 
        },
        Push = new Models.Transition
        {
            CurrentPage = Enum.TransitionType.LeftOut,
            NextPage = Enum.TransitionType.RightIn //is Above
        },
        Pop = new Models.Transition
        {
            CurrentPage = Enum.TransitionType.RightOut, //is Above
            NextPage = Enum.TransitionType.LeftIn
        },
    });
Shell.Current.GoToAsync(nameof(Pages.New1));

|<img src="images/fadeios.gif" height="400">|<img src="images/fadedroid.gif" height="400">|<img src="images/pushios.gif" height="400">|<img src="images/pushdroid.gif" height="400">|

Or you can customize the advanced transitions however you want:

Shell.Current.CustomShellMaui(new Models.Transitions
        {
            Root = new Models.TransitionRoot
            {
                AbovePage = Enum.PageType.NextPage, //is forced Above
#if ANDROID
                NextPageAndroid = Resource.Animation.custom_in, //[xml android animation](https://developer.android.com/guide/fragments/animate)
                DurationAndroid = 1500,
#elif IOS
                NextPageIos = new Platforms.iOS.ConfigIos()
                {
                    OpacityStart = 0,
                    OpacityEnd = 1,
                    RotationStart = .1,
                    RotationEnd = 0,
                    ScaleStart = 1.5,
                    ScaleEnd = 1,
                    XStart = 1,
                    XEnd = 0,
                    YStart = .3,
                    YEnd = 0,
                    Duration = 1.5
                },
#endif
                CurrentPage = Enum.TransitionType.None,
            }
        });
Shell.Current.GoToAsync("//" + nameof(Pages.New2));
//Root navigation i.e. with two slashes (“//“)

|<img src="images/customios.gif" height="400">|<img src="images/customdroid.gif" height="400">|

***Android advanced animation must be done using Resource xml, see more in the Android documentation https://developer.android.com/guide/fragments/animate

Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-android33.0 is compatible.  net7.0-ios was computed.  net7.0-ios16.1 is compatible.  net7.0-maccatalyst was computed.  net7.0-maccatalyst16.1 is compatible.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net7.0

    • No dependencies.
  • net7.0-android33.0

    • No dependencies.
  • net7.0-ios16.1

    • No dependencies.
  • net7.0-maccatalyst16.1

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.6 1,576 11/21/2023
1.0.5 177 11/9/2023
1.0.4 121 11/9/2023 1.0.4 is deprecated because it is no longer maintained and has critical bugs.
1.0.3 135 11/9/2023
1.0.2 384 9/12/2023