Toolbelt.Blazor.HeadElement 0.0.1-preview1.0.1

Head element support (change the document title) for Blazor apps.

This is a prerelease version of Toolbelt.Blazor.HeadElement.

There is a newer version of this package available.
See the version list below for details.

Install-Package Toolbelt.Blazor.HeadElement -Version 0.0.1-preview1.0.1

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

<PackageReference Include="Toolbelt.Blazor.HeadElement" Version="0.0.1-preview1.0.1" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add Toolbelt.Blazor.HeadElement --version 0.0.1-preview1.0.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Documentation

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

Add package to your project like this.

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

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

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

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

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

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.

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

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