Rf

Rf is a static helper class made with optimized functions to help when developing in Blazor.

Below list out the functions of Rf.

Class

Use Rf.Class to generate a quickly concatenate classes together by string.

// Concatenates a list of classes together.
public static string Class(params string[] classes)

Example

... CssClass=@Rf.Class("class-a", "class-b") ...

ClassWhen

Use Rf.ClassWhen to generate a dynamic class list in line or from the code behind.

// Concatenates classes together based on when show is true. 
public static string ClassWhen(params (string cssClass, bool show)[] classes)

Example

... CssClass=@Rf.ClassWhen(("has-text-grey", IsDeleted)) ...

StyleWhen

Use Rf.StyleWhen to generate a dynamic style attribute in line or from the code behind.

// Concatenates styles together based on when show is true. Only returns styles that are not null or whitespace in either style name or value. 
public static string StyleWhen(params (string styleName, string value, bool show)[] styles)

Examples

string value = Rf.StyleWhen(("color", "green", true));
//value -> color:green;

bool IsDeleted = true;
bool IsSpecial = false;
value = Rf.StyleWhen(("color", "#333", IsDeleted)
    , ("background-color", "yellow", IsSpecial));
//value -> color:#333;

Setting up RForge is simple. Follow the below steps to add RForge Blazor components to your project.

1. Install the Nuget package
2. Import the namespaces (optional)
3. Register RForge services
4. Include Bulma CSS

Install the Nuget Package

RForge Blazor components are installed via Nuget. There are two packages. One for the blazor app and one for the library if any.

Blazor Project Installation

Command Line

dotnet add package RForge.Blazor

Package Manager Console

Install-Package RForge.Blazor

Library Project Installation

This is optional but may be useful if you want to use common enums across the backend and frontend.

Command Line

dotnet add package RForge.Abstractions

Package Manager Console

Install-Package RForge.Abstractions

Import the namespaces

To simplify namespacing while using RForge, the package is designed with most all components sitting within the root RForge namespace.

You may want to include the following namespaces in your _import.razor for ease of use.

@using RForgeBlazor
@using RForgeBlazor.Services
@using RForge.Abstractions

Register RForge Services

In order for some components to work they must first have their services registered.

Open up Program.cs and add the following line before the var app = builder.Build();.

using RForgeBlazor;
//...
builder.Services.AddRfForgeBlazorServices();
//...
var app = builder.Build();
    

Include Bulma CSS

RForge makes use of Bulma CSS to stylize the components. Add / install Bulma and add the CSS file to the head. Link to download: Bulma releases.