Feature: Added a filter header

src/Files.App/Actions/Show/ToggleFilterHeaderAction.cs

@@ -0,0 +1,50 @@
+// Copyright (c) Files Community
+// Licensed under the MIT License.
+
+using CommunityToolkit.WinUI;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+
+namespace Files.App.Actions
+{
+	internal sealed partial class ToggleFilterHeaderAction : ObservableObject, IToggleAction
+	{
+		private readonly IGeneralSettingsService generalSettingsService = Ioc.Default.GetRequiredService<IGeneralSettingsService>();
+
+		public string Label
+			=> Strings.ToggleFilterHeader.GetLocalizedResource();
+
+		public string Description
+			=> Strings.ToggleFilterHeaderDescription.GetLocalizedResource();
+
+		public RichGlyph Glyph
+			=> new(themedIconStyle: "App.ThemedIcons.Filter");
+
+		public bool IsOn
+			=> generalSettingsService.ShowFilterHeader;
+
+		public ToggleFilterHeaderAction()
+		{
+			generalSettingsService.PropertyChanged += GeneralSettingsService_PropertyChanged;
+		}
+
+		public Task ExecuteAsync(object? parameter = null)
+		{
+			generalSettingsService.ShowFilterHeader = !IsOn;
+
+			if (IsOn)
+			{
+				var filterTextBox = (MainWindow.Instance.Content as Frame)?.FindDescendant("FilterTextBox") as AutoSuggestBox;
+				filterTextBox?.Focus(FocusState.Programmatic);
+			}
+
+			return Task.CompletedTask;
+		}
+
+		private void GeneralSettingsService_PropertyChanged(object? sender, PropertyChangedEventArgs e)
+		{
+			if (e.PropertyName is nameof(GeneralSettingsService.ShowFilterHeader))
+				OnPropertyChanged(nameof(IsOn));
+		}
+	}
+}

src/Files.App/Data/Commands/Manager/CommandCodes.cs

@@ -27,6 +27,7 @@ public enum CommandCodes
 		ToggleInfoPane,
 		ToggleToolbar,
 		ToggleShelfPane,
+		ToggleFilterHeader,
 
 		// File System
 		CopyItem,

src/Files.App/Data/Commands/Manager/CommandManager.cs

@@ -58,6 +58,7 @@ public IRichCommand this[HotKey hotKey]
 		public IRichCommand ToggleInfoPane => commands[CommandCodes.ToggleInfoPane];
 		public IRichCommand ToggleToolbar => commands[CommandCodes.ToggleToolbar];
 		public IRichCommand ToggleShelfPane => commands[CommandCodes.ToggleShelfPane];
+		public IRichCommand ToggleFilterHeader => commands[CommandCodes.ToggleFilterHeader];
 		public IRichCommand SelectAll => commands[CommandCodes.SelectAll];
 		public IRichCommand InvertSelection => commands[CommandCodes.InvertSelection];
 		public IRichCommand ClearSelection => commands[CommandCodes.ClearSelection];
@@ -264,6 +265,7 @@ public IEnumerator<IRichCommand> GetEnumerator() =>
 			[CommandCodes.ToggleInfoPane] = new ToggleInfoPaneAction(),
 			[CommandCodes.ToggleToolbar] = new ToggleToolbarAction(),
 			[CommandCodes.ToggleShelfPane] = new ToggleShelfPaneAction(),
+			[CommandCodes.ToggleFilterHeader] = new ToggleFilterHeaderAction(),
 			[CommandCodes.SelectAll] = new SelectAllAction(),
 			[CommandCodes.InvertSelection] = new InvertSelectionAction(),
 			[CommandCodes.ClearSelection] = new ClearSelectionAction(),

src/Files.App/Data/Commands/Manager/ICommandManager.cs

