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 |
ContentPage
ContentPage
🏠
Accueil🔍
Recherche👤
Profil
Accueil🔍
Recherche👤
Profil
contenu
Menu🏠 Accueil⚙️ Paramètres
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>
Content d'une ContentPage ne peut pas être une autre page.
Naviguer¶
La NavigationPage gère une pile : on empile une page pour avancer, on dépile pour revenir.
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¶
<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 :