dotnet/blazorArchived
Blazor
Blazor is a .NET framework for building interactive web user interfaces using C# instead of JavaScript. It provides a component-based UI composition model where reusable, self-contained UI elements are built with C# logic and Razor markup, supporting nesting, parameters, and lifecycle events. The framework offers two primary rendering models: a client-side runtime that compiles C# to WebAssembly and executes directly in the browser, and a server-side model that renders UI on the server and sends incremental DOM updates over a persistent SignalR connection.
A central capability of Blazor is its JavaScript interop bridge, which enables bidirectional communication between .NET and JavaScript. This includes invoking JavaScript functions from .NET, calling .NET methods from JavaScript (including synchronous calls on WebAssembly), and managing object references, stream transfers, and byte array transfers without Base64 encoding overhead. The framework also supports loading JavaScript from standard ES modules to keep component dependencies self-contained and avoid global namespace pollution.
Beyond web development, Blazor extends to cross-platform .NET UI development by embedding components inside native desktop or mobile apps using an embedded web view control with a local interop channel. The framework includes ahead-of-time IL trimming to reduce published application size, with configurable granularity and the ability to preserve types and parameter names for reflection-dependent code. Code can be shared across .NET platforms by referencing libraries that conform to a common standard, enabling consistent business logic across web, desktop, and mobile projects.
Features
- Reusable UI Components - Provides a component-based UI composition model with reusable self-contained elements using C# and Razor markup.
- JavaScript Interop - Ships a bidirectional JavaScript interop bridge for calling functions, streaming data, and managing object references between .NET and JavaScript.
- Byte Array Transfers - Provides efficient byte array transfer between .NET and JavaScript without Base64 encoding overhead.
- C# Web Frontends - Creates client-side web interfaces using C# instead of JavaScript, enabling full-stack .NET development in the browser.
- Client-Side WebAssembly Rendering - Blazor downloads a runtime compiled to WebAssembly and executes code directly in the browser to handle UI rendering and interactions.
- Component-Based Web Frameworks - Creates reusable, self-contained UI components with C# logic and HTML markup for composable web applications.
- Cross-Platform UI Frameworks - Provides a framework for building reusable UI components that run across browser, desktop, and mobile via embedded web views.
- Server-Side Rendering - Renders UI on the server and updates the browser over a real-time connection, reducing client-side processing.
- Server-Side Rendering Frameworks - Renders UI on the server and sends incremental DOM updates over a real-time SignalR connection.
- Real-Time DOM Updates - Renders UI on the server and sends incremental DOM updates over a persistent real-time SignalR connection.
- Single-Page Applications - Builds interactive client-side web UIs using C# and WebAssembly instead of JavaScript.
- WebAssembly Frameworks - Compiles C# code to WebAssembly to run UI components directly in the browser.
- .NET Runtime Compilations - Downloads a .NET runtime compiled to WebAssembly and executes C# code directly in the browser for UI rendering.
- Byte Array Transfers - Transfers byte arrays between .NET and JavaScript without Base64 encoding, reducing serialization overhead.
- IL Trimming - Ships an IL trimmer that removes unused code from published assemblies to reduce download size.
- Static Method Invocations from JavaScript - Allows calling public static .NET methods from JavaScript by specifying assembly and method identifiers.
- Instance Method Invocations from JavaScript - Enables calling public instance methods on .NET objects from JavaScript via object references.
- JavaScript Object Instantiation - Instantiates JavaScript objects from .NET using constructor functions and returns handles for further interaction.
- JavaScript Object References - Creates references to non-serializable JavaScript objects for use in .NET code via IJSObjectReference.
- Module-Loaded JavaScript Isolation - Loads JavaScript from standard ES modules to avoid global namespace pollution and keep component dependencies self-contained.
- Synchronous JavaScript Invocations - Calls JavaScript synchronously from client-side WebAssembly components via IJSInProcessRuntime, reducing overhead.
- Synchronous .NET Method Invocations - Ships a synchronous interop path for calling .NET methods from JavaScript on WebAssembly, reducing overhead.
- Unreferenced Code Cleaning - Removes unreferenced intermediate language code from published assemblies to reduce application size.
- Multiplatform Code Sharing - Shares C# code and UI components across web, desktop, and mobile platforms using a common library standard.
- Externally-Rendered UI Embeds - Embeds externally-rendered UI content from JavaScript libraries into Blazor components via placeholder elements.
- HTML Element References - Captures references to rendered HTML elements and passes them to JavaScript for direct DOM manipulation.
- Embedded Web View Hosts - Embeds Blazor components inside native desktop or mobile apps using an embedded web view control with a local interop channel.
- Embedded Web Views - Embeds Blazor components inside native desktop or mobile apps using an embedded web view control.
