src/Files.App.Controls/ThemedIcon/ThemedIcon.cs - main - githubmirror/Files

src/Files.App.Controls/ThemedIcon/ThemedIcon.cs
271 строка7 KB
yair100
Code Quality: Performance optimizations (#18801)
06 авг 2026, 17:33
06 авг 2026, 17:337dc84dd
// Copyright (c) Files Community
// Licensed under the MIT License.

using Microsoft.UI.Xaml.Markup;
using Microsoft.UI.Xaml.Media;
using Microsoft.UI.Xaml.Shapes;

namespace Files.App.Controls
{
	/// <summary>
	/// A control for a State and Color aware Icon
	/// </summary>
	public partial class ThemedIcon : Control
	{
		private Viewbox? _filledViewBox;
		private Viewbox? _outlineViewBox;
		private Viewbox? _layeredViewBox;
		private Canvas? _layeredCanvas;

		private long _stylePropertyChangedToken;

		public ThemedIcon()
		{
			DefaultStyleKey = typeof(ThemedIcon);
			_stylePropertyChangedToken = RegisterPropertyChangedCallback(
				StyleProperty,
				OnStylePropertyChanged
			);

			Unloaded += OnUnloaded;
		}

		private void OnUnloaded(object sender, RoutedEventArgs e)
		{
			UnregisterPropertyChangedCallback(StyleProperty, _stylePropertyChangedToken);
			IsEnabledChanged -= OnIsEnabledChanged;
			Unloaded -= OnUnloaded;
		}

		protected override void OnApplyTemplate()
		{
			base.OnApplyTemplate();

			IsEnabledChanged += OnIsEnabledChanged;

			_isOwnerEnabled = IsEnabled;

			GetTemplateParts();

			FindOwnerControlStates();
			OnFilledIconChanged();
			OnOutlineIconChanged();
			OnLayeredIconChanged();

			OnIconTypeChanged();
			OnIconColorTypeChanged();
			OnIconSizeChanged();
		}

		private void GetTemplateParts()
		{
			// Gets the template parts and sets the private fields
			_outlineViewBox = GetTemplateChild(OutlinePathIconViewBox) as Viewbox;
			_filledViewBox = GetTemplateChild(FilledPathIconViewBox) as Viewbox;
			_layeredViewBox = GetTemplateChild(LayeredPathIconViewBox) as Viewbox;

			_layeredCanvas = GetTemplateChild(LayeredPathCanvas) as Canvas;
		}

		// Updates paths and layers

		private void OnFilledIconChanged()
		{
			// Updates Filled Icon from Path Data
			if (_filledViewBox == null)
				return;

			SetPathData(FilledIconPath, FilledIconData ?? string.Empty, _filledViewBox);
		}

		private void OnOutlineIconChanged()
		{
			// Updates Outline Icon from Path Data
			if (_outlineViewBox == null)
				return;

			SetPathData(OutlineIconPath, OutlineIconData ?? string.Empty, _outlineViewBox);
		}

		private void OnLayeredIconChanged()
		{
			// Updates Layered Icon from it's Layers
			if (_layeredViewBox == null ||
				 _layeredCanvas == null ||
				 Layers is not ICollection<ThemedIconLayer> layers)
				return;

			_layeredCanvas.Children.Clear();

			foreach (var layer in layers)
			{
				_layeredCanvas.Children.Add(
					new ThemedIconLayer()
					{
						LayerType = layer.LayerType,
						IconColorType = layer.IconColorType,
						PathData = layer.PathData,
						Opacity = layer.Opacity,
						LayerColor = Color,
						Foreground = Foreground,
						HorizontalAlignment = HorizontalAlignment.Stretch,
						VerticalAlignment = VerticalAlignment.Stretch,
						LayerSize = IconSize,
						Width = layer.LayerSize,
						Height = layer.LayerSize

					});
			}
		}

		// Updates visual states

		private void OnIconTypeChanged()
		{
			switch (ToggleBehavior)
			{
				case ToggleBehaviors.Auto:
					{
						if (_isOwnerToggled is true || IsFilled is true)
						{
							VisualStateManager.GoToState(this, FilledTypeStateName, true);
							return;
						}
						else if (IsHighContrast is true || _isOwnerEnabled is false || IsEnabled is false)
						{
							VisualStateManager.GoToState(this, OutlineTypeStateName, true);
							VisualStateManager.GoToState(this, DisabledStateName, true);
							return;
						}
						else
						{
							VisualStateManager.GoToState(
								this,
								IconType is ThemedIconTypes.Layered ? LayeredTypeStateName : OutlineTypeStateName,
								true);
						}
					}
					break;
				case ToggleBehaviors.Off:
					{
						if (IsFilled is true)
						{
							VisualStateManager.GoToState(this, FilledTypeStateName, true);
							return;
						}
						else if (IsHighContrast is true || _isOwnerEnabled is false || IsEnabled is false)
						{
							VisualStateManager.GoToState(this, OutlineTypeStateName, true);
							VisualStateManager.GoToState(this, DisabledStateName, true);
							return;
						}
						else
						{
							VisualStateManager.GoToState(
								this,
								IconType is ThemedIconTypes.Layered ? LayeredTypeStateName : OutlineTypeStateName,
								true);
						}
					}
					break;
				case ToggleBehaviors.On:
					{
						VisualStateManager.GoToState(this, FilledTypeStateName, true);
					}
					break;
			}

			VisualStateManager.GoToState(this, EnabledStateName, true);
		}

		private void OnIconColorTypeChanged()
		{
			if (_isOwnerEnabled && IsEnabled)
			{
				if ((ToggleBehavior is ToggleBehaviors.Auto && _isOwnerToggled) ||
					ToggleBehavior is ToggleBehaviors.On)
				{
					// Toggle
					VisualStateManager.GoToState(this, ToggleStateName, true);
				}
				else
				{
					// Use colorful ones
					VisualStateManager.GoToState(
						this,
						IconColorType switch
						{
							ThemedIconColorType.Critical => CriticalStateName,
							ThemedIconColorType.Caution => CautionStateName,
							ThemedIconColorType.Success => SuccessStateName,
							ThemedIconColorType.Neutral => NeutralStateName,
							ThemedIconColorType.Accent => AccentStateName,
							ThemedIconColorType.Custom => CustomColorStateName,
							_ => NormalStateName,
						},
						true);
				}

				// Update layered icon color
				if (_layeredCanvas != null)
					foreach (var layer in _layeredCanvas.Children.Cast<ThemedIconLayer>())
						layer.IconColorType = IconColorType;
			}
			else
			{
				// Disable + toggle
				if ((ToggleBehavior is ToggleBehaviors.Auto && _isOwnerToggled is true) ||
					ToggleBehavior is ToggleBehaviors.On)
					VisualStateManager.GoToState(this, DisabledToggleColorStateName, true);
				// Disable
				else
					VisualStateManager.GoToState(this, DisabledColorStateName, true);
			}
		}

		// Misc

		private void UpdateVisualStates()
		{
			OnIconTypeChanged();
			OnIconColorTypeChanged();
		}

		private void SetPathData(string partName, string pathData, FrameworkElement element)
		{
			// Updates PathData
			if (string.IsNullOrEmpty(pathData))
				return;

			// Parse the path mini-language directly instead of booting the full XAML parser (XamlReader.Load),
			// which cost ~20ms per icon. Same geometry, ~10x faster - and this runs for every icon in the app.
			var geometry = (Geometry)XamlBindingHelper.ConvertValue(typeof(Geometry), pathData);

			if (GetTemplateChild(partName) is Path path)
			{
				path.Data = geometry;
				path.Width = IconSize;
				path.Height = IconSize;
			}
		}

		private void OnIsEnabledChanged(object sender, DependencyPropertyChangedEventArgs e)
		{
			UpdateVisualStates();
		}

		private void OnIconColorChanged()
		{
			if (GetTemplateChild(OutlineIconPath) is Path outlinePath)
				outlinePath.Fill = (Brush)this.GetValue(ColorProperty);

			if (GetTemplateChild(FilledIconPath) is Path fillPath)
				fillPath.Fill = (Brush)this.GetValue(ColorProperty);
		}

		private void OnIconSizeChanged()
		{
			Height = Width = IconSize;
		}
	}
}