jqGrid for ASP.NET MVC comes with a large number of predefined language packs and settings for almost all popular languages. They are located in the installation package, in the /js/i18n folder. Lnaguage packs are in the form of javascript files, containing definitions for all strings in the grid that can be localized - this includes messages, captions, paging information, search/add/delete dialog labels, etc.
In order to use a particular language pack, you need to include the javascript language pack to the head of your page, after the jQuery library reference (since language packs depend on jQuery) and before referencing the jqGrid javascript file (since it is dependent on the language pack).
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 OrdersJqGridModel
{
public JQGrid OrdersGrid { get; set; }
public OrdersJqGridModel()
{
OrdersGrid = new JQGrid
{
Columns = new List()
{
new JQGridColumn { DataField = "OrderID",
// always set PrimaryKey for Add,Edit,Delete operations
// if not set, the first column will be assumed as primary key
PrimaryKey = true,
Editable = false,
Width = 50 },
new JQGridColumn { DataField = "CustomerID",
Editable = true,
Width = 100 },
new JQGridColumn { DataField = "OrderDate",
Editable = true,
Width = 100,
DataFormatString = "{0:yyyy/MM/dd}" },
new JQGridColumn { DataField = "Freight",
Editable = true,
Width = 75 },
new JQGridColumn { DataField = "ShipName",
Editable = true
}
},
Width = Unit.Pixel(640),
Height = Unit.Percentage(100)
};
OrdersGrid.ToolBarSettings.ShowRefreshButton = true;
}
}
}
<%@ Page Language="C#" Inherits="System.Web.Mvc.ViewPage<JQGridMVCExamples.Models.OrdersJqGridModel>" %>
<%@ 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>Localization</title>
<script type="text/javascript" src="http://ajax.microsoft.com/ajax/jquery/jquery-1.7.1.min.js"></script>
<script type="text/javascript" src='<%= ViewData["localeScript"] %>'></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.BeginForm("functionalitylocalization", "grid"); %>
<span style="font-size: 130%">Please, select a language:</span> <%= Html.DropDownList("locale", ViewData["localesList"] as SelectList, new { onchange="this.form.submit();" })%>
<% Html.EndForm(); %>
<br />
<%= Html.Trirand().JQGrid(Model.OrdersGrid, "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;
namespace JQGridMVCExamples.Controllers.Grid
{
public partial class GridController : Controller
{
// This is the default action for the View. Use it to setup your grid Model.
public ActionResult FunctionalityLocalization(string locale)
{
string jsLocale = locale ?? "grid.locale-en.js";
ViewData["localesList"] = GetLocales(jsLocale);
ViewData["localeScript"] = "http://www.trirand.net/aspnetmvc/Scripts/trirand/i18n/" + jsLocale;
// Pass the custmomized grid model to the View
return View(GetGridModel());
}
// This method is called when the grid requests data. You can choose any method to call
// by setting the JQGrid.DataUrl property
public JsonResult LocalizationDataRequested()
{
// 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 = GetGridModel();
var northWindModel = new NorthwindDataContext();
// 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.OrdersGrid.DataBind(northWindModel.OrdersLarges);
}
private OrdersJqGridModel GetGridModel()
{
// Get the model (setup) of the grid defined in the /Models folder.
var gridModel = new OrdersJqGridModel();
// 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.
gridModel.OrdersGrid.ID = "OrdersGrid";
// Setting the DataUrl to an action (method) in the controller is required.
// This action will return the data needed by the grid
gridModel.OrdersGrid.DataUrl = Url.Action("LocalizationDataRequested");
return gridModel;
}
public SelectList GetLocales(string selectedValue)
{
List countries = new List();
countries.Add(new SelectListItem { Text = "English", Value = "grid.locale-en.js" });
countries.Add(new SelectListItem { Text = "German", Value = "grid.locale-de.js" });
countries.Add(new SelectListItem { Text = "French", Value = "grid.locale-fr.js" });
countries.Add(new SelectListItem { Text = "Spanish", Value = "grid.locale-sp.js" });
countries.Add(new SelectListItem { Text = "Italian", Value = "grid.locale-it.js" });
countries.Add(new SelectListItem { Text = "Dutch", Value = "grid.locale-nl.js" });
countries.Add(new SelectListItem { Text = "Norwegian", Value = "grid.locale-no.js" });
countries.Add(new SelectListItem { Text = "Finish", Value = "grid.locale-fi.js" });
countries.Add(new SelectListItem { Text = "Hebrew", Value = "grid.locale-he.js" });
countries.Add(new SelectListItem { Text = "Japanese", Value = "grid.locale-jp.js" });
countries.Add(new SelectListItem { Text = "Portuguese", Value = "grid.locale-pt.js" });
countries.Add(new SelectListItem { Text = "Brasilian-Portuguese", Value = "grid.locale-pt-br.js" });
countries.Add(new SelectListItem { Text = "Russian", Value = "grid.locale-ru.js" });
countries.Add(new SelectListItem { Text = "Romanian", Value = "grid.locale-ro.js" });
countries.Add(new SelectListItem { Text = "Polish", Value = "grid.locale-pl.js" });
countries.Add(new SelectListItem { Text = "Czech", Value = "grid.locale-cs.js" });
countries.Add(new SelectListItem { Text = "Greek", Value = "grid.locale-el.js" });
countries.Add(new SelectListItem { Text = "Persian", Value = "grid.locale-fa.js" });
countries.Add(new SelectListItem { Text = "Icelandic", Value = "grid.locale-is.js" });
countries.Add(new SelectListItem { Text = "Swedish", Value = "grid.locale-sv.js" });
countries.Add(new SelectListItem { Text = "Turkish", Value = "grid.locale-tr.js" });
countries.Add(new SelectListItem { Text = "Ukrainian", Value = "grid.locale-ua.js" });
countries.Add(new SelectListItem { Text = "Catalan", Value = "grid.locale-cat.js" });
countries.Add(new SelectListItem { Text = "Bulgarian", Value = "grid.locale-bg.js" });
return new SelectList(countries, "Value", "Text", selectedValue);
}
}
}
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" />