AngryMonkey.CloudBlazor.App 1.0.1

CloudBlazor.App

Application framework for Blazor WebAssembly and Blazor Hybrid clients: one navigation contract, page hierarchy tracking, and popup-aware back navigation.

Formerly published as AngryMonkey.CloudApp. See Migrating.

Installation

dotnet add package AngryMonkey.CloudBlazor.App

For .NET MAUI Blazor Hybrid hosts, install AngryMonkey.CloudBlazor.App.Maui instead — it references this package and supplies the native navigation service.

Quick start

Register the implementation that matches the host. Application code depends only on INavigationService, so it is identical either way.

// Browser: WebAssembly, Server, Blazor Web Apps
builder.Services.AddCloudApp();

// .NET MAUI Blazor Hybrid (from AngryMonkey.CloudBlazor.App.Maui)
builder.Services.AddCloudAppMaui();

@inject INavigationService Navigation

<button @onclick="() => Navigation.NavigateToAsync(&quot;/details/1&quot;)">Open details</button>

@if (Navigation.ShouldShowBackButton)
{
    <button @onclick="Navigation.NavigateBackAsync">Back</button>
}

Page hierarchy

Back-button visibility is driven by a named page hierarchy rather than browser history, so the UI can decide what "back" means before touching history.

Navigation.SetCurrentPage("Details");

bool showBack = Navigation.ShouldShowBackButton;   // true — Home is the root

Navigation

Popups

With IsPopupOpen set, NavigateToAsync replaces the current history entry instead of pushing a new one, so dismissing the popup does not leave a dead entry behind.

TryNavigateBack returns false on the root page with no popup open — the signal a MAUI host uses to let the hardware back button exit the application:

protected override bool OnBackButtonPressed() => Navigation.TryNavigateBack();

External links

await Navigation.NavigateToExternalAsync("https://angrymonkeycloud.com", newTab: true);

WebNavigationService calls window.open or window.location.assign, passing the URL as an interop argument rather than concatenating it into a script string, so a URL containing quotes cannot break out and execute. MauiNavigationService hands it to the platform launcher, so tel:, mailto:, sms: and geo: open their native handler.

Both fall back to a routed navigation when the platform call fails.

Extending

NavigationServiceBase implements the shared behaviour — page hierarchy, popup state and URI helpers — leaving the platform-specific members abstract:

public class CustomNavigationService(IJSRuntime js, NavigationManager navigation)
    : NavigationServiceBase(navigation)
{
    public override bool IsWebPlatform => true;
    public override event EventHandler<string>? NavigateRequest;

    public override Task NavigateToAsync(string route, bool forceReload = false) { ... }
    public override Task NavigateBackAsync() { ... }
    public override Task NavigateToExternalAsync(string url, bool newTab = false) { ... }
    public override bool TryNavigateBack() { ... }
    public override void SoftNavigate(string url) { ... }
}

PushCurrentHistoryState(IJSRuntime) is available to derived types. It uses synchronous interop where the host provides it (WebAssembly, Blazor Hybrid) and queues the call on Interactive Server, which has none.

Migrating from AngryMonkey.CloudApp

The previous packages are no longer updated. The repositories were merged into CloudBlazor, where all four packages ship as a matched set.

Required changes

Type names are unchanged: INavigationService, NavigationServiceBase, WebNavigationService and MauiNavigationService keep their names and members.

Behaviour changed in three places, all bug fixes:

• SoftNavigate no longer throws on Interactive Server. It used to cast unconditionally to IJSInProcessRuntime, which only exists in WebAssembly and Hybrid hosts.
• SoftNavigate no longer leaks an event listener. Each call registered a popstate listener bound to a HandlePopState method that did not exist. The dead registration is gone.
• External navigation no longer uses eval. The URL is passed as an interop argument.

Related packages

License

MIT © Angry Monkey Cloud