@@ -32,6 +32,7 @@ public interface ICommandManager : IEnumerable<IRichCommand>
 		IRichCommand ToggleInfoPane { get; }
 		IRichCommand ToggleToolbar { get; }
 		IRichCommand ToggleShelfPane { get; }
+		IRichCommand ToggleFilterHeader { get; }
 
 		IRichCommand CopyItem { get; }
 		IRichCommand CopyItemPath { get; }

src/Files.App/Data/Contracts/IGeneralSettingsService.cs

@@ -295,6 +295,11 @@ public interface IGeneralSettingsService : IBaseSettingsService, INotifyProperty
 		/// </summary>
 		bool ShowShelfPane { get; set; }
 
+		/// <summary>
+		/// Gets or sets a value whether the filter header should be displayed.
+		/// </summary>
+		bool ShowFilterHeader { get; set; }
+
 		/// <summary>
 		/// Gets or sets a value indicating whether or not to enable the Omnibar.
 		/// </summary>

src/Files.App/Services/Settings/GeneralSettingsService.cs

@@ -363,6 +363,12 @@ public bool ShowShelfPane
 			set => Set(value);
 		}
 
+		public bool ShowFilterHeader
+		{
+			get => Get(false);
+			set => Set(value);
+		}
+
 		public bool EnableOmnibar
 		{
 			get => Get(false);

src/Files.App/Strings/en-US/Resources.resw

@@ -1097,6 +1097,12 @@
   <data name="ToggleToolbarDescription" xml:space="preserve">
     <value>Toggle visibility of the toolbar</value>
   </data>
+  <data name="ToggleFilterHeader" xml:space="preserve">
+    <value>Toggle filter header</value>
+  </data>
+  <data name="ToggleFilterHeaderDescription" xml:space="preserve">
+    <value>Toggle visibility of the filter header</value>
+  </data>
   <data name="DetailsPanePreviewNotAvaliableText" xml:space="preserve">
     <value>No preview available</value>
   </data>
@@ -4261,4 +4267,10 @@
   <data name="SeeMore" xml:space="preserve">
     <value>See more</value>
   </data>
+  <data name="FilteringFor" xml:space="preserve">
+    <value>Filtering for</value>
+  </data>
+  <data name="Filename" xml:space="preserve">
+    <value>Filename</value>
+  </data>
 </root>

src/Files.App/UserControls/Toolbar.xaml

@@ -500,6 +500,21 @@
 			Grid.Column="1"
 			DefaultLabelPosition="Right">
 
+			<!--  Toggle filter header  -->
+			<AppBarToggleButton
+				x:Name="FilterHeader"
+				Width="Auto"
+				MinWidth="40"
+				AccessKey="F"
+				AccessKeyInvoked="AppBarButton_AccessKeyInvoked"
+				AutomationProperties.Name="{x:Bind Commands.ToggleFilterHeader.AutomationName}"
+				IsChecked="{x:Bind Commands.ToggleFilterHeader.IsOn, Mode=TwoWay}"
+				Label="{x:Bind Commands.ToggleFilterHeader.Label}"
+				LabelPosition="Collapsed"
+				ToolTipService.ToolTip="{x:Bind Commands.ToggleFilterHeader.LabelWithHotKey, Mode=OneWay}">
+				<controls:ThemedIcon Style="{StaticResource App.ThemedIcons.Filter}" />
+			</AppBarToggleButton>
+
 			<!--  Selection Commands  -->
 			<AppBarButton
 				x:Name="SelectionOptions"

src/Files.App/ViewModels/ShellViewModel.cs

@@ -18,11 +18,11 @@
 using Windows.Storage;
 using Windows.Storage.FileProperties;
 using Windows.Storage.Search;
+using Windows.Win32.System.SystemServices;
 using static Files.App.Helpers.Win32PInvoke;
+using ByteSize = ByteSizeLib.ByteSize;
 using DispatcherQueue = Microsoft.UI.Dispatching.DispatcherQueue;
 using FileAttributes = System.IO.FileAttributes;
-using ByteSize = ByteSizeLib.ByteSize;
-using Windows.Win32.System.SystemServices;
 
 namespace Files.App.ViewModels
 {
@@ -114,6 +114,19 @@ public HorizontalAlignment FolderBackgroundImageHorizontalAlignment
 			private set => SetProperty(ref _FolderBackgroundImageHorizontalAlignment, value);
 		}
 
+		private ImageSource? _FolderThumbnailImageSource;
+		public ImageSource? FolderThumbnailImageSource
+		{
+			get => _FolderThumbnailImageSource;
+			private set => SetProperty(ref _FolderThumbnailImageSource, value);
+		}
+
+		public bool ShowFilterHeader =>
+			UserSettingsService.GeneralSettingsService.ShowFilterHeader &&
+			WorkingDirectory != "Home" &&
+			WorkingDirectory != "ReleaseNotes" &&
+			WorkingDirectory != "Settings";
+
 		private GitProperties _EnabledGitProperties;
 		public GitProperties EnabledGitProperties
 		{
@@ -213,7 +226,10 @@ public async Task SetWorkingDirectoryAsync(string? value)
 			GitDirectory = GitHelpers.GetGitRepositoryPath(WorkingDirectory, pathRoot);
 			IsValidGitDirectory = !string.IsNullOrEmpty((await GitHelpers.GetRepositoryHead(GitDirectory))?.Name);
 
+			_ = UpdateFolderThumbnailImageSource();
+
 			OnPropertyChanged(nameof(WorkingDirectory));
+			OnPropertyChanged(nameof(ShowFilterHeader));
 		}
 
 		public async Task<FilesystemResult<BaseStorageFolder>> GetFolderFromPathAsync(string value, CancellationToken cancellationToken = default)
@@ -275,6 +291,11 @@ public EmptyTextType EmptyTextType
 			set => SetProperty(ref emptyTextType, value);
 		}
 
