Pasek nawigacyjny systemu Android

Zapewnia NavigationBar możliwość dostosowywania wyglądu paska nawigacyjnego na platformie Android.

Funkcja zapewnia możliwość ustawiania:

Kolor paska

Właściwość Color umożliwia podanie dowolnego Color elementu do użycia w ustawieniu koloru tła paska nawigacyjnego.

Styl paska

Właściwość Style umożliwia dostosowanie koloru pierwszego planu nawigacji przy użyciu następujących dozwolonych wartości:

• Default — jest to ustawienie domyślne i będzie używać ustawień motywu systemowego.
• LightContent - pierwszy plan będzie stosować kolor motywu jasnego.
• DarkContent - pierwszy plan będzie stosować kolor motywu ciemnego.

Składnia

W poniższych przykładach pokazano, jak użyć NavigationBar elementu , aby ustawić kolor tła na DarkSlateBlue i styl pierwszego planu na LightContentwartość .

XAML

Dołączanie przestrzeni nazw XAML

Uwaga

Jest to inna przestrzeń nazw dla standardowej przestrzeni nazw zestawu narzędzi ze względu na specyficzny charakter danej funkcji i jej użycia.

Aby można było używać tej funkcji w języku XAML, należy dodać następujące xmlns elementy do strony lub widoku:

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

W związku z tym następujące elementy:

<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>

Zostanie zmodyfikowana tak, aby zawierała następujące xmlns elementy:

<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>

Korzystanie z paska nawigacyjnego

Można NavigationBar go użyć w następujący sposób w języku 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#

Można NavigationBar go użyć w następujący sposób w języku C#:

using CommunityToolkit.Maui.PlatformConfiguration.AndroidSpecific;

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

Przykłady

Przykład tej funkcji można znaleźć w aplikacji przykładowej zestawu narzędzi .NET MAUI Community Toolkit.

interfejs API

Kod źródłowy można NavigationBar znaleźć w repozytorium GitHub zestawu narzędzi .NET MAUI Community Toolkit.