jqGrid的使用记录(实现分页、搜索功能)(8)

方法   参数   返回值   描述  
addJSONData   data   none   用传递的data(数组)填充网格。用法:假如我们从web服务器获得的数据(jsonresponse),则
var mygrid = jQuery(”#”+grid_id)[0];
var myjsongrid = eval(”(”+jsonresponse.responseText+”)”); 
mygrid.addJSONData(myjsongrid); 
myjsongrid = null; 
jsonresponse =null; 
将填充网格。当然,myjsongrid中的数据在传递到addJSONData之前可以被操作。
 
addRowData   rowid,
data, 
position, 
srcrowid
  true on success, 
false otherwise
  插入一新行,rowid 为新行的ID,data(数组)为新行数据,position为新行插入的位置(first为表头,last为表尾,srcrowid指定偏移位置)。Data数组的格式为:{name1:value1,name2: value2…} ,name为colModel指定的名称。  
addXmlData   data   none   用传入的data填充网格。用法:假如我们从web服务器获得数据
(xmlresponse),则 var mygrid = jQuery(”#”+grid_id)[0]; 
mygrid.addXmlData(xmlresponse.responseXML); 
将填充网格。当然,xmlresponse中的数据在传递到addXmlData之前可以被操作。
 
clearGridData   clearfooter   jqGrid object   清除网格中当前装入的数据,如果clearfooter 参数为true,则清除网格最后一行数据。  
delRowData   rowid   true on success, 
false otherwise
  删除id = rowid的行。但不会删除服务器上的数据。  
footerData   action,
data, 
format
  jqGrid object   此方法获得或设置网格底部数据。
action – 可设置为get(缺省)或set。 Get从底部返回name:value对象(name为colModel中的名称)。此时其他两个参数无效。 
Set将data数组(对象)设置到底部。Data为colName中的名称和值对。
format – 缺省为true,表示设置时使用formatter (如果colModel中已定义)。false表示不使用formatter
 
getCell   rowid, 
iCol
  cell content   返回id = rowid行,column = iCol列的内容。 iCol可以是列的索引或colName中定义的名称。在编辑行或列时不能使用该方法,此时返回的不是当前值,而是原始值。  
getCol   colname, returntype, mathoperation   array[] or value   返回列值数组。
colname 可以是列的索引值或colModel中的名称。returntype 确定返回数组的类型,为false(缺省)时,数组只包含值。为true时为对象数组,格式为{id:rowid, value:cellvalue},id为行的id, cellvalue为单元格的值。如 [{id:1,value:1},{id:2,value:2}…] 
mathoperation为可选参数,可以是sum、avg和count。若此参数进行了有效设置,则返回计算后的值,若无效,则返回空数组。
 
getDataIDs   none   array[]   返回当前网格显示数据的ID数组。无数据时返回空数组。  
getGridParam   name   mixed value   返回请求的参数的值。name 是options 数组中的名称,若为设置则options被返回。  
getInd   rowid,
rowcontent
  mixed   当rowcontent 设置为false(缺省)时,返回id= rowid行的索引值。若rowcontent设置为true,则返回整行。若为找到rowid则返回false。  
getLocalRow   rowid   row object   Return the row data from the local array stored in data parameter when the datatype is local  
getRowData   rowid or none   array{}   返回id = rowid行的数据数组。格式为name:value对,name为colModel中的名称,value为该行的值。未找到返回空数组。在行或列编辑时此方法不可用,此时返回的不是当前值,而是原始值。
若rowid为设置,则返回网格中所有数据数组。
 
hideCol   colname
or
[colnames]
  jqGrid object   根据colname或colnames数组给定的列名隐藏相应的列,列名必须是colModel中定义的名称。表格的宽度不会改变。  
remapColumns   permutation, updateCells, keepHeader   none   调整列的显示顺序。permutation指定调整后的顺序,如 [1,0,2] 表示第一列在第二位显示。若updateCells 设置为true,列数据将重新排序。若keepHeader 设置为true,header单元格将重新排序。  
resetSelection   none   jqGrid object   选择(反选)行。多选择模式下同样可用。  
setCaption   caption   jqGrid object   设置新的表头文字。若表头为隐藏,将显示。  
setCell   rowid,
colname, 
data, 
class, 
properties, 
forceup
  jqGrid object   修改单元格的值、类或样式。其中:
rowid为行ID;colname为列名(可以是从0开始的列的索引值);
data 设置的内容,若为空,class若为字符串,将使用addClass为列加入一个类,若为数组,将直接加入CSS中;properties 设置单元格属性。
 
setGridParam   object   jqGrid object   设置一个特定的参数。
有些参数需trigger(“reloadGrid”)才能生效。注意这个方法可以覆盖事件。名称(name:value对)为选项数组中的名称。 
 
setGridHeight   new_height   jqGrid object   动态设置网格高度。只能对单元格的高度进行设置而不是网格。new_height 可以是像素、百分比或auto。  
setGridWidth   new_width,
shrink
  jqGrid object   动态设置网格宽度。new_width 为新宽度的像素值;
shrink(true或false)作用同shrinkToFit。若不设置,则使用shrinkToFit设置。
 
setLabel   colname, 
data, 
class, 
properties
  jqGrid object   设置指定列标题文字、属性和类:
colname 为列名,可以是从0开始的列索引;
data 为标题文字,为空则不修改;
class 若为字符串,则为类名,若为数组,则直接写入CSS;
properties 为标题文字的属性。
 
setRowData   rowid,
data, 
cssprop
  true on success, 
false otherwise
  更新rowid指定行的数据(使用数组)。
Data数组的格式为: {name1:value1,name2: value2…} 。name为colModel中描述的名称,value为新值。cssprop若为字符串,将使用addClass为行添加类;若为数组对象,则直接加入CSS中。将data设置为false的情况下,可设置属性和类名
 
setSelection   rowid,
onselectrow
  jqGrid object   选择或反选id = rowid指定的行。若onselectrow设置为true (缺省) 则触发onSelectRow事件,否则不触发。  
showCol   colname   jqGrid object   显示colname 指定的列。若colname为字符串,只显示指定的列,若colname为数组 [“name1”,”name2”] 则显示name1和name2列, name必须是colModel中的名称。宽度不变。  
trigger(“reloadGrid”)   none   none   按当前设置重新加载网格。若datatype为xml或json,将从服务器重新请求数据。此方法适用于一个已建立的网格。注意不会改变表头,也就是说改变colModel将没有作用。你可用gridUnload,使用新colModel来重新加载。  
updateColumns   none   none   在拖拽表格时,同步网格宽度。用法:
var mygrid=jQuery(”#grid_id”)[0];
mygrid.updateColumns();
 

四、问题记录

1、IE9下jQgrid一直出现水平滚动条的问题。

解决:是因为jqGrid会在IE下出现border与padding造成宽度过大引起的,增加此属性可解决:

cellLayout:0

此时当页面缩放摆100%时,已经不显示滚动条,但是缩放比例不为100%时,依然会显示水平滚动条,终极解决方案为更改ui.jqgrid.css样式:

.ui-jqgrid .ui-jqgrid-bdiv{ overflow-x: hidden; }

如果还是不行,还有一个方法:

$(grid_selector).closest(".ui-jqgrid-bdiv").css({ 'overflow-x': 'hidden' });

当然你也可以直接修改样式.ui-jqgrid-bdiv增加overflow-x:hidden;

2、自定义操作列。

jqGrid默认的自定义编辑列,只能设置编辑按钮与删除按钮。并且图标基本上都很难控制,如果想自己实现自己的自定义编辑列,可以如下操作:

在actions列的formatoptions项,增加此行:

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/wzzpxj.html