Form Helper

#1 Form Library for ASP.NET Core MVC

If you like this library and want to support it, please give a star. ⭐

Form & Validation Helper for ASP.NET Core MVC

Form Helper helps you to create ajax forms and validations without writing any javascript code. It transforms server-side validations to client-side. You can also use the form validator without ajax.

Compatible with Fluent Validation ✅

(You can add client-side validation support to Fluent Validation.)

Installation

FormHelper can be installed using the Nuget Package Manager or the dotnet CLI.

Package Manager:

Install-Package FormHelper

dotnet CLI:

dotnetadd package FormHelper

This library works with jQuery

CDN:

<!-- form helper - You don't need to add these files to your project, just add it. it's embeded! --><!-- if you dont't want to use these embeded files, you can download the files from dist folder --><!-- You can use formhelper.js/css instead of formhelper.min.js/css to debug. --><!-- The bundle file includes jQuery validation and jQuery validation unobtrusive --><linkrel="stylesheet" href="/formhelper/formhelper.min.css" /><scriptsrc="/formhelper/formhelper.bundle.min.js"></script>

Usage

Startup.cs

ConfigureServices:

services.AddControllersWithViews().AddFormHelper();

With configuration: (optional)

services.AddControllersWithViews().AddFormHelper(options => {
options.CheckTheFormFieldsMessage = "Your custom message...";
options.RedirectDelay = 6000;
options.EmbeddedFiles = true;
options.ToastrDefaultPosition = ToastrPosition.TopFullWidth;
});

Configure:

<!-- If you want to use embeded form helper files, add this line -->
app.UseFormHelper();

ViewImports.cshtml

@usingFormHelper@addTagHelper*, FormHelper

View: (TagHelper)

<formasp-formhelper="true" asp-controller="Home" asp-action="Save">// <input...// ...</form>// You can use <form asp-formhelper="true"> or <formhelper> to activate formhelper.// Optional parameters:// asp-callback="javascriptFunctionName", asp-beforeSubmit="javascriptFunctionName", asp-dataType="FormData/Json", asp-enableButtonAfterSuccess="false", asp-resetFormAfterSuccess="true" asp-toastrPosition="ToastrPosition.BottomRight"

Controller:

[FormValidator]publicIActionResultSave(FormViewModelviewModel)// If you use Json data type, you need to add [FromBody] attribute.// public IActionResult Save([FromBody]FormViewModel viewModel)

Return a result from Controller:

Error Message:

return FormResult.CreateErrorResult("An error occured.");

Success Message:

return FormResult.CreateSuccessResult("Product saved.");

Success Message with Redirect:

return FormResult.CreateSuccessResult("Product saved. Please wait...", Url.Action("Home", "Index"));

Success Message with Redirect and Delay Time:

return FormResult.CreateSuccessResult("Product saved. Please wait...", Url.Action("Home", "Index"), 10000); // 10 seconds

Fill the form fields from a json object:

$("#formId").fillFormFields(yourJsonObject);

Reset form and clear error messages:

$("#formId").fhReset();

Toastr:

Success:

fhToastr.success("Text here");

Warning:

fhToastr.warning("Text here");

Information:

fhToastr.information("Text here");

Error:

fhToastr.error("Text here");