Barra di spostamento Android

NavigationBar offre la possibilità di personalizzare l'aspetto della barra di spostamento nella piattaforma Android.

La funzionalità offre la possibilità di impostare:

Colore barra

La Color proprietà consente di specificare qualsiasi Color elemento da utilizzare nell'impostazione del colore di sfondo della barra di spostamento.

Stile barra

La Style proprietà consente di personalizzare il colore di primo piano della navigazione con i valori consentiti seguenti:

• Default : questa è l'impostazione predefinita e userà le impostazioni del tema di sistema.
• LightContent - il primo piano applicherà il colore del tema chiaro.
• DarkContent - il primo piano applicherà il colore del tema scuro.

Sintassi

Negli esempi seguenti viene illustrato come utilizzare per NavigationBar impostare il colore di sfondo su DarkSlateBlue e lo stile di primo piano su LightContent.

XAML

Inclusione dello spazio dei nomi XAML

Nota

Si tratta di uno spazio dei nomi diverso rispetto allo spazio dei nomi standard del toolkit a causa della natura specifica della piattaforma della funzionalità e del relativo utilizzo.

Per usare questa funzionalità in XAML, è necessario aggiungere le informazioni seguenti xmlns nella pagina o nella visualizzazione:

xmlns:droid="clr-namespace:CommunityToolkit.Maui.PlatformConfiguration.AndroidSpecific;assembly=CommunityToolkit.Maui"

Di conseguenza:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.NavigationBarPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

</ContentPage>

Verrà modificato in modo da includere l'oggetto xmlns come indicato di seguito:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.NavigationBarPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:droid="clr-namespace:CommunityToolkit.Maui.PlatformConfiguration.AndroidSpecific;assembly=CommunityToolkit.Maui">

</ContentPage>

Uso della barra di spostamento

Può NavigationBar essere usato come segue in XAML:

<ContentPage 
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:droid="clr-namespace:CommunityToolkit.Maui.PlatformConfiguration.AndroidSpecific;assembly=CommunityToolkit.Maui"
    x:Class="CommunityToolkit.Maui.Sample.Pages.NavigationBarPage"
    droid:NavigationBar.Color="DarkSlateBlue"
    droid:NavigationBar.Style="LightContent">
    
</ContentPage>

C#

Può NavigationBar essere usato come indicato di seguito in C#:

using CommunityToolkit.Maui.PlatformConfiguration.AndroidSpecific;

class NavigationBarPage : ContentPage
{
    public NavigationBarPage()
    {
	this.On<Android>().SetColor(Colors.Purple);
	this.On<Android>().SetStyle(NavigationBarStyle.DarkContent);
    }
}

Esempi

È possibile trovare un esempio di questa funzionalità in azione nell'applicazione di esempio .NET MAUI Community Toolkit.

API

È possibile trovare il codice sorgente per NavigationBar over nel repository GitHub di .NET MAUI Community Toolkit.