HackerOs.Taskbar.Blazor 2.1.0

HackerOs.Taskbar.Blazor

A taskbar Razor component (Taskbar) driven entirely by host-supplied contracts instead of a fixed set of injected services: ITaskbarWindowSource, ITaskbarCommandDispatcher, ITaskbarLauncher, ITaskbarStatusSource, ITaskbarClockPanelSource, ITaskbarSessionCommands. Every contract parameter is optional — the corresponding taskbar region (launcher trigger, clock, session control) simply does not render when its contract isn't supplied.

The clock is the taskbar's one extensible surface: ITaskbarClockPanelSource controls whether its panel is open, and the ClockPanelContent RenderFragment parameter supplies what's inside it. This package owns only the trigger button and the panel's anchoring/positioning — it never inspects ClockPanelContent, so the panel's actual design (notifications, calendar, a platform-mode toggle, anything else) lives entirely in the host application, outside this package.

Usage

<Taskbar WindowSource="_windowSource"
         Commands="_commands"
         Launcher="_launcher"
         StatusSource="_status"
         ClockPanelSource="_clockPanel"
         ClockPanelContent="@ClockPanelFragment"
         Options="_options" />

This example omits SessionCommands — a host with no session concept just doesn't provide it, and the taskbar renders without that region. TaskbarOptions carries only the labels a host would otherwise be forced to see hardcoded (the launcher trigger's mark and text); which taskbar zones appear is controlled entirely by which contracts you supply.

Pair this package with HackerOs.Windowing.Blazor for the window chrome that these contracts typically sit alongside. See HackerOs.Windowing.SampleHost in the source repository for a complete, minimal host that uses only these packages, including sample ITaskbarWindowSource/ITaskbarCommandDispatcher/ ITaskbarLauncher/ITaskbarStatusSource implementations.

Localization

The package's texts (accessible labels, the launcher label and the window states) live in Resources/Strings.resx (English) and Resources/Strings.fr.resx (French), read through HackerOs.Theming.Blazor.Localization.PackageStringLocalizer (ADR 0104): a host that registers an IStringLocalizer<T> (HackerOS registers its session-language SessionStringLocalizer<T>) gets its language; a host without localization gets English.

TaskbarOptions.LauncherLabel overrides the package's "Applications" when set; left null it is localized. The clock is formatted with the long time pattern ("T") of ITaskbarStatusSource.FormatCulture: a default interface member returning the invariant culture (HH:mm:ss), which HackerOS implements with the session's LC_TIME culture (9:00:00 AM in en-US, 09:00:00 in fr-FR).