+		public async Task UpdateFolderThumbnailImageSource()
+		{
+			FolderThumbnailImageSource = await NavigationHelpers.GetIconForPathAsync(WorkingDirectory);
+		}
+
 		public async Task UpdateSortOptionStatusAsync()
 		{
 			OnPropertyChanged(nameof(IsSortedByName));
@@ -676,6 +697,9 @@ await dispatcherQueue.EnqueueOrInvokeAsync(() =>
 					await OrderFilesAndFoldersAsync();
 					await ApplyFilesAndFoldersChangesAsync();
 					break;
+				case nameof(UserSettingsService.GeneralSettingsService.ShowFilterHeader):
+					OnPropertyChanged(nameof(ShowFilterHeader));
+					break;
 			}
 		}
 
@@ -715,7 +739,13 @@ public void UpdateEmptyTextType()
 			EmptyTextType = FilesAndFolders.Count == 0 ? (IsSearchResults ? EmptyTextType.NoSearchResultsFound : EmptyTextType.FolderEmpty) : EmptyTextType.None;
 		}
 
-		public string? FilesAndFoldersFilter { get; set; }
+		private string? _filesAndFoldersFilter;
+		public string? FilesAndFoldersFilter 
+		{ 
+			get => _filesAndFoldersFilter; 
+			set => SetProperty(ref _filesAndFoldersFilter, value); 
+		}
+
 
 		// Apply changes immediately after manipulating on filesAndFolders completed
 		public async Task ApplyFilesAndFoldersChangesAsync()
