maui-linux/Handlers/ProgressBarHandler.cs

// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.

using System.ComponentModel;
using Microsoft.Maui.Controls;
using Microsoft.Maui.Handlers;
using Microsoft.Maui.Graphics;
using Microsoft.Maui.Platform;

namespace Microsoft.Maui.Platform.Linux.Handlers;

/// <summary>
/// Handler for ProgressBar on Linux using Skia rendering.
/// Maps IProgress interface to SkiaProgressBar platform view.
/// IProgress has: Progress (0-1), ProgressColor
/// </summary>
public partial class ProgressBarHandler : ViewHandler<IProgress, SkiaProgressBar>
{
    public static IPropertyMapper<IProgress, ProgressBarHandler> Mapper = new PropertyMapper<IProgress, ProgressBarHandler>(ViewHandler.ViewMapper)
    {
        [nameof(IProgress.Progress)] = MapProgress,
        [nameof(IProgress.ProgressColor)] = MapProgressColor,
        [nameof(IView.IsEnabled)] = MapIsEnabled,
        [nameof(IView.Background)] = MapBackground,
        ["BackgroundColor"] = MapBackgroundColor,
        [nameof(IView.Height)] = MapHeight,
        [nameof(IView.Width)] = MapWidth,
        ["VerticalOptions"] = MapVerticalOptions,
    };

    public static CommandMapper<IProgress, ProgressBarHandler> CommandMapper = new(ViewHandler.ViewCommandMapper)
    {
    };

    public ProgressBarHandler() : base(Mapper, CommandMapper)
    {
    }

    public ProgressBarHandler(IPropertyMapper? mapper, CommandMapper? commandMapper = null)
        : base(mapper ?? Mapper, commandMapper ?? CommandMapper)
    {
    }

    protected override SkiaProgressBar CreatePlatformView()
    {
        return new SkiaProgressBar();
    }

    protected override void ConnectHandler(SkiaProgressBar platformView)
    {
        base.ConnectHandler(platformView);

        if (VirtualView is BindableObject bindable)
        {
            bindable.PropertyChanged += OnVirtualViewPropertyChanged;
        }

        if (VirtualView is VisualElement visualElement)
        {
            platformView.IsVisible = visualElement.IsVisible;
        }

        // Sync properties
        if (VirtualView != null)
        {
            MapProgress(this, VirtualView);
            MapProgressColor(this, VirtualView);
            MapIsEnabled(this, VirtualView);
        }
    }

    protected override void DisconnectHandler(SkiaProgressBar platformView)
    {
        if (VirtualView is BindableObject bindable)
        {
            bindable.PropertyChanged -= OnVirtualViewPropertyChanged;
        }

        base.DisconnectHandler(platformView);
    }

    private void OnVirtualViewPropertyChanged(object? sender, PropertyChangedEventArgs e)
    {
        if (VirtualView is VisualElement visualElement && e.PropertyName == nameof(VisualElement.IsVisible))
        {
            PlatformView.IsVisible = visualElement.IsVisible;
            PlatformView.Invalidate();
        }
    }

    public static void MapProgress(ProgressBarHandler handler, IProgress progress)
    {
        if (handler.PlatformView is null) return;
        handler.PlatformView.Progress = Math.Clamp(progress.Progress, 0.0, 1.0);
    }

    public static void MapProgressColor(ProgressBarHandler handler, IProgress progress)
    {
        if (handler.PlatformView is null) return;

        if (progress.ProgressColor is not null)
        {
            handler.PlatformView.ProgressColor = progress.ProgressColor;
        }
        handler.PlatformView.Invalidate();
    }

    public static void MapIsEnabled(ProgressBarHandler handler, IProgress progress)
    {
        if (handler.PlatformView is null) return;

        handler.PlatformView.IsEnabled = progress.IsEnabled;
        handler.PlatformView.Invalidate();
    }

    public static void MapBackground(ProgressBarHandler handler, IProgress progress)
    {
        if (handler.PlatformView is null) return;

        if (progress.Background is SolidPaint solidPaint && solidPaint.Color is not null)
        {
            handler.PlatformView.BackgroundColor = solidPaint.Color;
            handler.PlatformView.Invalidate();
        }
    }

    public static void MapBackgroundColor(ProgressBarHandler handler, IProgress progress)
    {
        if (handler.PlatformView is null) return;

        if (progress is VisualElement visualElement && visualElement.BackgroundColor is not null)
        {
            handler.PlatformView.TrackColor = visualElement.BackgroundColor;
            handler.PlatformView.Invalidate();
        }
    }

    public static void MapHeight(ProgressBarHandler handler, IProgress progress)
    {
        if (handler.PlatformView is null) return;

        if (progress is VisualElement visualElement && visualElement.HeightRequest >= 0)
        {
            handler.PlatformView.HeightRequest = visualElement.HeightRequest;
        }
    }

    public static void MapWidth(ProgressBarHandler handler, IProgress progress)
    {
        if (handler.PlatformView is null) return;

        if (progress is VisualElement visualElement && visualElement.WidthRequest >= 0)
        {
            handler.PlatformView.WidthRequest = visualElement.WidthRequest;
        }
    }

    public static void MapVerticalOptions(ProgressBarHandler handler, IProgress progress)
    {
        if (handler.PlatformView is null) return;

        if (progress is Microsoft.Maui.Controls.View view)
        {
            handler.PlatformView.VerticalOptions = view.VerticalOptions;
        }
    }
}