Applies safe AppSurface theme identity and color-scheme metadata to an opted-in HTML root.
Use <html appsurface-theme-root>
after explicitly registering AppSurfaceWebThemingServiceCollectionExtensions.AddAppSurfaceWebTheming(Microsoft.Extensions.DependencyInjection.IServiceCollection)
or AppSurfaceWebThemingServiceCollectionExtensions.AddAppSurfaceWebThemeSelection(Microsoft.Extensions.DependencyInjection.IServiceCollection)
. Existing attributes are preserved. An existing style
attribute retains its declarations and receives the generated color-scheme declaration only when it does not already name color-scheme
. Set appsurface-theme-root="false"
when the embedding layout owns a fixed color-scheme and must not emit host theme metadata.
bool IsEnabled { get; set; }
Source
Gets or sets whether the opt-in root marker should apply the registered theme document. Defaults to true
.
Set this to false
when an embedding layout owns a complete fixed color-scheme contract and must not emit potentially conflicting host-theme metadata. The marker attribute is removed without changing any other existing root attributes.
Emits AppSurface-managed PWA head metadata for MVC and Razor layouts.
Render <appsurface:pwa-head />
inside the document <head>
after enabling PwaOptions
. The helper emits install metadata only when PwaOptions.Enabled
is enabled, emits inert worker path/scope metadata for active worker capabilities, loads the inert registration helper only when push is enabled, and loads the independent badging helper only when PwaBadgingOptions.Enabled
is enabled. It never registers a worker, displays an install prompt, requests notification permission, creates a push subscription, owns an attention count, or claims that an operating system displayed a badge.
ViewContext ViewContext { get; set; }
Source
Gets or sets the view context supplied by MVC.
Emits AppSurface color-scheme metadata and critical CSS inside a document head.
Render <appsurface-theme-head nonce="..." />
after explicitly registering the Web theme integration. The optional nonce is HTML-encoded and applied to the live inline critical style
. When the host explicitly registers browser preferences through AppSurfaceWebThemingServiceCollectionExtensions.AddAppSurfaceWebThemePreferences(Microsoft.Extensions.DependencyInjection.IServiceCollection, System.Action{Theming.AppSurfaceThemePreferenceOptions}?)
, the same nonce is also applied to the deterministic preference bootstrap emitted before that stylesheet. The meta element never receives a nonce. The bootstrap never hides page content and binds only consumer-owned controls marked with data-as-theme-preference-control
after the document is ready.
string? Nonce { get; set; }
Source
Gets or sets the optional CSP nonce for live inline preference and critical-style payloads.
ViewContext ViewContext { get; set; }
Source
Gets or sets the MVC view context for request-scoped duplicate suppression.