Introduction
In this example we will describe how to add a jQuery Datepicker to a MVC application. jQuery is one of the widely used scripting languages for web development. jQuery provides built-in support for a DateTime picker. In this article I explain how to add a jQuery Datepicker with MVC.
The following is the procedure to add the jQuery Datepicker to a MVC application.
Step 1
Go to New project and select the Web tab and select ASP.Net Web Application. Provide a suitable name for your project, such as DateTimeDemo and click the OK button.
Step 2
Then following screen will appear. Select the MVC tab and click the OK button.
Step 3
A project solution has been created with some pre-defend controllers, scripts and so on. Now go to the Model folder and a class called Employee with three auto-implemented properties like:
- public class Employee
- {
- [Required]
- [Display(Name = "Id")]
- public int EmpId { get; set; }
- [Display(Name = "Name")]
- [Required]
- public string EmpName { get; set; }
- [Required]
- [Display(Name = "Date Of Birth")]
- [DisplayFormat(ApplyFormatInEditMode = true, DataFormatString = "{0:dd/MMM/yyyy}")]
- public DateTime DOB { get; set; }
- }
In this code I have done some basic Data annotation validation with all those three properties. You can ignore if you want.
Step 4
Now go to the Controllers folder and right-click on the Add Controller option then the following window will appear. Select MVC5 Controller-Empty. Provide a name for the controller, say Employee, and click on the Add button.
Step 5
Controller code will be automatically generated with one Index action method like:
- public class EmployeeController : Controller
- {
-
- public ActionResult Index()
- {
- return View();
- }
- }
Step 6
Right-click anywhere on the Index action method and click add view then select the Employee model class and add that view of type Create as in the following:
Step 7
Then the Employee create view will be automatically generated with the following code.
- @model DateTimeDemo.Models.Employee
-
- @{
- ViewBag.Title = "Index";
- }
-
- <h2>Index</h2>
-
-
- @using (Html.BeginForm())
- {
- @Html.AntiForgeryToken()
-
- <div class="form-horizontal">
- <h4>Employee</h4>
- <hr />
- @Html.ValidationSummary(true, "", new { @class = "text-danger" })
- <div class="form-group">
- @Html.LabelFor(model => model.EmpId, htmlAttributes: new { @class = "control-label col-md-2" })
- <div class="col-md-10">
- @Html.EditorFor(model => model.EmpId, new { htmlAttributes = new { @class = "form-control" } })
- @Html.ValidationMessageFor(model => model.EmpId, "", new { @class = "text-danger" })
- </div>
- </div>
-
- <div class="form-group">
- @Html.LabelFor(model => model.EmpName, htmlAttributes: new { @class = "control-label col-md-2" })
- <div class="col-md-10">
- @Html.EditorFor(model => model.EmpName, new { htmlAttributes = new { @class = "form-control" } })
- @Html.ValidationMessageFor(model => model.EmpName, "", new { @class = "text-danger" })
- </div>
- </div>
-
- <div class="form-group">
- @Html.LabelFor(model => model.DOB, htmlAttributes: new { @class = "control-label col-md-2" })
- <div class="col-md-10">
- @Html.EditorFor(model => model.DOB, new { htmlAttributes = new { @class = "form-control", placeholder = "Employee Date Of Birth", @readonly = "true" } })
- @Html.ValidationMessageFor(model => model.DOB, "", new { @class = "text-danger" })
- </div>
- </div>
-
- <div class="form-group">
- <div class="col-md-offset-2 col-md-10">
- <input type="submit" value="Create" class="btn btn-default" />
- </div>
- </div>
- </div>
- }
-
- <div>
- @Html.ActionLink("Back to List", "Index")
- </div>
-
- @section Scripts {
- }
I have made some basic changes with the HTML of the DOB properties of this model, you may ignore it if you want.
Step 8
Now we need to add the reference of jQueryUi to the project. By default Visual Studio will not add a reference of jQueryUI for us. So to ass the jQueryUi reference right-click on the References tab then select Manage NuGet Packages as in the following:
Step 9
Now search for jQueryUI and select Install to install it.
If your project already has the reference of jQueryUI then it will show as in the following tik mark.
Step 10
Once the references for jQueryUI have been added to your project you can check your Content and scripts folder and it will have the files showing in the following images:
Step 11
Now simply go to the App_Start folder and open BundleConfig.cs. There will be some default code there. Leave the code and add the following code:
-
-
- bundles.Add(new ScriptBundle("~/bundles/jqueryui").Include(
- "~/Scripts/jquery-ui-{version}.js"));
-
- bundles.Add(new StyleBundle("~/Content/cssjqryUi").Include(
- "~/Content/jquery-ui.css"));
The preceding code will create a bundle for jQueryUI scripts and CSS. Now you just need to add those bundles to the page where you want the DatePicker.
Step 12
Now go to the index view and add the following code to the Scripts section of the view.
- @section Scripts {
-
- @Scripts.Render("~/bundles/jqueryui")
- @Styles.Render("~/Content/cssjqryUi")
-
- <script type="text/javascript">
- $(document).ready(function () {
- $('input[type=datetime]').datepicker({
- dateFormat: "dd/M/yy",
- changeMonth: true,
- changeYear: true,
- yearRange: "-60:+0"
- });
-
- });
- </script>
-
- }
Step 13
That's it. Run the Index view and you will get the date picker as in the following:
Notice the code inside scraps I have used following code there:
- dateFormat: "dd/M/yy",
- changeMonth: true,
- changeYear: true,
- yearRange: "-60:+0"
These are the customizations of jQueryUI that provide customization of the DatePicker depending on the needs of the developer. For all the default customizations go through jQuery Documentation.
Summary
In this illustration you came to understand how to add a DatePicker to MVC. Download the sample code for a better understanding. Thanks. I would like to get feedback from my readers. Please post your feedback, question, or comments about this article.