mirror of
https://github.com/MaSzyna-EU07/StarterNG.git
synced 2026-11-19 06:55:59 +01:00
A review against WCAG 2.2 AA left places a screen reader user could not work: - Key bindings: a key's button says the command and the key, the clear button which command it clears; a new key is said aloud and focus comes back to its row. The on-screen keyboard is reached with Tab and walked with the arrows. - Number fields read their label; the spin buttons are named and left out of Tab. - Dialogs: Enter presses the main button, Esc closes, focus starts on the first button and the message is read with it. - Consist: every change is said - added, removed, turned, moved, replaced, undone - and the strip is a named list; a turned card says so. - Searches say how many entries are left once typing pauses. - Hasler tapes, the black box timeline, timetable and cab panel take focus, work from the keyboard, read their value as it changes and draw a focus frame. - Section reset and level controls, the crew button and the tabs carry names; English names from Avalonia's templates are read in the starter's language; sort and crew menus are radio items. - Input borders reach 3:1 against the panels; Tab starts at the top bar; the splash screen has a title and its progress reads the loading step.
44 lines
1.3 KiB
C#
44 lines
1.3 KiB
C#
using System;
|
|
using Avalonia.Controls;
|
|
using Avalonia.Threading;
|
|
|
|
namespace StarterNG.Controls;
|
|
|
|
/// <summary>
|
|
/// Says how many entries a search box left once typing pauses: the list filled itself
|
|
/// out of sight, and a screen reader heard only the letters typed. Nothing is said
|
|
/// while focus is elsewhere or the box is empty.
|
|
/// </summary>
|
|
public sealed class SearchResultsTeller
|
|
{
|
|
/// <summary>The pause after the last key that counts as done typing.</summary>
|
|
public static readonly TimeSpan Pause = TimeSpan.FromMilliseconds(900);
|
|
|
|
private readonly TextBox _box;
|
|
private readonly Func<int> _count;
|
|
private readonly DispatcherTimer _timer = new() { Interval = Pause };
|
|
|
|
public SearchResultsTeller(TextBox box, Func<int> count)
|
|
{
|
|
_box = box;
|
|
_count = count;
|
|
_timer.Tick += (_, _) => Tell();
|
|
}
|
|
|
|
/// <summary>The text changed: the count is said after the pause, once.</summary>
|
|
public void Changed()
|
|
{
|
|
_timer.Stop();
|
|
_timer.Start();
|
|
}
|
|
|
|
private void Tell()
|
|
{
|
|
_timer.Stop();
|
|
if (!_box.IsKeyboardFocusWithin || string.IsNullOrWhiteSpace(_box.Text))
|
|
return;
|
|
|
|
Announcer.Say(_box, string.Format(AppLanguage.Text("SearchFound"), _count()));
|
|
}
|
|
}
|