对显示列属性的设置,是一个数组对象。常用到的属性:name 列显示的名称;index 传到服务器端用来排序用的列名称;width 列宽度;align 对齐方式;sortable 是否可以排序
pager
定义翻页用的导航栏,必须是有效的html元素。翻页工具栏可以放置在html页面任意位置
rowNum
在grid上显示记录条数,这个参数是要被传递到后台
rowList
一个下拉选择框,用来改变显示记录数,当选择时会覆盖rowNum参数传递到后台
sortname
默认的排序列。可以是列名称或者是一个数字,这个参数会被提交到后台
viewrecords
定义是否要显示总记录数
caption
表格名称
2、事件
事件
参数
描述
afterInsertRow
rowid
rowdata
rowelem
此事件发生在每次插入行后
rowid 为插入的行ID
rowdata 是被插入行的数据数组。格式为name:value对,name在colModel定义
rowelem 是应答元素。xml为xml行,json为所有行数据。
注意:若gridview 为true,此事件不会发生
beforeRequest
none
此事件发生在任何数据请求前,但当datatype为function时不发生。
beforeSelectRow
rowid, e
此事件发生在用户点击行,选中该行前。
rowid 为行的ID,e为事件对象
该事件将返回布尔值true(行被选中)或false(行未被选中)。
gridComplete
none
此事件发生在表格所有数据装入和进程完成后。与datatype参数及排序分页等无关。
loadBeforeSend
xhr,
settings
此事件发生在XMLHttpRequest被发送前,用于修改对象属性(如headers)。 xhr 为XMLHttpRequest对象。
loadComplete
data
此事件发生在每个服务器请求后。xhr 为XMLHttpRequest对象。
loadError
xhr,
status,
error
此事件在请求失败时发生。事件有3个参数:
xhr 为XMLHttpRequest对象;
Satus 为错误类型描述;error 为错误对象。
onCellSelect
rowid,
iCol,
cellcontent,
e
此事件在点击表格特定单元格时发生。
rowid 为行ID;iCol 为列索引;
cellcontent 为单元格中内容;
e 点击事件对象。
ondblClickRow
rowid,
iRow,
iCol,
e
此事件发生在行双击后发生。
rowid为行ID;iRow 为行索引(勿与rowid混淆);
iCol为列索引;
e 为事件对象。
onHeaderClick
gridstate
此事件发生在点击显示或隐藏表格后发生(hidegrid为true) gridstate为表格状态,有visible和hidden两个值
onPaging
pgButton
此事件发生在点击page button后,填充数据前,及用户输入一个与当前页页码不同的新页码并回车时。
onRightClickRow
rowid,
iRow,
iCol,
e
此事件发生在右击行后。(此事件在Opera浏览器中无效)
rowid为行ID;iRow为行索引(勿与rowid混淆)
iCol为列索引;
e为事件对象
onSelectAll
aRowids,
status
此事件发生在点击标题的复选框时发生(multiselect为true)
aRowids 选定行ID的数组(哪些行的复选框与头复选框相同)
status 头复选框的选定的布尔值,true为选中,false为
onSelectRow
rowid,
status
此事件发生在行点击后
rowid 为行ID;
status 为选择状态。当multiselect为true时使用,当行被选中时返回true;为选中时返回false。
onSortCol
index,
iCol,
sortorder
此事件发生在列排序被点击之后,数据排序前
index 为colModel 中定义的索引名iCol 为列的索引号
sortorder 为新的排序方式,asc或desc
resizeStart
event, index
此事件发生在列被重新定义宽度时。 event 为事件对象;index 为在colModel 中定义的列索引。
resizeStop
newwidth, index
此事件发生在列被重新定义宽度后。
newwidth 为新的列宽度;index 为在colModel 中定义的列索引。
serializeGridData
postData
通过此事件可以序列化传递给ajax请求的的数据。此事件将返回一个以序列化的数据。若有自定义的数据(如JSON字符串、XML字符串)要发给服务器时,可使用该事件。
3、方法