Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hassanhabib/prettyblazor
PrettyBlazor is a Blazor .NET library that enables Blazor developers to use control structures in their Blazor applications through markup without having to use obtrusive C# code to iterate or select particular fragments.
https://github.com/hassanhabib/prettyblazor
blazor blazor-client blazor-component blazor-server blazor-webassembly
Last synced: about 7 hours ago
JSON representation
PrettyBlazor is a Blazor .NET library that enables Blazor developers to use control structures in their Blazor applications through markup without having to use obtrusive C# code to iterate or select particular fragments.
- Host: GitHub
- URL: https://github.com/hassanhabib/prettyblazor
- Owner: hassanhabib
- Created: 2021-04-02T08:49:28.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-01-20T19:58:28.000Z (almost 2 years ago)
- Last Synced: 2023-02-27T18:06:53.932Z (over 1 year ago)
- Topics: blazor, blazor-client, blazor-component, blazor-server, blazor-webassembly
- Language: C#
- Homepage:
- Size: 66.4 KB
- Stars: 86
- Watchers: 12
- Forks: 16
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/hassanhabib/PrettyBlazor/actions/workflows/dotnet.yml)
[](https://www.nuget.org/packages/PrettyBlazor/)
[](https://github.com/hassanhabib/The-Standard)
# PrettyBlazor
PrettyBlazor is a Blazor .NET library that enables Blazor developers to use control structures in their Blazor applications through markup without having to use obtrusive C# code to iterate or select particular fragments.
## Introduction
There are two concepts here that makes PrettyBlazor important for writing clean, readable and unobtrusive Blazor applications.
### Control Structures
In computer sciences there are three types that makes the types of control for any given program. These types are sequence, selection and iteration.
#### Sequential Structures
Sequence already exists in any markup language, as it simply means you can sequentially build markup blocks one after another and they shall render accordingly as follows:
```html
```
#### Selection Structures
Selection structures are responsible for executing particular blocks of code only when a given evaluation or a condition is positive. the most common example for selection structures are the `if-else` statements, but it extends to other forms such as `switch case`.
Most of Blazor developers today will handle the selection flow by simply directly adding obstrusive C# code into their `.razor` files as follows:
```html
@if(condition)
{
}
else
{
}
```
The problem with the above code snippet is that it violates multiple principles. For instance, it's very cognitive-resources consuming to write a particular file of code with two different languages. You require the engineers reading the code to mentally switch back and forth between C# and Markup to understand what your code is actually trying to accomplish.
This might not be a big deal when writing a simple demo "Hello, World!" program. but for large scale enterprise applications this could become quite consuming and may cripple the ability for some engineers to easily detect any issues in your code.
The issue with obtrusiveness in C# code with Markup in Blazor is that the text editor and the parser are in continuous intrepretation of what your code is actually to accomplish, which can have some performance issues as well.
With Pretty Blazor, the equation becomes much simpler, because the entire file will be written simply by one and only one language which is markup as follows:
```html
```
In the code snippet above, you can see the selection structure completely implemented with just markup. the only C# code in this place is just the references to a boolean calculated value which belongs in the C# file for this application.
This approach of implementing selection control structure, is more befitting for the overall flow of a markup language in general, it expresses the structure much more fluently without any interruptions using a different language or a technology.
Every scripting, markup or programming language out there has the ability to express the type of control in their own way, for instance, CSS expresses selection control as follows:
```css
#button {
color: red;
}
```
This is basically CSS way of saying, if the element id is named `#button` then go a head and assign color red to it.
The same thing goes for all other scripting and programming languages, very few on the markup side, therefore PrettyBlazor brings this level of control to the markup world with Blazor components.
#### Iteration Structures
Iteration is one of the most powerful features in every scripting or programming language. Just like selection and sequence it is very heavily used almost in every single application on the planet. Iteration allows engineers to pass in a list of items and have some form or redundant routines to execute on each one of these items.
Today in Blazor, you'll see a lot of applications being written as follows:
```html
@foreach(Student student in students)
{
}
```
And again, the problem with this structure here is the obtrusive nature of the implementation, which requires multiple technologies and programming/markup language to collide to achieve a certain implementation.
Some folks decided to take the route of building the entire component in C# then just return a rendered component or a fragment on the markup, and that's one way and rather hard way to solve the problem. But an easier approach would be to implement the same concept with a fluent markup expression as follows:
```html
```
In the code snippet above, you can see how simpler, easier and prettier it can be to express an iteration in Blazor without having to write any specific C# code in your markup.
And just like we said in the selection section, the iteration control structure can be seen in every scripting, styling and programming language out there, for instance, in CSS iterations can be implemented as follows:
```css
button {
color: red;
}
```
In the example above, every single element of type button will have the color red. This is just another form of expressing iterations.
### Unobtrusive C#
Over a decade ago, web engineers introduced the concept of unobtrusive JavaScript. which was mainly around the idea that a web application should have it's CSS, HTML and JavaScript code all separated in their own files without one of them having to be using in the other's files.
This earlier concept has changed a lot since then, web applications have evolved dramatically and it seemed that this concept has become less of a priority in some populator frameworks.
PrettyBlazor attempts to bring this idea back, as it makes the code consumption of engineers' cognitive resources much lesser and more pleasant to read through and detect any issues in any if any.
The idea of Unobtrusive C# is to mainly ensure that C# code stays within `.cs` files and it shall be it's only responsiblity to describe the actions of UI components or the events that follow within.
And that's why PrettyBlazor was made, to litterally make developing Blazor applications prettier, easier to understand and faster to implement.
Here's a more combined example of PrettyBlazor:
```html
It's true!
It's false!
```
The equivelant of writing the same statement in Blazor today would be:
```html
@foreach (int number in Numbers)
{
if (number % 2 == 0)
{
It's true!
}
else
{
It's false!
}
}
```
C# mixed with html - which can become quite problematic from a readability, maintenance and performance perspectives when used in a large scale application - no matter how simpler you try to make the system components to be.
## Installation
Command Line (execeute this in the directory your project file is located)
```
dotnet add package PrettyBlazor
```
In your Component (or _Imports.cs)
```cshtml
@using PrettyBlazor
```
## Challenges and Dreams
PrettyBlazor is only a good start to a full unobtrusive C# routines in a Blazor application, the true issue here still stands with some of the C# code even if it's just a reference invading the space of the markup instead of gracefully handling the non-blazor or js availability with a graceful failure for the HTML body to load without having to add any additional logic.
The dream state is to allow C# to find and attach events or property values to Blazor components from the back-end without having to have any references whatsoever on the front-end.
here's a video introduction to this library:
[](https://www.youtube.com/watch?v=-NW2rp1J1ps)
If you have any suggestions, comments or questions, please feel free to contact me on:
Twitter: @hassanrezkhabib
LinkedIn: hassanrezkhabib
E-Mail: [email protected]