注:部分转自文章: http://a3mao.javaeye.com/blog/540882
ColModel 是jqGrid里最重要的一个属性,设置表格列的属性。
用法:
Java代码 :
- jQuery("#gridid").jqGrid({
- ...
- colModel: [ {name:'name1', index:'index1'...}, {...}, ... ],
- ...
- });
属性 | 数据类型 | 备注 | 默认值 |
align | string | 定义单元格对齐方式;可选值:left, center, right. | left |
classes | string | 设置列的css。多个class之间用空格分隔,如:'class1 class2' 。表格默认的css属性是ui-ellipsis | empty string |
datefmt | string | 对日期列进行格式化。”/”, ”-”, and ”.”都是有效的日期分隔符。y,Y,yyyy 年YY, yy 月m,mm for monthsd,dd 日. | ISO Date (Y-m-d) |
defval | string | 查询字段的默认值 | 空 |
editable | boolean | 单元格是否可编辑 | false |
editoptions | array | 对列进行编辑时设置的一些属性 | empty array |
editrules | array | 对于可编辑单元格的一些额外属性设置 | empty array |
edittype | string | 可以编辑的类型。可选值:text, textarea, select, checkbox, password, button, image and file. | text |
fixed | boolean | 列宽度是否要固定不可变 | false |
formoptions | array | 对于form进行编辑时的属性设置 | empty |
formatoptions | array | 对某些列进行格式化的设置 | none |
formatter | mixed | 对列进行格式化时设置的函数名或者类型 | none |
hidedlg | boolean | 是否显示或者隐藏此列 | false |
hidden | boolean | 在初始化表格时是否要隐藏此列 | false |
index | string | 当排序时定义排序字段名称的索引,参数名为sidx | empty string |
jsonmap | string | 定义了返回的json数据映射 | none |
key | boolean | 当从服务器端返回的数据中没有id时,将此作为唯一rowid使用,默认只能有一个id属性 | false |
label | string | 如果colNames为空则用此值来作为列的显示名称,如果都没有设置则使用name 值 | none |
name | string | 必输项,表格列的名称,所有关键字,保留字都不能作为名称使用包括subgrid, cb and rn. | Required |
resizable | boolean | 是否可以被resizable | true |
search | boolean | 在搜索模式下,定义此列是否可以作为搜索列 | true |
searchoptions | array | 设置搜索参数 | empty |
sortable | boolean | 是否可排序 | true |
sorttype | string | 用在当datatype为local时,定义搜索列的类型,可选值:int/integer - 对integer排序float/number/currency - 排序数字date - 排序日期text - 排序文本 | text |
stype | string | 定义搜索元素的类型 | text |
surl | string | 搜索数据时的url | empty string |
width | number | 默认列的宽度,只能是象素值,不能是百分比 | 150 |
xmlmap | string | 定义当前列跟返回的xml数据之间的映射关系 | none |
unformat | function | ‘unformat’单元格值 | null |
有一些参数当表格初始化完成后是不能被修改的: *
name
*
width
*
resizable
*
label (method avail.)
例子:
$("#grid1").xgrid({
url:{url:'../data/json-grid-standard.htm',pageSize:'10',currentPage:'1'},// 列表数据
colModel:[{"display":"序号","width":"20","align":"center","sortable":"false","name":"xuhao"},
{"display":"登陆ID","width":32,"align":"center","sortable":"true","name":"LOGIN_ID"},
{"display":"姓名","width":32,"align":"center","sortable":"true","name":"XM"},
{"display":"组织机构","width":32,"align":"left","sortable":"true","name":"ORG_ID"},
{"display":"区域","width":32,"align":"center","sortable":"true","name":"REGION_ID"},
{"display":"日期","width":32,"align":"center","sortable":"true","name":"DATE"},
{"display":"是否删除","width":32,"align":"center","sortable":"true","name":"ISDEL","hide":"true"}
], //列表结构配置
title:'列表控件',
searchitems:[
{"display":"登陆ID","name":"LOGIN_ID"},
{"display":"姓名","name":"XM"},
{"display":"时间","name":"ORG_ID"},
{"display":"日期","name":"DATE"},
{"display":"区域代码","name":"REGION_DM"}
],//列表中搜索的条件项
width:800,
callback:function(){ alert('列表初始化完成后,执行回调') },
searchMode:true //搜索模式,初始化时不加载数据并隐藏列表
});