BlazorPro.BlazorSize 5.0.0

There is a newer prerelease version of this package available.
See the version list below for details.
Install-Package BlazorPro.BlazorSize -Version 5.0.0
dotnet add package BlazorPro.BlazorSize --version 5.0.0
<PackageReference Include="BlazorPro.BlazorSize" Version="5.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add BlazorPro.BlazorSize --version 5.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: BlazorPro.BlazorSize, 5.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install BlazorPro.BlazorSize as a Cake Addin
#addin nuget:?package=BlazorPro.BlazorSize&version=5.0.0

// Install BlazorPro.BlazorSize as a Cake Tool
#tool nuget:?package=BlazorPro.BlazorSize&version=5.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

BlazorSize is a JavaScript interop library for Blazor that is used to detect the Browser's current size, change in size, and test media queries.

BlazorSize was designed to allow Razor Components to implement adaptive rendering. Handle mobile/desktop rendering changes at runtime with ease and complement your apps CSS media queries with programmatic work flows.

Add the NuGet package

Package Manager

Install-Package BlazorPro.BlazorSize 

CLI

dotnet add package BlazorPro.BlazorSize 

.csproj

<PackageReference Include="BlazorPro.BlazorSize" Version="3.*" />

Import the namespace

Add a reference to the namespace in your _Imports.razor or at the top of a page.

@using BlazorPro.BlazorSize

Configure DI

In startup.cs register ResizeListener with the applications service collection.

services.AddMediaQueryService();

Add the MediaQueryList

Add a MediaQueryList to your application's main layout or root. The MediaQueryList is responsible for communicating with all MediaQuery components in your app. The MediaQueryList component will consolidate redundant media queries and manage resources so that unused event listeners are disposed of properly.

<MediaQueryList>
    <div class="sidebar">
        <NavMenu />
    </div>

    <div class="main">
        <div class="top-row px-4">
            <a href="http://blazor.net" target="_blank" class="ml-md-auto">About</a>
        </div>

        <div class="content px-4">
            @Body
        </div>
    </div>
</MediaQueryList>

Add a MediaQuery and bind

Using the @bind-Matches directive we can easily bind to a browser's media query and respond to it.

<details> <summary >See Example</summary>

@if (IsSmall)
{
    <WeatherCards Data="forecasts"></WeatherCards>
}
else
{
    <WeatherGrid Data="forecasts"></WeatherGrid>
}

@if (IsMedium)
{
    <span>Medium</span>
}

<MediaQuery Media="@Breakpoints.OnlyMedium" @bind-Matches="IsMedium" />
<MediaQuery Media="@Breakpoints.SmallDown" @bind-Matches="IsSmall" />

@code {
    WeatherForecast[] forecasts;

    bool IsMedium = false;
    bool IsSmall = false;

    protected override async Task OnInitializedAsync()
    {
        forecasts = await Http.GetFromJsonAsync<WeatherForecast[]>("sample-data/weather.json");
    }
}

</details>

No-Code Templates

The MediaQuery component can also use templates instead of the @bind directive. Templates are useful for swapping out UI bits when the screen size changes.

<details> <summary >See Example</summary>


<MediaQuery Media="@Breakpoints.SmallDown">
    <Matched>
        <WeatherCards Data="forecasts"></WeatherCards>
    </Matched>
    <Unmatched>
        <WeatherGrid Data="forecasts"></WeatherGrid>
    </Unmatched>
</MediaQuery>

</details>

Helpers

Common media queries are already included as helpers to keep you out of the Bootstrap docs. Stay in your code longer and write cleaner statements too!

Listening for the Resize event

The ResizeListener is a service that allows your application to listen for the browser's resize event. The ResizeListener is a throttled to improve performance and can be adjusted thru configuration. If you only need to respond the user's device or screen size the MediaQueryList & MediaQuery components provide a more performant experience.

Configure DI

In startup.cs register ResizeListener with the applications service collection.

services.AddScoped<ResizeListener>();
//services.AddResizeListener(options =>
//                            {
//                                options.ReportRate = 300;
//                                options.EnableLogging = true;
//                                options.SuppressInitEvent = true;
//                            });

Usage

This example shows how to get the browsers width/height and check for media query matches. Depending on the matched media query the view can toggle between two components WeatherGrid or WeatherCards.

