Zonit.Extensions.Website.Abstractions 0.2.7

Zonit.Extensions

Useful tools for Blazor

Abstractions Package

Zonit.Extensions.Abstractions - Interfaces and base abstractions

dotnet add package Zonit.Extensions.Abstractions

Zonit.Extensions - Core utilities and extensions

dotnet add package Zonit.Extensions

What's included:

• Exceptions - Structured exception handling with i18n support, error codes, and strongly-typed error parameters
• Reflection - Utility class for discovering assemblies and types that implement or inherit from a specified base type
• Xml - Utility class for serializing objects to XML and deserializing XML back to objects
• ValueObjects - Immutable value objects for common domain concepts (Price, Title, Description, UrlSlug, Culture)

Blazor Website Extensions

Zonit.Extensions.Website.Abstractions - Interfaces and abstractions for Blazor

dotnet add package Zonit.Extensions.Website.Abstractions 

Zonit.Extensions.Website - Blazor-specific components and utilities

dotnet add package Zonit.Extensions.Website

What's included:

• Components - Reusable Blazor components
• Cookie handling with Blazor support (see below)

MudBlazor Integration

Zonit.Extensions.Website.MudBlazor - MudBlazor converters for Value Objects

dotnet add package Zonit.Extensions.Website.MudBlazor

What's included:

• ZonitTextField<T> - MudTextField with automatic Value Object converter
• ZonitTextArea<T> - Multiline version for longer content
• Built-in exception handling with automatic error messages
• AOT and Trimming compatible (type inference at compile time)

Supported Value Objects: Title, Description, UrlSlug, Content, Url, Culture

Usage (type is inferred from @bind-Value):

@using Zonit.Extensions.MudBlazor

<ZonitTextField @bind-Value="Model.Title" Label="Title" />
<ZonitTextField @bind-Value="Model.Description" Label="Description" />
<ZonitTextField @bind-Value="Model.Slug" Label="URL Slug" />

@* For multiline content *@
<ZonitTextArea @bind-Value="Model.Content" Label="Content" />

No need to specify T="Title" - the compiler infers the type automatically!

Cookie handling with support for Blazor

Installation:

Add this in Routes.razor

@using Zonit.Extensions

<ZonitCookiesExtension />

Services in Program.cs

builder.Services.AddCookiesExtension();

App in Program.cs

app.UseCookiesExtension();

Example:

@page "/"
@rendermode InteractiveServer
@using Zonit.Extensions.Website
@inject ICookieProvider Cookie

@foreach (var cookie in Cookie.GetCookies())
{
    <p>@cookie.Name @cookie.Value</p>
}

API

    public CookieModel? Get(string key);
    public CookieModel Set(string key, string value, int days = 12 * 30);
    public CookieModel Set(CookieModel model);
    public Task<CookieModel> SetAsync(string key, string value, int days = 12 * 30);
    public Task<CookieModel> SetAsync(CookieModel model);
    public List<CookieModel> GetCookies();

We use SetAsync only in the Blazor circuit. It executes the JS code with the Cookies record.