Initial commit

Author: 0x5bfa

src/Files.App.Controls/BreadcrumbBar/BreadcrumbBar.Events.cs

@@ -0,0 +1,24 @@
+// Copyright (c) Files Community
+// Licensed under the MIT License.
+
+using Microsoft.UI;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Input;
+using Microsoft.UI.Xaml.Markup;
+using Microsoft.UI.Xaml.Media;
+using Microsoft.UI.Xaml.Shapes;
+
+namespace Files.App.Controls
+{
+	public partial class BreadcrumbBar
+	{
+		private void ItemsRepeater_ElementPrepared(ItemsRepeater sender, ItemsRepeaterElementPreparedEventArgs args)
+		{
+			if (args.Element is not BreadcrumbBarItem item)
+				return;
+
+			item.SetOwner(this);
+		}
+	}
+}

src/Files.App.Controls/BreadcrumbBar/BreadcrumbBar.Properties.cs

@@ -0,0 +1,34 @@
+// Copyright (c) Files Community
+// Licensed under the MIT License.
+
+using CommunityToolkit.WinUI;
+using Microsoft.UI;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Input;
+using Microsoft.UI.Xaml.Markup;
+using Microsoft.UI.Xaml.Media;
+using Microsoft.UI.Xaml.Shapes;
+
+namespace Files.App.Controls
+{
+	public partial class BreadcrumbBar : Control
+	{
+		[GeneratedDependencyProperty]
+		public partial object? ItemsSource { get; set; }
+
+		[GeneratedDependencyProperty]
+		public partial object? ItemTemplate { get; set; }
+
+		[GeneratedDependencyProperty]
+		public partial FrameworkElement? RootElement { get; set; }
+
+		partial void OnItemsSourceChanged(object? newValue)
+		{
+		}
+
+		partial void OnItemTemplateChanged(object? newValue)
+		{
+		}
+	}
+}

src/Files.App.Controls/BreadcrumbBar/BreadcrumbBar.cs

@@ -0,0 +1,88 @@
+// Copyright (c) Files Community
+// Licensed under the MIT License.
+
+using CommunityToolkit.WinUI;
+using Microsoft.UI;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Input;
+using Microsoft.UI.Xaml.Markup;
+using Microsoft.UI.Xaml.Media;
+using Microsoft.UI.Xaml.Shapes;
+using System;
+using Windows.Foundation;
+
+namespace Files.App.Controls
+{
+	// Template parts
+	[TemplatePart(Name = "PART_ItemsRepeater", Type = typeof(ItemsRepeater))]
+	public partial class BreadcrumbBar : Control
+	{
+		// Constants
+
+		private const string TemplatePartName_RootItem = "PART_RootBreadcrumbBarItem";
+		private const string TemplatePartName_MainItemsRepeater = "PART_MainItemsRepeater";
+
+		// Fields
+
+		private BreadcrumbBarLayout _itemsRepeaterLayout = null!;
+
+		private BreadcrumbBarItem? _rootItem;
+		private ItemsRepeater? _itemsRepeater;
+
+		// Events
+
+		public event TypedEventHandler<BreadcrumbBar, BreadcrumbBarItemClickedEventArgs>? ItemClicked;
+		public event EventHandler<BreadcrumbBarItemDropDownFlyoutEventArgs>? ItemDropDownFlyoutOpening;
+		public event EventHandler<BreadcrumbBarItemDropDownFlyoutEventArgs>? ItemDropDownFlyoutClosed;
+
+		public event EventHandler? RootItemClicked;
+		public event EventHandler<BreadcrumbBarItemDropDownFlyoutEventArgs>? RootItemDropDownFlyoutOpening;
+		public event EventHandler<BreadcrumbBarItemDropDownFlyoutEventArgs>? RootItemDropDownFlyoutClosed;
+
+		// Constructor
+
+		public BreadcrumbBar()
+		{
+			DefaultStyleKey = typeof(BreadcrumbBar);
+
+			_itemsRepeaterLayout = new(this, 2d);
+		}
+
+		// Methods
+
+		protected override void OnApplyTemplate()
+		{
+			_rootItem = GetTemplateChild(TemplatePartName_RootItem) as BreadcrumbBarItem
+				?? throw new MissingFieldException($"Could not find {TemplatePartName_RootItem} in the given {nameof(BreadcrumbBarItem)}'s style.");
+			_itemsRepeater = GetTemplateChild(TemplatePartName_MainItemsRepeater) as ItemsRepeater
+				?? throw new MissingFieldException($"Could not find {TemplatePartName_MainItemsRepeater} in the given {nameof(BreadcrumbBar)}'s style.");
+
+			_rootItem.SetOwner(this);
+			_itemsRepeater.Layout = _itemsRepeaterLayout;
+
+			_itemsRepeater.ElementPrepared += ItemsRepeater_ElementPrepared;
+
+			base.OnApplyTemplate();
+		}
+
+		internal void RaiseItemClickedEvent(BreadcrumbBarItem item)
+		{
+			var index = _itemsRepeater?.GetElementIndex(item) ?? throw new ArgumentNullException($"{_itemsRepeater} is null.");
+			var eventArgs = new BreadcrumbBarItemClickedEventArgs(item, index);
+			ItemClicked?.Invoke(this, eventArgs);
+		}
+
+		internal void RaiseItemDropDownFlyoutOpening(BreadcrumbBarItem item, MenuFlyout flyout)
+		{
+			var index = _itemsRepeater?.GetElementIndex(item) ?? throw new ArgumentNullException($"{_itemsRepeater} is null.");
+			ItemDropDownFlyoutOpening?.Invoke(this, new(flyout, item, index));
+		}
+
+		internal void RaiseItemDropDownFlyoutClosed(BreadcrumbBarItem item, MenuFlyout flyout)
+		{
+			var index = _itemsRepeater?.GetElementIndex(item) ?? throw new ArgumentNullException($"{_itemsRepeater} is null.");
+			ItemDropDownFlyoutClosed?.Invoke(this, new(flyout, item, index));
+		}
+	}
+}