<details> <summary >See Example</summary>

@inject IResizeListener listener
@implements IDisposable
@page "/fetchdata"

@using BlazorSize.Example.Data
@inject WeatherForecastService ForecastService

<h1>Weather forecast</h1>

<p>This component demonstrates adaptive rendering of a Blazor UI.</p>

<h3>Height: @browser.Height</h3>
<h3>Width: @browser.Width</h3>
<h3>MQ: @IsSmallMedia</h3>

@if (IsSmallMedia)
{
	
    <WeatherCards Data="forecasts"></WeatherCards>
}
else
{
	
    <WeatherGrid Data="forecasts"></WeatherGrid>
}

@code {
    WeatherForecast[] forecasts;

	// We can also capture the browser's width / height if needed. We hold the value here.
    BrowserWindowSize browser = new BrowserWindowSize();

    bool IsSmallMedia = false;

    protected override async Task OnInitializedAsync()
    {
        forecasts = await ForecastService.GetForecastAsync(DateTime.Now);
    }

    protected override void OnAfterRender(bool firstRender)
    {

        if (firstRender)
        {
			// Subscribe to the OnResized event. This will do work when the browser is resized.
            listener.OnResized += WindowResized;
        }
    }

    void IDisposable.Dispose()
    {
		// Always use IDisposable in your component to unsubscribe from the event.
		// Be a good citizen and leave things how you found them. 
		// This way event handlers aren't called when nobody is listening.
        listener.OnResized -= WindowResized;
    }

	// This method will be called when the window resizes.
	// It is ONLY called when the user stops dragging the window's edge. (It is already throttled to protect your app from perf. nightmares)
    async void WindowResized(object _, BrowserWindowSize window)
    {
		// Get the browsers's width / height
        browser = window;

		// Check a media query to see if it was matched. We can do this at any time, but it's best to check on each resize
        IsSmallMedia = await listener.MatchMedia(Breakpoints.SmallDown);

		// We're outside of the component's lifecycle, be sure to let it know it has to re-render.
        StateHasChanged();
    }

}

</details>

NuGet packages (3)

Showing the top 3 NuGet packages that depend on BlazorPro.BlazorSize:

Package Downloads
Blazm.Components

A collection of Blazor components

TailBlazor.NavBar

A Blazor navbar component based off TailWindCss. It has the bare minimum styles to function with the option to add your own classes. It's built so it can be fully customizable and reusable.

BlazorPro.BlazorSize.UnitTesting

A testing library to provide helper extensions for BlazorSize.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on BlazorPro.BlazorSize:

Repository Stars
telerik/blazor-ui
A collection of examples related to Telerik UI for Blazor Components: https://www.telerik.com/blazor-ui
Version Downloads Last updated
6.0.0-pre2 139 10/5/2021
6.0.0-pre 131 8/23/2021
5.0.0 8,318 5/27/2021
5.0.0-pre 143 5/25/2021
3.2.1 11,028 3/9/2021
3.2.0 794 3/5/2021
3.1.0 38,478 11/30/2020
3.0.0 922 11/23/2020
2.3.0 25,554 8/11/2020
2.0.2 10,750 4/21/2020
1.2.2 7,100 1/26/2020
1.2.1 266 1/23/2020
1.2.0 340 1/22/2020

5.0.0 Added support for bUnit. Removed support for .NET 3.x
     4.0.0 no release, aligning with .NET 5.0. Next version will no longer support .NET 3.x
     3.2.0
     Added service interfaces, IMediaQueryService, IResizeListener to support unit testing scenarios
     Added end-to-end testing on source for QA
     3.1.0
     Added .NET 5 module loading for BlazorSize Resize Listener.
     Fixed casing on JS modules, fixes deployment issues on Linux.
     3.0.0
     Added .NET 5 module loading for BlazorSize Media Queries.
     2.3.0
     Fixed additional regressions from 2.2.0, update recommended.
     2.2.0
     Fixed possible regressions, update recommended.
     Updated Blazor dependencies.
     2.1.1
     Fixed MSBuild including *.json files breaking NuGet pkg.
     2.0.0
     Added MediaQueryList & MediaQuery components.
     1.2.2
     Fixes initalization issues with Client-Side Blazor
     1.2.0
     Full-release