jqGrid的使用笔记：3. colModel API

[b]colmodel属性[/b]
colModel定义列属性， 语法是：

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

[b]属性介绍[/b]
[table]
|[b]属性[/b]|[b]类型[/b]|[b]描述[/b]|[b]默认值[/b]|
|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|
[/table]
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.)