Toolbelt.Blazor.HeadElement 0.0.1-preview1.0.1

Blazor Head Element Helper

Summary

This component and services allows you to change the title of document on your Blazor app.

This package supports both of seiver-side Blazor and client-side Blazor WebAssembly app.

And also supports server-side pre-rendering on your server-side Blazor app.

NOTICE! - This is "Preview" Release

This package is "preview" release at this time.

Some implementations of this packages depends on internals of ASP.NET Core Components.

Especially, server-side pre-rendering is very slow and stressfull, because it captures all requests and buffering all responses on memory.

How to use

1. Add package to your project like this.

dotnet add package Toolbelt.Blazor.HeadElement --version 0.0.1-preview1.0.1

2. Register "Head Element Helper" service at your Blazor app's Startup.

using Toolbelt.Blazor.Extensions.DependencyInjection; // <- Add this, and...

public class Startup
{
  public void ConfigureServices(IServiceCollection services)
  {
    services.AddHeadElementHelper(); // <- Add this.
    ...

3. Open Toolbelt.Blazor.HeadElement namespace in _Imports.razor file.

@* This is "_Imports.razor" *@
...
@using Toolbelt.Blazor.HeadElement

3. Markup <Title> component in your .razor file.

@* This is "Pages/Counter.razor" *@
@page "/counter"

<Title>Counter(@currentCount) - Server Side App</Title>

The title of document will be changed.

Server-side pre-rendering support

If you want to get srever-side pre-rendering support, do this.

1. Add Toolbelt.Blazor.HeadElement.ServerPrerendering package to your project like this.

dotnet add package Toolbelt.Blazor.HeadElement.ServerPrerendering --version 0.0.1-preview1.0.2

2. Register "Head Element Server Prerendering" middleware at your server-side Blazor app's Startup, before appUseStaticFiles().

using Toolbelt.Blazor.Extensions.DependencyInjection; // <- Add this, and...

public class Startup
{
  public void Configure(IApplicationBuilder app)
  {
    app.UseHeadElementServerPrerendering(); // <- Add this.
    ...
    app.UseStaticFiles()
    ...

License

Mozilla Public License Version 2.0