Aller au contenu

Navigation v12

Avalonia 12 apporte des pages et une pile de navigation, pensées pour le mobile mais utilisables partout.

Contrôle Rôle
ContentPage une page : en-tête, icône, contenu
NavigationPage pile de pages avec barre et bouton retour
TabbedPage pages en onglets
DrawerPage tiroir latéral (menu hamburger) + contenu
CarouselPage pages qui défilent au glissement
Aperçu · les 3 conteneurs de pages
‹ Produit 42
ContentPage
NavigationPage : barre + retour
Accueil
ContentPage
🏠
Accueil
🔍
Recherche
👤
Profil
TabbedPage : onglets
☰ Mon app
contenu
Menu🏠 Accueil⚙️ Paramètres
DrawerPage : tiroir ouvert

Une NavigationPage dans une fenêtre

MainWindow.axaml
<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:p="using:MonApp.Pages"
        x:Class="MonApp.MainWindow" Title="Boutique">
  <NavigationPage>
    <p:AccueilPage />
  </NavigationPage>
</Window>

Le contenu de la NavigationPage est sa page racine.

Créer une page

<ContentPage xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             x:Class="MonApp.Pages.AccueilPage"
             Header="Accueil">
  <StackPanel Margin="16" Spacing="8">
    <TextBlock Text="Produits" FontSize="22" FontWeight="Bold" />
    <Button Content="Voir le produit n°42" Click="OnOuvrir" />
  </StackPanel>
</ContentPage>
using Avalonia.Controls;
using Avalonia.Interactivity;

namespace MonApp.Pages;

public partial class AccueilPage : ContentPage
{
    public AccueilPage() => InitializeComponent();

    private async void OnOuvrir(object? sender, RoutedEventArgs e)
        => await Navigation!.PushAsync(new ProduitPage(42));
}
public partial class ProduitPage : ContentPage
{
    public ProduitPage() => InitializeComponent();

    public ProduitPage(int id) : this()
    {
        Header = $"Produit {id}";
        // charger le produit…
    }

    private async void OnRetour(object? sender, RoutedEventArgs e)
        => await Navigation!.PopAsync();
}

Content d'une ContentPage ne peut pas être une autre page.

La NavigationPage gère une pile : on empile une page pour avancer, on dépile pour revenir.

départ Accueil PushAsync(Détail) après Push Accueil Détail 👁 PopAsync() Accueil👁 👁 = page affichée (le haut de la pile)

await Navigation.PushAsync(new DetailPage());        // empiler
await Navigation.PopAsync();                         // revenir
await Navigation.PopToRootAsync();                   // revenir à la racine
await Navigation.ReplaceAsync(new AccueilPage());    // remplacer (ex. après connexion)

await Navigation.PushModalAsync(new FiltresPage());  // page modale
await Navigation.PopModalAsync();

Transition personnalisée

await Navigation.PushAsync(new DetailPage(), new PageSlide(TimeSpan.FromMilliseconds(250)));
<NavigationPage>
  <NavigationPage.PageTransition>
    <CrossFade Duration="0:0:0.2" />
  </NavigationPage.PageTransition>
  <p:AccueilPage />
</NavigationPage>

Personnaliser la barre

<ContentPage Header="Paiement"
             NavigationPage.HasBackButton="False"
             NavigationPage.HasNavigationBar="True">
<!-- Barre masquée sur l'écran d'accueil -->
<ContentPage NavigationPage.HasNavigationBar="False" />
Sur NavigationPage
CanGoBack, StackDepth, NavigationStack état de la pile
BarHeight hauteur de la barre (48 par défaut)
IsGestureEnabled balayage pour revenir
IsBackButtonVisible, HasShadow apparence

Cycle de vie d'une page

sequenceDiagram
  participant A as AccueilPage
  participant N as NavigationPage
  participant E as EditionPage
  A->>N: PushAsync(EditionPage)
  N->>E: OnNavigatedTo → Charger()
  Note over E: l'utilisateur modifie
  E->>N: bouton retour
  N->>E: OnNavigatingFrom (e.Cancel = true ?)
  alt modifications non enregistrées
    E-->>N: Cancel = true : on reste
  else rien à perdre
    N->>A: retour à l'accueil
  end
public partial class EditionPage : ContentPage
{
    protected override void OnNavigatedTo(NavigatedToEventArgs e)
    {
        base.OnNavigatedTo(e);
        Charger();
    }

    protected override void OnNavigatingFrom(NavigatingFromEventArgs e)
    {
        base.OnNavigatingFrom(e);
        if (_modificationsNonEnregistrees)
            e.Cancel = true;   // bloque le retour
    }
}

TabbedPage

<TabbedPage xmlns="https://github.com/avaloniaui" TabPlacement="Bottom">
  <ContentPage Header="Accueil">
    <ContentPage.Icon>
      <PathIcon Data="M10 20v-6h4v6h5v-8h3L12 3 2 12h3v8z" />
    </ContentPage.Icon>
    <TextBlock Text="Accueil" Margin="16" />
  </ContentPage>

  <ContentPage Header="Recherche">
    <TextBlock Text="Recherche" Margin="16" />
  </ContentPage>

  <ContentPage Header="Profil">
    <TextBlock Text="Profil" Margin="16" />
  </ContentPage>
</TabbedPage>

TabPlacement : Auto, Top, Bottom, Left, Right.

Une pile par onglet

flowchart TB
  T["TabbedPage"] --> N1["NavigationPage « Catalogue »"]
  T --> N2["NavigationPage « Panier »"]
  N1 --> C1["CataloguePage"] --> C2["ProduitPage (empilée)"]
  N2 --> P1["PanierPage"]

Changer d'onglet ne perd pas la position : chaque onglet garde sa propre pile.

<TabbedPage TabPlacement="Bottom">
  <NavigationPage Header="Catalogue">
    <p:CataloguePage />
  </NavigationPage>
  <NavigationPage Header="Panier">
    <p:PanierPage />
  </NavigationPage>
</TabbedPage>

DrawerPage

<DrawerPage x:Name="Tiroir" Header="Mon application" DrawerLength="280">
  <DrawerPage.Drawer>
    <StackPanel Margin="8" Spacing="4">
      <Button Content="Accueil" HorizontalAlignment="Stretch" Click="OnAccueil" />
      <Button Content="Paramètres" HorizontalAlignment="Stretch" Click="OnParametres" />
    </StackPanel>
  </DrawerPage.Drawer>

  <NavigationPage x:Name="Pile">
    <p:AccueilPage />
  </NavigationPage>
</DrawerPage>
private async void OnParametres(object? sender, RoutedEventArgs e)
{
    Tiroir.IsOpen = false;
    await Pile.PushAsync(new ParametresPage());
}

Avec une NavigationPage en contenu, l'icône hamburger devient un bouton retour dès qu'une page est empilée.

Propriété Valeurs
IsOpen ouvre / ferme le tiroir
DrawerPlacement Left, Right, Top, Bottom
DrawerBehavior Auto, Flyout, Locked, Disabled
DrawerLayoutBehavior Overlay, Split, CompactOverlay, CompactInline
DrawerBreakpointLength largeur à partir de laquelle le tiroir reste ouvert

Sans les pages : navigation par ViewModel

Pour une application desktop classique, un ContentControl lié au ViewModel courant suffit :

<TransitioningContentControl Content="{Binding PageCourante}" />

Voir DataTemplates et ViewLocator.