CrissCross 1.0.24

dotnet add package CrissCross --version 1.0.24
NuGet\Install-Package CrissCross -Version 1.0.24
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="CrissCross" Version="1.0.24" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add CrissCross --version 1.0.24
#r "nuget: CrissCross, 1.0.24"
#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 CrissCross as a Cake Addin
#addin nuget:?package=CrissCross&version=1.0.24

// Install CrissCross as a Cake Tool
#tool nuget:?package=CrissCross&version=1.0.24

CrissCross

A Navigation Framework for ReactiveUI based projects

Alt

CrissCross

CrissCross CI-Build

What is CrissCross?

CrissCross is a navigation framework for ReactiveUI based projects. It is designed to be used with ReactiveUI, but could be adapted to be used with any MVVM framework.

Why CrissCross?

CrissCross is designed to be a simple, lightweight, and easy to use navigation framework. It is designed to be used with ReactiveUI.

How do I use CrissCross?

Step 1: Install CrissCross

CrissCross is available on NuGet. You can install it using the NuGet Package Manager:

Nuget Nuget

Install-Package CrissCross

or Nuget Nuget

Install-Package CrissCross.WPF

or Nuget Nuget

Install-Package CrissCross.XamForms

or Nuget Nuget

Install-Package CrissCross.MAUI

or Nuget Nuget

Install-Package CrissCross.Avalonia

or Nuget Nuget

Install-Package CrissCross.WinForms

Step 2: Create a ViewModel

Create a ViewModel that inherits from RxObject. This is the ViewModel that will be used for the MainWindow.

    public class MainWindowViewModel : RxObject
    {
        public MainWindowViewModel()
        {
            this.BuildComplete(() =>
            {
                // Do something when the IOC Container is built
            });

            // Setup the IOC Container
            Locator.CurrentMutable.RegisterConstant<MainViewModel>(new());
            Locator.CurrentMutable.Register<IViewFor<MainViewModel>>(() => new MainView());

            Locator.CurrentMutable.RegisterConstant<FirstViewModel>(new());
            Locator.CurrentMutable.Register<IViewFor<FirstViewModel>>(() => new FirstView());
            
            // Notify the application that the IOC Container that it is complete and ready to use.
            Locator.CurrentMutable.SetupComplete();
        }
    }

Step 3: Create a View

Create a View that inherits from NavigationWindow. This is the View that will be used for the MainWindow. add xmlns:rxNav="https://github.com/ChrisPulman/CrissCross" to the Window inherits in XAML. Change Window to rxNav:NavigationWindow in XAML. Add x:TypeArguments="local:MainWindowViewModel"

    public partial class MainWindow : NavigationWindow<MainWindowViewModel>
    {
        public MainWindow()
        {
            // Remember to set x:Name in XAML to "mainWindow"
            InitializeComponent();
            
            this.WhenActivated(disposables =>
            {
                // Do something when the View is activated

                // Configure the Navigation for the MainWindow
                NavBack.Command = ReactiveCommand.Create(() => this.NavigateBack(), CanNavigateBack).DisposeWith(d);
                
                // Navigate to the MainViewModel
                this.NavigateToView<MainViewModel>();
            });
        }
    }

Step 4: Create a ViewModel

Create a ViewModel that inherits from RxObject. This is the ViewModel that will be used for the MainView.

    public class MainViewModel : RxObject
    {
        public MainViewModel()
        {
            this.BuildComplete(() =>
            {
                // Do something when the IOC Container is built

                // Configure the Navigation for the MainViewModel using, you will pass the name of the Navigation Host Window that you want to navigate with.
                this.NavigateBack("mainWindow")
                this.CanNavigateBack("mainWindow")
                this.NavigateToView<FirstViewModel>("mainWindow")
            });
        }
    }

Step 5: Create a View

Create a View that inherits from ReactiveUserControl. This is the View that will be used for the MainView.

    public partial class MainView : ReactiveUserControl<MainViewModel>
    {
        public MainView()
        {
            InitializeComponent();

            this.WhenActivated(disposables =>
            {
                // Do something when the View is activated
            });
        }
    }

Step 6: For WPF Applications Configure Single Instance Application if required

If you want to prevent multiple instances of the application from running at the same time, you can use the Make.SingleInstance method.

    protected override void OnStartup(StartupEventArgs e)
    {
        // This will prevent multiple instances of the application from running at the same time.
        Make.SingleInstance("MyUniqueAppName ddd81fc8-9107-4e33-b848-cac4c3ec3d2a");
        base.OnStartup(e);
    }

Step 7: Run the application

Run the application and you should see the MainView.

Avalonia

Step 1: Install CrissCross

CrissCross is available on NuGet. You can install it using the NuGet Package Manager:

Install-Package CrissCross.Avalonia

Step 2: Create a ViewModel

