Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/FritzAndFriends/BlazorWebFormsComponents

A collection of Blazor components that emulate the ASP.NET Web Forms controls of the same name
https://github.com/FritzAndFriends/BlazorWebFormsComponents

asp aspnetcore blazor blazor-components nuget webforms

Last synced: 2 days ago
JSON representation

A collection of Blazor components that emulate the ASP.NET Web Forms controls of the same name

Lists

README 

        
# BlazorWebFormsComponents



A collection of Blazor components that emulate the web forms components of the same name



[![Build status](https://dev.azure.com/FritzAndFriends/BlazorWebFormsComponents/_apis/build/status/BlazorWebFormsComponents-.NET%20Standard-CI)](https://dev.azure.com/FritzAndFriends/BlazorWebFormsComponents/_build/latest?definitionId=14)  [![Join the chat at https://gitter.im/BlazorWebFormsComponents/community](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/BlazorWebFormsComponents/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)  [![docs](https://github.com/FritzAndFriends/BlazorWebFormsComponents/workflows/docs/badge.svg)](https://fritzandfriends.github.io/BlazorWebFormsComponents/)



[![Nuget](https://img.shields.io/nuget/v/Fritz.BlazorWebFormsComponents?color=violet)](https://www.nuget.org/packages/Fritz.BlazorWebFormsComponents/)  [![Nuget (with prereleases)](https://img.shields.io/nuget/vpre/Fritz.BlazorWebFormsComponents)](https://www.nuget.org/packages/Fritz.BlazorWebFormsComponents/)  [![Live Sample](https://img.shields.io/badge/-Live%20Sample-purple)](https://blazorwebformscomponents.azurewebsites.net)



[Live Samples running on Azure](https://blazorwebformscomponents.azurewebsites.net)



## Approach + Considerations



We believe that Web Forms applications that have been well maintained and provide value should have a path forward to the new user-interface frameworks with minimal changes.  This is not an application converted nor is it a patch that can be applied to your project that magically makes it work with ASP.NET Core.  This repository contains a library and series of strategies that will allow you to re-use much of your markup, much of your business code and help shorten your application re-write process.



This is not for everyone, not everyone needs to migrate their application.  They can continue being supported as Web Forms for a very long time (2029 EOL at the time of this writing) and the applications that are considered for migration to Blazor may be better suited with a complete re-write.  For those applications that need to be migrated, this library should help make that process simpler by providing components with the same names, markup, and functionality as previously available.



[Documentation is available online](https://fritzandfriends.github.io/BlazorWebFormsComponents/).  [Get started with your migration, steps ahead, and strategy documentation](docs/Migration/readme.md) for various controls and tools used are available.  Live versions of these components are availalbe on the [Live Samples website](https://blazorwebformscomponents.azurewebsites.net)



Portions of the [original .NET Framework](https://github.com/microsoft/referencesource) are contributed to this project under their MIT license.



## Blazor Components for Controls



There are a significant number of controls in ASP.NET Web Forms, and we will focus on creating components in the following order:



  - Editor Controls

    - [AdRotator](docs/EditorControls/AdRotator.md)

    - [Button](docs/EditorControls/Button.md)

    - [HiddenField](docs/EditorControls/HiddenField.md)

    - [HyperLink](docs/EditorControls/HyperLink.md)

    - [Image](docs/EditorControls/Image.md)

    - [ImageButton](docs/EditorControls/ImageButton.md)

    - [Label](docs/EditorControls/Label.md)

    - [LinkButton](docs/EditorControls/LinkButton.md)

    - [Literal](docs/EditorControls/Literal.md)

  - Data Controls

    - Chart(?)

    - [DataList](docs/DataControls/DataList.md)

    - DataPager

    - DetailsView

    - [FormView](docs/DataControls/FormView.md)

    - [GridView](docs/DataControls/GridView.md)

    - [ListView](docs/DataControls/ListView.md)

    - [Repeater](docs/DataControls/Repeater.md)

  - Validation Controls

    - CompareValidator

    - [CustomValidator](docs/ValidationControls/CustomValidator.md)

    - RangeValidator

    - [RegularExpressionValidator](docs/ValidationControls/RegularExpressionValidator.md)

    - [RequiredFieldValidator](docs/ValidationControls/RequiredFieldValidator.md)

    - [ValidationSummary](docs/ValidationControls/ValidationSummary.md)

  - Navigation Controls

    - Menu

    - SiteMapPath

    - [TreeView](docs/NavigationControls/TreeView.md)

  - Login Controls

    - ChangePassword

    - Login

    - LoginName

    - LoginStatus

    - LoginView

    - PasswordRecovery



We will NOT be converting any DataSource objects, Wizard components, skins or themes.  Once this first collection of 23 controls is written, we can consider additional features like modern tag formatting.



## Utility Features



There are a handful of features that augment the ASP.NET development experience that are made available as part of this project in order to support migration efforts.  Importantly, these features are NOT implemented the same way that they are in Web Forms, but rather have the same API and behave in a proper Blazor fashion.  These features include:



  - [DataBinder](docs/UtilityFeatures/Databinder.md)

  - [ViewState](docs/UtilityFeatures/ViewState.md)



## Compiling the project



There are three different types of .NET projects in this repository:  .NET Framework, .NET Core, and .NET Standard.  The sample projects are in the `/samples` folder, while the unit test project is next to the component library in the `/src` folder.  From the root of the repository, you should be able to execute:



`dotnet restore` to restore packages



`dotnet run --project samples/AfterBlazorServerSide` to start the Blazor Server-Side samples