Cell formatters are a set of predefined formatters that can be applied to cells. They will format the cell text on the client-side and present it in a specific way. The list of currently available cell formatters includes Integer, Number, Currency, CheckBox, Link and Mail.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using Trirand.Web.Mvc;
using System.Web.UI.WebControls;
namespace JQGridMVCExamples.Models
{
public class FormattersJqGridModel
{
public JQGrid FormattedGrid { get; set; }
public FormattersJqGridModel()
{
FormattedGrid = new JQGrid
{
Columns = new List()
{
new JQGridColumn { DataField = "Integer", Width = 75 },
new JQGridColumn { DataField = "Number", Width = 100 },
new JQGridColumn { DataField = "Currency", Width = 85 },
new JQGridColumn { DataField = "Email" },
new JQGridColumn { DataField = "Link" },
new JQGridColumn { DataField = "CheckBox", Width = 75 }
},
Width = Unit.Pixel(675)
};
}
}
}
<%@ Page Language="C#" Inherits="System.Web.Mvc.ViewPage<JQGridMVCExamples.Models.FormattersJqGridModel>" %>
<%@ Import Namespace="Trirand.Web.Mvc" %>
<%@ Import Namespace="JQGridMVCExamples.Models" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Custom formatters</title>
<script type="text/javascript" src="http://ajax.microsoft.com/ajax/jquery/jquery-1.7.1.min.js"></script>
<script type="text/javascript" src="http://www.trirand.net/aspnetmvc/Scripts/trirand/i18n/grid.locale-en.js"></script>
<script type="text/javascript" src="http://www.trirand.net/aspnetmvc/Scripts/trirand/jquery.jqGrid.min.js"></script>
<link rel="stylesheet" type="text/css" href="http://ajax.aspnetcdn.com/ajax/jquery.ui/1.8.16/themes/redmond/jquery-ui.css" />
<link rel="stylesheet" type="text/css" href="http://www.trirand.net/aspnetmvc/Content/themes/ui.jqgrid.css" />
</head>
<body>
<div>
<%= Html.Trirand().JQGrid(Model.FormattedGrid, "JQGrid1") %>
</div>
<br /><br />
<div>
<% Html.RenderPartial("CodeTabs"); %>
</div>
</body>
</html>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using JQGridMVCExamples.Models;
using Trirand.Web.Mvc;
namespace JQGridMVCExamples.Controllers.Grid
{
public partial class GridController : Controller
{
public class FormattedEmployee
{
public int Integer { get; set; }
public double Number { get; set; }
public double Currency { get; set; }
public string Email { get; set; }
public string Link { get; set; }
public bool CheckBox { get; set; }
}
public List GetFormattedEmployeeData()
{
List list = new List();
list.Add(new FormattedEmployee
{
Integer = 20000,
Number = 40000000.34,
Currency = 25.54,
Email = "john.smith@yahoo.com",
Link = "http://www.yahoo.com",
CheckBox = true
});
list.Add(new FormattedEmployee
{
Integer = 1000,
Number = 460000.21,
Currency = 56.54,
Email = "justin.doe@gmail.com",
Link = "http://www.gmail.com",
CheckBox = true
});
list.Add(new FormattedEmployee
{
Integer = 134000,
Number = 5220.34,
Currency = 54.12,
Email = "deborah.long@hotmail.com",
Link = "http://www.hotmail.com",
CheckBox = false
});
return list;
}
public ActionResult FunctionalityFormatters()
{
// Pass the custmomized grid model to the View
return View(GetFormattersGridModel());
}
// This method is called when the grid requests data. You can choose any method to call
// by setting the JQGrid.DataUrl property
public JsonResult Formatters_DataRequested()
{
// Get both the grid Model and the data Model
// The data model in our case is an autogenerated linq2sql database based on Northwind.
var gridModel = GetFormattersGridModel();
// return the result of the DataBind method, passing the datasource as a parameter
// jqGrid for ASP.NET MVC automatically takes care of paging, sorting, filtering/searching, etc
return gridModel.FormattedGrid.DataBind(GetFormattedEmployeeData().AsQueryable());
}
private FormattersJqGridModel GetFormattersGridModel()
{
// Get the model (setup) of the grid defined in the /Models folder.
var gridModel = new FormattersJqGridModel();
var grid = gridModel.FormattedGrid;
// Customize/change some of the default settings for this model
// ID is a mandatory field. Must by unique if you have several grids on one page.
grid.ID = "FormattedGrid";
// Setting the DataUrl to an action (method) in the controller is required.
// This action will return the data needed by the grid
grid.DataUrl = Url.Action("Formatters_DataRequested");
grid.Columns.Find(c => c.DataField == "Integer").Formatter = new IntegerFormatter
{
DefaultValue="No Value Set",
ThousandsSeparator= ","
};
grid.Columns.Find(c => c.DataField == "Number").Formatter = new NumberFormatter
{
DecimalPlaces = 1,
DecimalSeparator = ".",
ThousandsSeparator = " "
};
grid.Columns.Find(c => c.DataField == "Currency").Formatter = new CurrencyFormatter
{
DecimalPlaces = 1,
DecimalSeparator = ".",
Prefix = "$",
Suffix = " USD",
ThousandsSeparator = ","
};
grid.Columns.Find(c => c.DataField == "Email").Formatter = new EmailFormatter();
grid.Columns.Find(c => c.DataField == "Link").Formatter = new LinkFormatter();
grid.Columns.Find(c => c.DataField == "CheckBox").Formatter = new CheckBoxFormatter();
return gridModel;
}
}
}
Switch theme:
Theming is based on the very popular jQuery
ThemeRoller standard. This is the same theming mechanism used by jQuery UI and is now a de-facto standard for jQuery based components.
The benefits of using ThemeRoller are huge. We can offer a big set of ready to use themes created by professional designers, including Windows-like themes (Redmond), Apple-like theme (Cupertino), etc.
In addition to that any jQuery UI controls on the same page will pick the same theme.
Last, but not least, you can always roll your own ThemeRoller theme, using the superb
Theme Editor
To use a theme, simply reference 2 Css files in your Html <head> section - the ThemeRoller theme you wish to use, and the jqGrid own ThemeRoller Css file. For example (Redmond theme):
<link rel="stylesheet" type="text/css" media="screen" href="/themes/redmond/jquery-ui-1.8.2.custom.css" />
<link rel="stylesheet" type="text/css" media="screen" href="/themes/ui.jqgrid.css" />