English version here

Navegar vous permet de gérer une navigation, au sein de vos applications Universal Apps, Universal Windows Platform et Xamarin.Forms en utilisant l'approche ViewModel First et non l'approche View First intégrée dans le Framework WinRT, le tout basé sur MVVMLight et SimpleIoc, vous pouvez donc passer d'une page à une autre simplement depuis vos ViewModels.

Navegar permet également, sur le même principe, une navigation inspirée des applications Windows 8 mais pour les applications WPF.

Il s'agit d'un ensemble de classes dont les binaires sont disponibles sur Nuget et dont le code source est lui disponible sur cette plateforme. Un ensemble de documentation et de tutoriaux sont disponibles sur navegar.kopigi.fr

##Exemple de navigation Voici un petit exemple de la syntaxe pour naviguer vers une nouvelle page

/// <summary>
/// Permet de naviguer la page de gestion du client
/// </summary>
private void OpenClient(Client client)
{
    //Navigation vers la page ClientPage
    //this sert à indiquer que le ViewModel actuel (et donc par extension la page) sera ajouté à l'historique de navigation, afin que Navegar puisse savoir qu'il doit revenir vers cette page au Back
    //new object[]{client} permet de passer l'objet client au constructeur du ViewModel ClientPageViewModel
    //true indique que l'on souhaite générer une nouvelle instance du ViewModel ClientPageViewModel
    
    ServiceLocator.Current.GetInstance<INavigation>.NavigateTo<ClientPageViewModel>(this, new object[] {client}, true);
}

##Installation Afin d'intégrer Navegar à votre application vous devez installer le package NuGet :

PM> Install-Package Navegar 

##Nouveautés : V4.5.9 :

• Plateformes UAP/UWP/Xamarin.Forms : ajout d'un argument PreNavigationArgs à l'événement PreviewNavigate afin de pouvoir modifier la fonction à charger au cours d'une navigation, pendant le déclenchement de la pré-navigation

V4.5.8.8 :

• Correction sur la fonction ShowVirtualBackButton

V4.5.8.6 :

• Corrections sur la fonction GetViewModelCurrent

V4.5.7:

• Windows 10 : Gestion de l'affichage du bouton virtuel (dans la barre de titre de l'application) par un paramétre de la fonction RegisterView
• Windows 10 : Gestion du passage en mode Tablette/Desktop automatiquement pour le bouton de retour virtuel

V4.5.6 :

• Suppport de Xamarin.Forms
• Modification de la structure du projet, désormais une DLL NavegarLibs contient les interfaces INavigationWpf et INavigation (pour les UAP/UWP et Xamarin.Forms), ainsi que les exceptions. Chaque plateforme (WPF/UAP/UWP/Xamarin.Forms) est gérée dans une DLL à part installée à partir du package Navegar (ce package étant dépendant du package NavegarLibs il l'installe en même temps). Ceci afin de permettre de réaliser une DLL Portable pour partager le code métier de votre application entre les UAP/UWP et Xamarin.Forms et avoir une navigation unique dans vos ViewModels. Vous pouvez donc installer avec cette DLL portable le package NavegarLibs pour bénéficier des interfaces et des exceptions et installer la dll de la plateforme sur chaque projet.
• Version Windows 10 : Replacement de l'événement BackVirtualButtonPressed (pour personnaliser le retour arrière dans l'application) par l'événement BackButtonPressed qui gére les boutons physiques (ou virtuels sur Windows Phone) et virtuels dans la barre de titre des applications UWP Windows 10
• Ajout d'une propriété CurrentPlatform indiquant la plateforme courante (WPF/UAP/UWP ou Xamarin)

V4.0.3 Release Candidate :

• Version Windows 10 : gestion du bouton de retour virtuel dans la barre de titre des applications UWP en version desktop. Avec la fonction ShowVirtualBackButton (affichage du bouton) et l'événement BackVirtualButtonPressed (pour personnaliser le retour arrière dans l'application)
• Version Windows 10 : ajout d'une propriété HasVirtualBackButtonShow indiquant si le bouton de retour virtuel est actuellement affiché

V4.0.2 Release Candidate :

• Version Windows 10 : ajout d'une propriété HasBackButton indiquant si le device posséde un bouton de retour

V4 Release Candidate :

• Ajout du support pour Windows 10 en Universal Window Platform
• Support de la présence d'un bouton de retour suivant les nouvelles capacités de détection du SDK Windows 10 :

• Solution pour Visual Studio 2015 RC avec le projet pour la librairie pour Windows 10 et l'application exemple pour Windows 10 (la solution VS 2013 est toujours présente avec le support pour Windows 8.1)

##Tutoriaux

Voici différents tutoriaux vous permettant de vous familiariser avec la librairie :

• 01. Installer et paramétrer Navegar
• [02. Maintenant Navigons...] (http://blog.kopigi.fr/index.php?article14/02-maintenant-navigons)
• [03. Fonctionnalités avancées] (http://blog.kopigi.fr/index.php?article15/03-fonctionnalites-avancees)

##Documentation en ligne

Vous trouverez également la documentation (en ligne) du code, pour les plateformes WPF et Windows 8.1 & Windows Phone 8.1 (WinRT)

• Plateforme WPF
• Plateforme Universal Application Plateform - Windows 8.1
• Plateforme Universal Application Plateform - Windows Phone 8.1

##Assistants Visual Studio

Enfin des assistants interactifs pour Visual Studio vous permettent également de suivre la mise en place de Navegar dans un projet

• Navegar dans WPF
• Navegar dans Windows 8.1
• Navegar dans Windows Phone 8.1

Vous pouvez également retrouver le contenu de ces assistants dans le repertoire doc du projet ou ici :

• Navegar dans WPF (en ligne)
• Navegar dans Windows 8.1 (en ligne)
• Navegar dans Windows Phone 8.1 (en ligne)

Si vous rencontrez des soucis pour intégrer Navegar dans votre application, n'hésitez pas à revenir vers moi.