@@ -1339,7 +1369,7 @@ public Task UpdateItemsTags(Dictionary<string, string[]> newTags)
 			return dispatcherQueue.EnqueueOrInvokeAsync(() =>
 			{
 				int count = newTags.Count;
-				foreach(var item in FilesAndFolders)
+				foreach (var item in FilesAndFolders)
 				{
 					if (newTags.TryGetValue(item.ItemPath, out var tags))
 					{
@@ -1635,15 +1665,15 @@ private async Task<int> EnumerateItemsFromStandardFolderAsync(string path, Cance
 				!isShellFolder &&
 				!isWslDistro;
 			bool isNetdisk = false;
-	
+
 			try
 			{
 				// Special handling for network drives
 				if (!isNetwork)
 					isNetdisk = (new DriveInfo(path).DriveType == System.IO.DriveType.Network);
 			}
 			catch { }
- 			
+
 			bool isFtp = FtpHelpers.IsFtpPath(path);
 			bool enumFromStorageFolder = isBoxFolder || isFtp;
 

src/Files.App/Views/Shells/ModernShellPage.xaml

@@ -4,6 +4,7 @@
 	xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
 	xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
 	xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+	xmlns:helpers="using:Files.App.Helpers"
 	xmlns:local="using:Files.App.Views.Shells"
 	xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
 	xmlns:wct="using:CommunityToolkit.WinUI"
@@ -49,8 +50,13 @@
 		<Grid.Shadow>
 			<ThemeShadow x:Name="ShellContentThemeShadow" x:FieldModifier="public" />
 		</Grid.Shadow>
+		<Grid.RowDefinitions>
+			<RowDefinition Height="Auto" />
+			<RowDefinition Height="*" />
+		</Grid.RowDefinitions>
 
 		<Image
+			Grid.RowSpan="2"
 			HorizontalAlignment="{x:Bind ShellViewModel.FolderBackgroundImageHorizontalAlignment, Mode=OneWay}"
 			VerticalAlignment="{x:Bind ShellViewModel.FolderBackgroundImageVerticalAlignment, Mode=OneWay}"
 			Opacity="{x:Bind ShellViewModel.FolderBackgroundImageOpacity, Mode=OneWay}"
@@ -60,6 +66,7 @@
 		<!--  Swipe Backward Icon  -->
 		<Border
 			x:Name="BackIcon"
+			Grid.RowSpan="2"
 			Width="48"
 			Height="48"
 			Margin="-4,0,0,0"
@@ -81,6 +88,7 @@
 		<!--  Swipe Forward Icon  -->
 		<Border
 			x:Name="ForwardIcon"
+			Grid.RowSpan="2"
 			Width="48"
 			Height="48"
 			Margin="0,0,-4,0"
@@ -99,9 +107,40 @@
 				Symbol="Forward" />
 		</Border>
 
+		<!--  Filter header  -->
+		<Grid
+			x:Name="FilterHeader"
+			Grid.Row="0"
+			Padding="26,8,12,8"
+			BorderBrush="{ThemeResource DividerStrokeColorDefaultBrush}"
+			BorderThickness="0,0,0,1"
+			Visibility="{x:Bind ShellViewModel.ShowFilterHeader, Mode=OneWay}">
+			<StackPanel
+				VerticalAlignment="Center"
+				Orientation="Horizontal"
+				Spacing="12">
+				<Image
+					Height="16"
+					VerticalAlignment="Center"
+					Source="{x:Bind ShellViewModel.FolderThumbnailImageSource, Mode=OneWay}" />
+				<TextBlock
+					VerticalAlignment="Center"
+					Style="{StaticResource BodyStrongTextBlockStyle}"
+					Text="{helpers:ResourceString Name=FilteringFor}" />
+				<AutoSuggestBox
+					x:Name="FilterTextBox"
+					Width="180"
+					VerticalAlignment="Center"
+					PlaceholderText="{helpers:ResourceString Name=Filename}"
+					PreviewKeyDown="FilterTextBox_PreviewKeyDown"
+					TextChanged="FilterTextBox_TextChanged" />
+			</StackPanel>
+		</Grid>
+
 		<!--  Shell Frame  -->
 		<Frame
 			x:Name="ItemDisplayFrame"
+			Grid.Row="1"
 			x:FieldModifier="public"
 			Navigated="ItemDisplayFrame_Navigated" />