https://github.com/egor92/mvvmnavigation

MVVM friendly library for easy navigation management in WPF & Avalonia applications
https://github.com/egor92/mvvmnavigation

avalonia avaloniaui mvvm navigation viewmodel-first-navigation wpf

Last synced: 26 days ago
JSON representation

MVVM friendly library for easy navigation management in WPF & Avalonia applications

• Host: GitHub
• URL: https://github.com/egor92/mvvmnavigation
• Owner: Egor92
• License: mit
• Created: 2019-03-01T19:14:41.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-07-22T02:40:43.000Z (over 3 years ago)
• Last Synced: 2024-10-10T19:41:10.785Z (26 days ago)
• Topics: avalonia, avaloniaui, mvvm, navigation, viewmodel-first-navigation, wpf
• Language: C#
• Homepage:
• Size: 227 KB
• Stars: 27
• Watchers: 7
• Forks: 8
• Open Issues: 29
• Metadata Files:
  • Readme: README.RUS.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# MvvmNavigation

[![Build status](https://img.shields.io/appveyor/ci/Egor92/MvvmNavigation/master)](https://ci.appveyor.com/project/Egor92/MvvmNavigation/branch/master)

[![Version](https://img.shields.io/nuget/vpre/MvvmNavigation.Wpf.svg)](https://www.nuget.org/packages/MvvmNavigation.Wpf)

[![Downloads](https://img.shields.io/nuget/dt/MvvmNavigation.Wpf.svg)](https://www.nuget.org/packages/MvvmNavigation.Wpf)

[![CodeFactor](https://www.codefactor.io/repository/github/egor92/MvvmNavigation/badge/master)](https://www.codefactor.io/repository/github/egor92/MvvmNavigation/overview/master)

[![GitHub contributors](https://img.shields.io/github/contributors/Egor92/MvvmNavigation.svg)](https://github.com/Egor92/MvvmNavigation/graphs/contributors)

[![License](https://img.shields.io/github/license/Egor92/MvvmNavigation.svg)](https://github.com/Egor92/MvvmNavigation/blob/master/LICENSE)

[![Join the Gitter chat!](https://badges.gitter.im/Egor92/MvvmNavigation.svg)](https://gitter.im/MvvmNavigation/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

Go to [english page](https://github.com/Egor92/MvvmNavigation/blob/master/README.md)

Данная библиотека позволяет настраивать поведение навигации вашего WPF приложения и реализовать навигацию на уровне слоя ViewModel. Библиотека полностью придерживается паттерна MVVM.

## Содерание

- [Как использовать](#Как-использовать)

- [Как использовать с Unity](#Как-использовать-с-Unity)

- [Примеры](#Примеры)

## Как использовать

1. Установите NuGet пакет [MvvmNavigation.Wpf](https://www.nuget.org/packages/MvvmNavigation.Wpf/)

1. Определите привала навигации:

   ```csharp

    public partial class App : Application

    {

        protected override void OnStartup(StartupEventArgs e)

        {

            var window = new MainWindow();

            //1. Создайте менеджер навигации

            var navigationManager = new NavigationManager(window);

            //2. Определите правила навигации: зарегистрируйте ключ (строку) с соответствующими View и ViewModel для него

            navigationManager.Register("FirstKey", () => new FirstViewModel(navigationManager));

            navigationManager.Register("SecondKey", () => new SecondViewModel(navigationManager));

            //3. Отобразите стартовый UI

            navigationManager.Navigate("FirstKey");

            window.Show();

        }

    }

   ```

1. Вызовите метод *Navigate* в вашей ViewModel, чтобы сменить UI

   ```csharp

    public class FirstViewModel : ViewModelBase

    {

        private readonly INavigationManager _navigationManager;

        public FirstViewModel(INavigationManager navigationManager)

        {

            _navigationManager = navigationManager;

        }

        private void GoToSecondPage()

        {

            // Сменить интерфейс

            _navigationManager.Navigate("SecondKey");

        }

    }

   ```

   Пример доступен [здесь](https://github.com/Egor92/MvvmNavigation/blob/master/samples/RestaurantApp/App.xaml.cs)

## Как использовать с Unity

MvvmNavigation поддерживает Unity из коробки.

1. Установите 2 NuGet пакета:

 - [MvvmNavigation.Wpf](https://www.nuget.org/packages/MvvmNavigation.Wpf/)

 - [MvvmNavigation.Unity](https://www.nuget.org/packages/MvvmNavigation.Unity/)

2. Определите привала навигации через UnityContainer:

   ```csharp

    public partial class App : Application

    {

        protected override void OnStartup(StartupEventArgs e)

        {

            //1. Создайте Window и UnityContainer

            var mainWindow = new MainWindow();

            var unityContainer = new UnityContainer();

            //2. Зарегистрируйте менеджер навигации

            unityContainer.RegisterNavigationManager(mainWindow);

            //3. Определите правила навигации

            unityContainer.RegisterNavigationRule("FirstKey");

            unityContainer.RegisterNavigationRule("SecondKey");

		 

            //4. Отобразите стартовый UI

            var navigationManager = unityContainer.Resolve();

            navigationManager.Navigate("FirstKey");

            window.Show();

        }

    }

    ```

3. Вызовите метод *Navigate* в вашей ViewModel, чтобы сменить UI

   ```csharp

    public class FirstViewModel : ViewModelBase

    {

        private readonly INavigationManager _navigationManager;

        public FirstViewModel(INavigationManager navigationManager)

        {

            _navigationManager = navigationManager;

        }

        private void GoToSecondPage()

        {

            // Сменить интерфейс

            _navigationManager.Navigate("SecondKey");

        }

    }

   ```

## Примеры

Все примеры доступны [здесь](https://github.com/Egor92/MvvmNavigation/tree/master/samples).