Create a ViewModel that inherits from RxObject. This is the ViewModel that will be used for the MainWindow.

    public class MainWindowViewModel : RxObject
    {
        public MainWindowViewModel()
        {
            this.BuildComplete(() =>
            {
                // Do something when the IOC Container is built
            });

            // Setup the IOC Container
            Locator.CurrentMutable.RegisterConstant<MainViewModel>(new());
            Locator.CurrentMutable.Register<IViewFor<MainViewModel>>(() => new MainView());

            Locator.CurrentMutable.RegisterConstant<FirstViewModel>(new());
            Locator.CurrentMutable.Register<IViewFor<FirstViewModel>>(() => new FirstView());
            
            // Notify the application that the IOC Container that it is complete and ready to use.
            Locator.CurrentMutable.SetupComplete();
        }
    }

Step 3: Create a NavigationView

Create a View that inherits from NavigationWindow OR NavigationUserControl. This is the View that will be used for the MainWindow. add xmlns:rxNav="https://github.com/ChrisPulman/CrissCross" Change Window to rxNav:NavigationWindow in XAML. OR Change UserControl to rxNav:NavigationUserControl in XAML.

As Avalonia has two modes of operation you will need to select the correct mode for your application.

    public partial class MainWindow : NavigationWindow<MainWindowViewModel>
    {
        public MainWindow()
        {
            // Remember to set x:Name in XAML to "mainWindow"
            InitializeComponent();
            
            this.WhenActivated(disposables =>
            {
                // Do something when the View is activated

                // Configure the Navigation for the MainWindow
                NavBack.Command = ReactiveCommand.Create(() => this.NavigateBack(), CanNavigateBack).DisposeWith(d);
                
                // Navigate to the MainViewModel
                this.NavigateToView<MainViewModel>();
            });
        }
    }

Step 4: Create a ViewModel

Create a ViewModel that inherits from RxObject. This is the ViewModel that will be used for the MainView.

    public class MainViewModel : RxObject
    {
        public MainViewModel()
        {
            this.BuildComplete(() =>
            {
                // Do something when the IOC Container is built

                // Configure the Navigation for the MainViewModel using, you will pass the name of the Navigation Host Window that you want to navigate with.
                this.NavigateBack("mainWindow")
                this.CanNavigateBack("mainWindow")
                this.NavigateToView<FirstViewModel>("mainWindow")
            });
        }
    }

Step 5: Create a View

Create a View that inherits from ReactiveUserControl. This is the View that will be used for the MainView.

    public partial class MainView : ReactiveUserControl<MainViewModel>
    {
        public MainView()
        {
            InitializeComponent();

            this.WhenActivated(disposables =>
            {
                // Do something when the View is activated
            });
        }
    }
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net6.0-windows10.0.17763 is compatible.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net7.0-windows10.0.17763 is compatible.  net8.0 is compatible.  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.  net8.0-windows10.0.17763 is compatible. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 is compatible.  net48 is compatible.  net481 was computed. 
MonoAndroid monoandroid was computed.  monoandroid13.0 is compatible. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 is compatible.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed.  xamarinios10 is compatible. 
Xamarin.Mac xamarinmac was computed.  xamarinmac20 is compatible. 
Xamarin.TVOS xamarintvos was computed.  xamarintvos10 is compatible. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on CrissCross:

Package Downloads
CrissCross.WPF

A Reactive Navigation Framework for ReactiveUI

CrissCross.XamForms

A Reactive Navigation Framework for ReactiveUI

CrissCross.MAUI

A Reactive Navigation Framework for ReactiveUI

CrissCross.Avalonia

A Reactive Navigation Framework for ReactiveUI

CrissCross.WinForms

A Reactive Navigation Framework for ReactiveUI

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.24 132 4/19/2024
1.0.23 133 4/10/2024
1.0.22 146 3/29/2024
1.0.21 151 3/26/2024
1.0.20 156 3/22/2024
1.0.19 163 3/21/2024
1.0.18 153 3/19/2024
1.0.17 159 3/14/2024
1.0.16 165 3/13/2024
1.0.15 162 3/12/2024
1.0.14 167 3/11/2024
1.0.13 143 3/8/2024
1.0.12 167 3/7/2024
1.0.11 146 3/5/2024
1.0.10 170 2/22/2024
1.0.9 157 2/21/2024
1.0.8 141 2/21/2024
1.0.7 142 2/19/2024
1.0.6 140 2/16/2024
1.0.5 175 2/8/2024
1.0.4 186 1/4/2024
1.0.3 309 9/11/2023
1.0.2 221 9/9/2023
1.0.1 205 9/8/2023
1.0.0 219 9/7/2023
0.9.2 214 9/6/2023
0.9.1 228 8/6/2023
0.9.0 216 7/12/2023
0.8.0 202 6/23/2023
0.7.1 254 4/28/2023
0.7.0 340 3/14/2023
0.6.0 322 3/13/2023
0.5.0 349 3/11/2023
0.2.0 367 2/7/2023
0.1.0 415 1/7/2023

Compatability with Net 6/7/8 and netstandard2.0