jqGrid的使用笔记：3. colModel API

colmodel属性
colModel定义列属性， 语法是：

jQuery("#gridid").jqGrid({
...
   colModel: [ {name:'name1', index:'index1'...}, {...}, ... ],
...
});

属性介绍

属性	类型	描述	默认值
align	string	配置body层的单元格数据对齐显示，三个值：left, center, right	left
cellattr	function	数据加载时单元格动态增加属性的函数。传递给函数的参数：rowId - 行的id val - 单元格的值 rawObject - 行数据的对象：数据类型是json, 则以数组形式， 如果是xml，则为xml点。cm - colModal中列表的所有属性 rdata - 要插入到行的数据行。数组，name;value形式，name是colModel的名称。	null
classes	string	列可增加类。 如要增加多个列，则如例子：classes:'class1 class2'.	empty string
datefmt	string	当数据类型是local时，确定排序类型的格式和编辑格式{date:true}. 确定日期列的格式，比如 ”/”, ”-”, 和 ”.” 可用的格式有：y,Y,yyyy （4位数年）， YY, yy （2位数年），m,mm （月），d,dd（日）.	ISO日期(Y-m-d)
defval	string	搜索的默认值	empty
editable	boolean	设定字段是否可编辑，可适用于单元格，内联和表单模型。	false
editoptions	array	可编辑选项	empty	array
editrules	array	编辑规则	empty	array
edittype	string	编辑类型: text, textarea, select, checkbox, password, button, image and file	text
firstsortorder	string	如果设置升序或倒序，第一次排序时列使用该规则排序，随后的排序按照原有的规则。	null
fixed	boolean	如果是true,列宽不允许更改，即便shrinkToFit=true,setGridWidth方法也不能改变宽度。	false
formoptions	array	表单编辑的选项。	empty
formatoptions	array	为特定的列制定格式选项，覆盖默认的配置	none
formatter	mixed	控制字段格式的预定义类型(string)，或自定义的函数	none
frozen	boolean	如果是true,则使用setFrozenColumns方法后该列冻结。	false
hidedlg	boolean	如果是true,列不会出现在对话模式中。 用户可自定义那些列显示/隐藏。	false
hidden	boolean	起始时列是否隐藏。	false
index	string	排序时设置索引名称。	empty string
jsonmap	string	解析json字符串时所需的列和json数据映射关系	none
key	boolean	如果服务端不提供id,则以唯一的行id作为id. 只有1列有这个属性。 如果有多个，grid以第一个为标准，其它忽略。	false
label	string	如果colNames数组为空，则定义列的名称。如果colNames和该定义都为空，则显示列的名称属性值。	none
name	string	设置列的唯一名称。不可使用以下名称：subgrid, cb and rn.	Required
resizable	boolean	列是否可重新调整大小	true
search	boolean	列是否可搜索	true
searchoptions	array	搜索设置	empty
sortable	boolean	是否可排序	true
sorttype	mixed	数据类型是local时可用该选项。为列配置适当的类型。int/integer - 排序integer， float/number/currency - 排序浮点数，date - 排序日期，text - 排序字符，function - 自定义的排序函数，可传递用于排序的参数，并返回一个值	text
stype	string	搜索时设定元素的类型	text
surl	string	自定义搜索和编辑类型为‘select’时可用	empty string
template	object	colModel的属性，设定后可覆盖默认值。	null
title	boolean	如果为false，鼠标扫过单元格时不显示列标题。	true
width	number	列的起始宽度，单位是pixels, 不可以为%。	150
xmlmap	string	xml文件和列的映射关系。	none
unformat	function	编辑单元格时使用的自定义函数。	null
viewable	boolean	viewGridRow方法启动后该选项有效。如果是false, 查看Form时列不显示。	true

colModel的配置：rowId - 行id, val - 添加入单元格的值，rawObject - 数据行的对象，数据类型是json- array, xml - xml node. cm - colModel的列属性， rdata - 插入行的数据行. 属性是一串数组：type name:value, 可以通过getColProp and setColProp方法来设置和返回colModel对象的属性。 当grid形成后，以下选项不可改变：.name,width,resizable,
label (method avail.)