Forms Integration
The Window provides various approaches to load a <form> element as its content.
Html.BeginForm inside Window
To insert a complete form inside a Window, end the Window declaration with .Render(); and wrap it in a non-rendering code block. This requirement does not apply if the form is defined through plain HTML tags (<form>...</form>).
The following example demonstrates how to insert a complete form inside the Window.
@{Html.Kendo().Window()
.Name("window")
.Content(@<text>
@using (Html.BeginForm("FormSubmit", "Home"))
{
//...
}
</text>)
.Render();
}
<kendo-window name="window">
<content>
@using (Html.BeginForm("FormSubmit", "Home"))
{
//...
}
</content>
</kendo-window>
Loading External Form
The Telerik UI Window for ASP.NET Core enables you to use the LoadContentFrom() method to load content from a view into the popup content.
Though the Window allows the creation of popup forms, you need to consider the conceptual differences during their implementation. Typically, if you load a view into a Kendo UI for jQuery Window, it does not act as a separate browser window. This means that any returned data from the form submit action loads into the main page and eventually might lead to unexpected results.
To handle this behavior, render the content in an iframe.
@(Html.Kendo().Window()
.Name("PopupForm")
.Title("My Form")
.LoadContentFrom("GetForm","Home")
.Iframe(true)
.Resizable()
.Draggable()
)
<script>
// Implement a script that will close the popup when model is valid.
function closeFormPopup() {
$("#PopupForm").data("kendoWindow").close();
}
</script>
<kendo-window name="PopupForm"
title="My Form"
content-url="@Url.Action("GetForm","Home")"
iframe="true"
resizable="true"
draggable="true">
</kendo-window>
<script>
// Implement a script that will close the popup when model is valid.
function closeFormPopup() {
$("#PopupForm").data("kendoWindow").close();
}
</script>
public ActionResult GetForm()
{
// Return the view with the form.
return View("Form");
}
@* As this is loaded in an iframe, the view will have a layout to load an entire HTML page. *@
@{
Layout = "~/Views/Shared/_Layout.cshtml";
}
@model TelerikMvcApp.Models.MyModel
@using (Html.BeginForm("MyModel_Create", "MyModel", FormMethod.Post))
{
@Html.ValidationSummary()
@Html.EditorForModel(Model);
@(Html.Kendo().Button()
.Name("SubmitBtn")
.HtmlAttributes(new { type = "submit" })
.Content("Submit")
)
}
public class MyModel
{
[Required]
[Url(ErrorMessage = "Please enter a valid url")]
public string Url { get; set; }
[Required]
[StringLength(10)]
public string Description { get; set; }
}
[HttpPost]
public ActionResult MyModel_Create(MyModel model)
{
if (!ModelState.IsValid)
{
/* If the model is invalid, as expected, return the same
view and send the invalid model to update validation. */
return View("Form", model);
}
// Return a script that runs the close method of the parent window.
return Content("<script>window.parent.closeFormPopup()</script>");
}
In case the Form is used in a RazorPages application, create the form with no ActionMethod and Controller. Upon submission, the OnPost() ActionMethod in the code-behind will be invoked:
@page
@model Telerik.Examples.RazorPages.Pages.Form.FormAjaxSubmitModel
@{ ViewData["Title"] = "FormIndex"; }
@using Telerik.Examples.RazorPages.Models
@using Kendo.Mvc.UI
@inject Microsoft.AspNetCore.Antiforgery.IAntiforgery Xsrf
@{ var token = Xsrf.GetAndStoreTokens(HttpContext).RequestToken; }
@using (Html.BeginForm(FormMethod.Post))
{
@Html.EditorForModel(Model);
@Html.ValidationSummary()
@(Html.Kendo().Button()
.Name("SubmitBtn")
.HtmlAttributes(new { type = "submit" })
.Content("Submit")
)
}
public class FormAjaxSubmitModel : PageModel
{
[BindProperty]
public MyModel MyModel { get; set; }
public void OnGet()
{
if (MyModel == null)
{
MyModel = new MyModel();
}
}
public IActionResult OnPost(MyModel MyModel)
{
return Content("<script>window.parent.closeFormPopup()</script>");
}
}