如何通过样式设置MAUI状态栏颜色？

直接在页面样式中设置StatusBarColor和StatusBarStyle属性之所以无效，是因为这两个属性的生效依赖平台级API调用，单纯通过样式设置属性值不会触发对应的状态栏更新逻辑。以下是具体的解决方法：

1. 确认CommunityToolkit.Maui已正确初始化 #

首先确保你已经完成基础配置：

• 安装NuGet包：CommunityToolkit.Maui
• 在MauiProgram.cs中添加初始化代码：

  builder.UseMauiCommunityToolkit();
  

2. 通过代码后台主动触发状态栏更新 #

方法一：在页面OnAppearing中设置 #

在目标页面的代码后台重写OnAppearing方法，直接设置状态栏属性，这会触发平台API调用：

protected override void OnAppearing()
{
    base.OnAppearing();
    // 直接设置颜色和样式
    StatusBarColor = Colors.DarkSlateGray;
    StatusBarStyle = CommunityToolkit.Maui.Core.StatusBarStyle.LightContent;
}

如果需要复用样式中的颜色值，可以从页面资源中获取：

var statusBarColor = (Color)Resources["PrimaryDarkColor"];
StatusBarColor = statusBarColor;

方法二：通过行为（Behavior）实现绑定式更新 #

如果需要和ViewModel的属性联动，可自定义一个行为来监听属性变化并自动更新状态栏：

using CommunityToolkit.Maui.Core.Platform;
using Microsoft.Maui.Controls;
using System.ComponentModel;

namespace YourAppNamespace.Behaviors;

public class StatusBarUpdateBehavior : Behavior<ContentPage>
{
    public static readonly BindableProperty BarColorProperty =
        BindableProperty.Create(nameof(BarColor), typeof(Color), typeof(StatusBarUpdateBehavior), Colors.Default);

    public static readonly BindableProperty BarStyleProperty =
        BindableProperty.Create(nameof(BarStyle), typeof(StatusBarStyle), typeof(StatusBarUpdateBehavior), StatusBarStyle.Default);

    public Color BarColor
    {
        get => (Color)GetValue(BarColorProperty);
        set => SetValue(BarColorProperty, value);
    }

    public StatusBarStyle BarStyle
    {
        get => (StatusBarStyle)GetValue(BarStyleProperty);
        set => SetValue(BarStyleProperty, value);
    }

    protected override void OnAttachedTo(ContentPage page)
    {
        base.OnAttachedTo(page);
        UpdateStatusBar();
        // 监听自身属性变化
        PropertyChanged += OnBehaviorPropertyChanged;
    }

    protected override void OnDetachingFrom(ContentPage page)
    {
        base.OnDetachingFrom(page);
        PropertyChanged -= OnBehaviorPropertyChanged;
    }

    private void OnBehaviorPropertyChanged(object? sender, PropertyChangedEventArgs e)
    {
        if (e.PropertyName == nameof(BarColor) || e.PropertyName == nameof(BarStyle))
        {
            UpdateStatusBar();
        }
    }

    private void UpdateStatusBar()
    {
        if (BarColor != Colors.Default)
            StatusBar.SetColor(BarColor);
        
        if (BarStyle != StatusBarStyle.Default)
            StatusBar.SetStyle(BarStyle);
    }
}

然后在XAML中引用该行为并绑定ViewModel的属性：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:behaviors="clr-namespace:YourAppNamespace.Behaviors"
             x:Class="YourAppNamespace.Views.YourPage">
    <ContentPage.Behaviors>
        <behaviors:StatusBarUpdateBehavior 
            BarColor="{Binding CurrentStatusBarColor}"
            BarStyle="{Binding CurrentStatusBarStyle}" />
    </ContentPage.Behaviors>
    <!-- 页面内容 -->
</ContentPage>

3. 关于样式的补充说明 #

你可以保留页面样式中对StatusBarColor和StatusBarStyle的定义，但需要配合上述代码逻辑——样式仅负责设置属性值，而状态栏的实际更新需要通过代码触发平台API调用才能生效。

内容的提问来源于stack exchange，提问作者BillF