之前的项目也曾用过JgGrid对它的基本功能也是略有了解，网上有个国外的开源的项目，但是不适合个人的风格，所以花了3天空余的时间封装了下JqGrid，也算是参加开发工作10个月以来写的第一个比较完整的小例子，高手们就直接飘过不用看了，但是由于时间短，还有很多的不足，需要后期再完善。
整体思路就是一个配置类，同时兼容了链式编程的风格，所有的动作接口都以Set开头，便于识别。记录下来以后做个人的使用手册。
源码地址:https://github.com/halower/JqGridForMvc/
推荐写法：
链式编程风格
@(Html.JqGrid("testJqGrid2", new GridConfiguration
(
ColumnFactory.Create("Name","姓名").SetWidth("").SetEditable(ColumnEditType.Textarea).SetSearchable(SearchFiledType.String)
ColumnFactory.Create("Id", "编号").SetWidth("").SetEditable(ColumnEditType.Text).SetSearchable(SearchFiledType.Int)
ColumnFactory.Create("Skin", "肤色").SetWidth("").SetEditable(ColumnEditType.Textarea),
ColumnFactory.Create(null, "操作").SetWidth("").SetFormatter("customerFmatter")
)
)
.SetGroupHeaders(new GroupHeader("Name", , "<font style=\"color:red;\">详细内容</font>"))
.SetCaption("JqGrid测试").SetHeight("")
.SetUrl("/Home/GridData", new Dictionary<string, string> { { "name", "halower" } })
.SetSortName("Name").SetSortOrder(SortOrderType.Desc).SetLoadText("正在加载数据请骚等...")
.SetBuiltInOperation(GridOperatorType.Add | GridOperatorType.Edit | GridOperatorType.Delete | GridOperatorType.Search)
.SetPager("pageId2").SetRowList(new[] { , , , })
.SetSubGridModel(
ColumnFactory.Create("Name", "姓名").SetWidth(""),
ColumnFactory.Create("Language", "中文").SetWidth(""),
ColumnFactory.Create("Country", "国籍").SetWidth("")
)
.SetSubGridUrl("/Home/SubGridData").SetSubGridPostParams(new[] { "Name" })
.SetEditUrl("/Home/EditPerson").SetMultiselect()
)
配置类为主的混搭风格
@(Html.JqGrid("testJqGrid", new GridConfiguration
{
GridColumns = new List<GridColumn>
{
ColumnFactory.Create("Id", "编号").SetWidth("").SetEditable(ColumnEditType.Text).SetSearchable(SearchFiledType.Int),
new GridColumn{DisplayName ="姓名",Field ="Name",Width ="",Editable = true,Search =true},
new GridColumn{DisplayName ="肤色",Field ="Skin",Width ="",Editable = true,Search =true,SearchFiledType =SearchFiledType.String},
ColumnFactory.Create(null, "操作").SetWidth("").SetFormatter("customerFmatter")
},
Caption = "JqGrid测试",
Height = "",
PagerId = "pageId",
SortName ="Name",
Sortorder = SortOrderType.Desc.ToString().ToLower(),
GridOperation = new GridOperation { Add =true,Delete =true,Edit =true,Search =true},
SetGroupHeaders=true,
ColSPanConfiguation=new ColSPanConfiguation{GroupHeaders =new[]{new GroupHeader("Name", , "<font style=\"color:red;\">详细内容</font>")}},
LoadText = "正在加载数据请骚等...",
RowList =new []{,,},
SubGridModel = new[]
{
new SubGridTable
(
ColumnFactory.Create("Name", "姓名").SetWidth(""),
ColumnFactory.Create("Language", "中文").SetWidth(""),
ColumnFactory.Create("Country", "国籍").SetWidth("")
)
},
Multiselect = true,
EditUrl = "/Home/EditPerson"
})
.SetUrl("/Home/GridData",null)
.SetSubGridUrl("/Home/SubGridData").SetSubGridPostParams(new[] { "Name" })
)
强类型方式
@(
g.JqGrid("testJqGrid").MainGrid(
g.GridColumn(x => x.Id, ),
g.GridColumn(x => x.Name, ),
g.GridColumn(x => x.Skin, ),
g.GridColumn("操作", null, "customerFmatter"))
.Caption("JqGrid测试").Height("")
.Url("/Home/GridData", new Dictionary<string, string> { { "name", "halower" } })
.SortName("Name").SortOrder(SortOrderType.Desc).LoadText("正在加载数据请骚等...")
.Pager("pageId")
.SubGrid(
g.GridColumn(x=>x.Name,),
g.GridColumn(x=>x.Language,),
g.GridColumn(x=>x.Country,)
)
.SubGridUrl("/Home/SubGridData").SubGridPostParams(new[] { "Name" })
)
后台代码实现了排序，查询，分页的全部托管，对增改查也实现了格式限制型的局部托管。
//主表格
public ContentResult GridData(string name)
{
var list = new List<Person>();
for (var i = ; i < ; i++)
{
list.Add(new Person { Id = i + , Name = "测试" + (i + ), Skin = "Yellow" + i });
}
//支持EF分页排序
//var context=new PersonContext();
//context.Persons.Pagination(this);
//context.Persons.Pagination(this,p=>p.id>15&&p.id<100);
return Content(list.Pagination(this));
}
//子表格
public string SubGridData(string name)
{
var list = new List<Chinese>();
for (var i = ; i < ; i++)
{
list.Add(new Chinese { Id = i + , Language = "中文" + i, Name = "子表测试" + (i + ), Country = "中国" + i });
}
return list.PushSubGrid(this);
} //使用原生的Form提交
public JsonResult EditPerson(Person person, string id)
{
if (!ModelState.IsValidField("Id") && !string.IsNullOrEmpty(id))
//批量删除
//return Json(id.DelegateBuildInOperation(Bussiness.DeleteInfo, this));
return Json(id.DelegateNotBuildInOperation(Bussiness.DeleteInfo));
var optDic = new Dictionary<OperTypes, Func<Person, bool>>
{
{OperTypes.Add, Bussiness.AddPerson},
{OperTypes.Edit, Bussiness.EditPerson},
{OperTypes.Delete, Bussiness.DeletePerson}
};
return Json(person.DelegateBuildInOperation(optDic, this));
} //自定义非原生提交
public JsonResult AddInfo(int id)
{
return Json(id.DelegateNotBuildInOperation(Bussiness.AddInfo));
}
调整下面的位置，自动进行列顺序【包含主表格和子表格】调整
效果如下：
需要什么JS代码，生成什么，其它采用默认配置
<script>$(function(){function _my97datePick(elem){jQuery(elem).datepicker({ dateFormat: 'yy-mm-dd' });};jQuery("#testJqGrid2").jqGrid({"url":"/Home/GridData","datatype":"json","colNames":["编号","姓名","肤色","时间","操作"],"colModel":[{"name":"Id","index":"Id","width":"300","align":"right","sortable":true,"hidden":false,"editable":true,"search":true,"stype":"text","sorttype":"int","edittype":"text","searchoptions":{sopt:['eq','lt','gt']}},{"name":"Name","index":"Name","width":"300","align":"right","sortable":true,"hidden":false,"editable":true,"search":true,"stype":"text","sorttype":"text","edittype":"textarea","searchoptions":{sopt:['eq','bw','cn']}},{"name":"Skin","index":"Skin","width":"300","align":"right","sortable":false,"hidden":false,"editable":true,"search":false,"edittype":"text","searchoptions":{sopt:['eq','bw','cn']}},{"name":"DateTime","index":"DateTime","width":"300","align":"right","sortable":false,"hidden":false,"editable":true,"search":true,"stype":"text","edittype":"text","searchoptions":{dataInit:_my97datePick,attr:{title:'选择日期'},sopt:['eq','lt','gt']}},{"width":"120","align":"right","sortable":false,"hidden":false,"editable":false,"search":false,"formatter":customerFmatter,"searchoptions":{sopt:['eq','bw','cn']}}],"rowNum":10,"rowList":[5,15,33,55],"pager":"#pageId2","sortname":"Name","mtype":"post","viewrecords":true,"ColSPanConfiguation":{"useColSpanStyle":true,"groupHeaders":[{"startColumnName":"Name","numberOfColumns":2,"titleText":"<font style=\"color:red;\">详细内容</font>"}]},"sortorder":"desc","caption":"JqGrid测试","loadtext":"正在加载数据请骚等...","pginput":false,"postData":{"name":"halower","DisplayFileds":"Id,Name,Skin,DateTime","GridKey":"Id"},"autowidth":true,"autoencode":false,"height":"250","multiselect":true,"editurl":"/Home/ChangePersonInfo","subGrid":true,"subGridModel":[{"name":["姓名","中文","国籍"],"width":["150","150","150"],"align":["right","right","right"],"params":["Name"]}],"subGridUrl":"/Home/SubGridData?DisplayFileds=Name,Language,Country","frozen":false});jQuery("#testJqGrid2").jqGrid('navGrid', '#pageId2',{"edit":true,"edittext":"编辑","add":true,"addtext":"添加","del":true,"deltext":"删除","search":true,"searchtext":"查找","refresh":false,"RefreshText":"刷新"},{checkOnSubmit:true,checkOnUpdate:true,closeAfterEdit:true,closeOnEscape:true},{checkOnSubmit:true, closeAfterAdd: true,recreateForm:true},{},{multipleSearch:true});jQuery("#testJqGrid2").jqGrid('setGroupHeaders',{"useColSpanStyle":true,"groupHeaders":[{"startColumnName":"Name","numberOfColumns":2,"titleText":"<font style=\"color:red;\">详细内容</font>"}]});})</script>
为什么要使用链式风格，使用接管代码？
1.采用链式风格主要考虑到JQ的风格，同时可以使代码结构和关联度清晰，同时保留配置类可以也让自己习惯传统风格的人自己配置
2.后台接管代码，主要目的是保持UI层的简洁，轻量级，强制使用者将业务转移到服务层/业务层去处理，防止合作者在Controller里搞一大堆业务代码。
表格接口方法说明
| 方法名称 | 参数类型 | 功能说明 |
| SetGridKey | string | 设置表格标识列 |
| SetPager | string | 设置启用分页,并设置分页控件Id |
| SetUrl | string , Dictionary<string, string> | 设置获取主表数据的地址 |
| SetCaption | string | 设置表格名称 |
| SetRowList | int[] | 设置显示下拉记录数 |
| SetSortName | string | 设置默认的排序列。可以是列名称或者是一个数字，这个参数会被提交到后台 |
| SetDirection | DriectionType | 设置表格中的书写方向 |
| SetSortOrder | SortOrderType | 设置 从服务器读取XML或JSON数据时初始的排序类型 |
| SetLoadText | string | 设置数据请求和排序时显示的文本 |
| SetPgInput | bool | 设置导航栏是否有页码输入框 |
| SetAutoWidth | bool | 设置自动宽度 |
| SetAutoEencode | bool | 设置为true时，对来自服务器的数据和提交数据进行encodes编码。如<![CDATA[<将被转换为<]]> |
| SetDataType | ResponseDataType | 设置表格希望获得的数据的类型 |
| SetEmptyRecords | string | 设置当返回(或当前)数量为零时显示的信息此项只用当Setviewrecords 设置为true时才有效。 |
| SetHeight | string | 设置表格高度。可为数值、百分比或auto |
| SetMultiselect | bool | 设置此属性设为true时启用多行选择，出现复选框 |
| SetSubGridUrl | string | 设置子表数据请求Url |
| SetSubGridPostParams | string[] | 设置子表获取数据时所依赖父表字段 |
| SetSubGridModel | GridColumn[] | 设置子表格列配置 |
| SetBuiltInOperation | GridOperatorType | 设置启用内置操作类型 |
| SetGroupHeaders | GroupHeader[] | 设置表头分组 |
| SetEditUrl | string | 设置内建编辑新增删除操作URL |
| SetMultipleSearch | bool | 设置高级搜索 |
列方法接口说明
| 方法名称 | 参数类型 | 功能说明 |
| SetWidth | string | 设置列的初始宽度，可用pixels和百分比 |
| SetHidden | bool | 定义初始化时，列是否隐藏 |
| SetEditable | ColumnEditType | 定义定义字段是否可编辑 |
| SetSearchable | SearchFiledType | 定义搜索 |
| SetSearchable | SearchFiledType ,ColumnSearchType | 定义搜索 |
| SetSortable | ColumnSortType | 启用排序 |
| SetFieldName | string, string | 设置字段映射名 |
| SetFormatter | string | 自定义Formatter函数 |
| SetUnformat | string | 自定义Unformat函数,在修改时需要获取原来的值 |
| SetEditoptions | string | 设置编辑的一系列选项 |
| SetEitrules | string | 设置编辑的一系列规则 |
| SetFrozen | bool | 设置冻结列 |
其中对于自定义的多种验证等规则和选项涉及的参数，尚不是很清楚，Eitrules便暂时使用string作为参数在后面在做配置化处理。虽然很简单，不过快过年了，如果有感兴趣的，觉得还是费点体力的，可以联系halower@foxmail.com