bit Blazor Utilities for JavaScript
To start using Butil you first need to install the NuGet package:
dotnet add package Bit.Butil
then add its script tag to your app:
<script src="_content/Bit.Butil/bit-butil.js"></script>you also need to add its services like this:
using Bit.Butil;
...
builder.Services.AddBitButilServices();
...Now you can inject its classes to use the utilities.
To use a representation of the DOM's window object in C# you can inject the Bit.Butil.Window class:
@inject Bit.Butil.Window window
...
@code {
...
await window.AddEventListener(ButilEvents.KeyDown, args => { ... });
...
}To use a representation of the DOM's document object in C# you can inject the Bit.Butil.Document class:
@inject Bit.Butil.Document document
...
@code {
...
await document.AddEventListener(ButilEvents.Click, args => { ... });
...
}In Butil there is a special class to work with keyboard and short keys. you can use this class by inejcting the Bit.Butil.Keyboard class:
@inject Bit.Butil.Keyboard keyboard
...
@code {
...
await keyboard.Add("F10", args => { ... }, , ButilModifiers.Alt | ButilModifiers.Ctrl);
...
}To use the browser console features you can try injecting the Bit.Butil.Console class like this:
@inject Bit.Butil.Console console
...
@code {
...
console.Log("This is a test log:", someValue);
console.Assert(condition, "The condition failed!", testedValue);
console.Error("This is a test error:", value);
...
}