feat: improve screen reader support

Screenbox.Core/Models/LivelyWallpaperModel.cs

@@ -16,4 +16,9 @@ public record LivelyWallpaperModel
     public bool IsAudio { get; set; }
     public bool IsPauseNotify { get; set; }
     public Uri AuthorUrl { get; set; }
+
+    public override string ToString()
+    {
+        return Model.Author != null ? $"{Model.Title}; {Model.Author}" : $"{Model.Title}";
+    }
 }

Screenbox/Controls/MediaListViewItem.xaml

@@ -102,6 +102,7 @@
             Grid.Column="3"
             Margin="2,0"
             Padding="{StaticResource HyperlinkButtonUniformPadding}"
+            contract14Present:AutomationProperties.AutomationControlType="Button"
             Command="{x:Bind Common.OpenArtistCommand}"
             CommandParameter="{Binding MainArtist, FallbackValue={x:Null}}"
             Foreground="{ThemeResource TextFillColorPrimaryBrush}"
@@ -122,6 +123,7 @@
             Grid.Column="4"
             Margin="2,0"
             Padding="{StaticResource HyperlinkButtonUniformPadding}"
+            contract14Present:AutomationProperties.AutomationControlType="Button"
             Command="{x:Bind Common.OpenAlbumCommand}"
             CommandParameter="{Binding Album}"
             Foreground="{ThemeResource TextFillColorPrimaryBrush}"

Screenbox/Controls/MediaListViewItem.xaml.cs

@@ -1,16 +1,18 @@
 #nullable enable
 
+using System;
+using System.Windows.Input;
 using CommunityToolkit.Mvvm.DependencyInjection;
 using Screenbox.Core.Enums;
 using Screenbox.Core.ViewModels;
-using System;
-using System.Windows.Input;
 using Windows.UI.Xaml;
+using Windows.UI.Xaml.Automation;
 using Windows.UI.Xaml.Controls;
 
 // The User Control item template is documented at https://go.microsoft.com/fwlink/?LinkId=234236
 
 namespace Screenbox.Controls;
+
 public sealed partial class MediaListViewItem : UserControl
 {
     public static readonly DependencyProperty PlayCommandProperty = DependencyProperty.Register(
@@ -42,16 +44,30 @@ public MediaListViewItem()
     private GridLength BoolToGridLength(bool visibility) =>
         visibility ? new GridLength(1, GridUnitType.Star) : new GridLength(0);
 
+    private void UpdatePlayButtonsAutomationName(bool isPlaying)
+    {
+        var media = DataContext as MediaViewModel;
+        string playPauseText = isPlaying ? Strings.Resources.Pause : Strings.Resources.Play;
+
+        AutomationProperties.SetName(PlayButton, $"{playPauseText} {media?.Name}");
+    }
+
     private void OnDataContextChanged(FrameworkElement sender, DataContextChangedEventArgs args)
     {
         _firstPlay = true;
-        AdaptiveLayoutBehavior.Override =
-            (DataContext as MediaViewModel)?.MediaType != MediaPlaybackType.Music ? 0 : -1;
+        var media = DataContext as MediaViewModel;
+        AdaptiveLayoutBehavior.Override = media?.MediaType != MediaPlaybackType.Music ? 0 : -1;
+
+        UpdatePlayButtonsAutomationName(media?.IsPlaying ?? false);
+        AutomationProperties.SetName(ArtistButton, $"{Strings.Resources.Artist}: {media?.MainArtist?.Name}");
+        AutomationProperties.SetName(AlbumButton, $"{Strings.Resources.Albums}: {media?.Album?.Name}");
     }
 
     private async void PlayingStatesOnCurrentStateChanged(object sender, VisualStateChangedEventArgs e)
     {
-        if (_firstPlay && e.NewState?.Name == nameof(Playing))
+        bool isPlaying = e.NewState?.Name == nameof(Playing);
+        UpdatePlayButtonsAutomationName(isPlaying); // TODO: Use MediaViewModel PropertyChanged (IsPlaying) event.
+        if (_firstPlay && isPlaying)
         {
             _firstPlay = false;
             await PlayingIndicator.PlayAsync(0, 1, true);

Screenbox/Pages/AlbumsPage.xaml

@@ -82,7 +82,7 @@
             Margin="{StaticResource ContentPagePadding}"
             HorizontalAlignment="Right"
             AccessKey="{strings:KeyboardResources Key=CommandSortByKey}"
-            AutomationProperties.Name="{x:Bind SortByText.Text}"
+            AutomationProperties.Name="{x:Bind GetSortByButtonAutomationName(ViewModel.SortBy), Mode=OneWay}"
             Background="Transparent"
             BorderBrush="Transparent">
             <muxc:DropDownButton.Flyout>

Screenbox/Pages/AlbumsPage.xaml.cs

@@ -102,6 +102,12 @@ private string GetSortByText(string tag)
             return (item as MenuFlyoutItem)?.Text ?? string.Empty;
         }
 
+        private string GetSortByButtonAutomationName(string value)
+        {
+            var optionText = GetSortByText(value);
+            return Strings.Resources.SortByAutomationName(optionText);
+        }
+
         private void UpdateSortByFlyout()
         {
             if ((SortByFlyout.Items?.FirstOrDefault(x => x.Tag as string == ViewModel.SortBy) ??

Screenbox/Pages/SongsPage.xaml

@@ -107,7 +107,7 @@
             Margin="{StaticResource ContentPagePadding}"
             HorizontalAlignment="Right"
             AccessKey="{strings:KeyboardResources Key=CommandSortByKey}"
-            AutomationProperties.Name="{x:Bind SortByText.Text}"
+            AutomationProperties.Name="{x:Bind GetSortByButtonAutomationName(ViewModel.SortBy), Mode=OneWay}"
             Background="Transparent"
             BorderBrush="Transparent">
             <muxc:DropDownButton.Flyout>

Screenbox/Pages/SongsPage.xaml.cs

@@ -103,6 +103,12 @@ private string GetSortByText(string tag)
             return (item as MenuFlyoutItem)?.Text ?? string.Empty;
         }
 
+        private string GetSortByButtonAutomationName(string value)
+        {
+            var optionText = GetSortByText(value);
+            return Strings.Resources.SortByAutomationName(optionText);
+        }
+
         private void UpdateSortByFlyout()
         {
             if ((SortByFlyout.Items?.FirstOrDefault(x => x.Tag as string == ViewModel.SortBy) ??

Screenbox/Strings/en-US/Resources.resw

@@ -824,6 +824,10 @@
   <data name="SortBy" xml:space="preserve">
     <value>Sort by</value>
   </data>
+  <data name="SortByAutomationName" xml:space="preserve">
+    <value>Sort by {0} option selected</value>
+    <comment>#Format[String sortBy]</comment>
+  </data>
   <data name="Artist" xml:space="preserve">
     <value>Artist</value>
   </data>