【转】Jqgrid学习之ColModel API
ColModel 是jqGrid里最重要的一个属性,设置表格列的属性。
属性 |
数据类型 |
备注 |
默认值 |
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 |
编辑的一系列选项。{name:’__department_id’,index:’__department_id’,width:200,editable:true,edittype:’select’,editoptions: {dataUrl:”${ctx}/admin/deplistforstu.action”}},这个是演示动态从服务器端获取数据。 |
empty |
editrules |
array |
编辑的规则{name:’age’,index:’age’, width:90,editable:true,editrules: {edithidden:true,required:true,number:true,minValue:10,maxValue:100}},设定 年龄的最大值为100,最小值为10,而且为数字类型,并且为必输字段。 |
empty |
edittype |
string |
可以编辑的类型。可选值:text, textarea, select, checkbox, password, button, image and file. |
text |
fixed |
boolean |
列宽度是否要固定不可变 |
false |
formoptions |
array |
对于form进行编辑时的属性设置 |
empty |
formatoptions |
array |
对某些列进行格式化的设置 |
none |
formatter |
mixed |
对列进行格式化时设置的函数名或者类型 {name:’sex’,index:’sex’, align:’center’,width:60,editable:true,edittype:’select’,editoptions: {value:’0:待定;1:男;2:女’},formatter:function(cellvalue, options, rowObject){ |
none |
hidedlg |
boolean |
是否显示或者隐藏此列 |
false |
hidden |
boolean |
在初始化表格时是否要隐藏此列 |
false |
index |
string |
索引。其和后台交互的参数为sidx |
empty |
jsonmap |
string |
定义了返回的json数据映射 |
none |
key |
boolean |
当从服务器端返回的数据中没有id时,将此作为唯一rowid使用只有一个列可以做这项设置。如果设置多于一个,那么只选取第一个,其他被忽略 |
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 |
width |
number |
默认列的宽度,只能是象素值,不能是百分比 |
150 |
xmlmap |
string |
定义当前列跟返回的xml数据之间的映射关系 |
none |
unformat |
function |
‘unformat’单元格值 |
null |