jqGrid的翻页要定义在html里,通常是在grid的下面,且是一个div对象:
<div id="gridpager"></div>
jQuery("#grid_id").jqGrid({
...
pager : '#gridpager',
...
});
不必给翻页设置任何的css属性。在jqGrid里定义的翻页可以是::pager : '#gridpager', pager : 'gridpager' or pager : jQuery('#gridpager'). 推荐使用前两个,当使用其他方式时jqGrid的导入导出功能时会引起错误。
导航栏的属性:
defaults : {
recordtext: "View {0} - {1} of {2}",
emptyrecords: "No records to view",
loadtext: "Loading...",
pgtext : "Page {0} of {1}"
},
...
}
如果想改变这些设置:
jQuery.extend(jQuery.jgrid.defaults,{emptyrecords: "Nothing to display",...});
...
pager : '#gridpager',
emptyrecords: "Nothing to display",
...
});
导航栏的属性:
属性名 |
类型 |
说明 |
默认值 |
是否可以被修改 |
lastpage |
integer |
只读属性,总页 数 |
0 |
NO |
pager |
mixed |
导航栏对象,必须是一个有效的 html 元素, 位置可以随 意 |
空字符 串 |
NO |
pagerpos |
string |
定义导航栏的位置, 默认分为三部分:翻页,导航工具及记录信 息 |
center |
NO |
pgbuttons |
boolean |
是否显示翻页按 钮 |
true |
NO |
pginput |
boolean |
是否显示跳转页面的输入 框 |
true |
NO |
pgtext |
string |
页面信息,第一个值是当前页第二个值是总页 数 |
语言 包 |
YES |
reccount |
integer |
只读属性,实际记录数, 千万不能跟 records 参数搞混了, 通常情况下他们是相同的, 假如我们定义 rowNum=15 , 但我们从服务器端返回的记录为 20 即 records=20 ,而 reccount=15 , 表格中也显示 15 条记 录 |
0 |
NO |
recordpos |
string |
定义记录信息的位置, 可选值: left, center, right |
right |
NO |
records |
integer |
只读属性,从服务器端返回的记录 数 |
none |
NO |
recordtext |
string |
显示记录的信息, 只有当 viewrecords 为 true 时起效,且记录数必须大于 0 |
语言 包 |
yes |
rowList |
array |
可以改变表格可以显示的记录数,格式为 [10,20,30] |
array |
no |
rowNum |
integer |
设置表格可以显示的记录 数 |
20 |
yes |
viewrecords |
boolean |
是否要显示总记录数信 息 |
false |
no |
jQuery("#grid_id").setGridParam({rowNum:10}).trigger("reloadGrid");
跟翻页相关的事件只有一个:onPaging
onPaging |
pgButton |
当点击翻页按钮但还为展现数据时触发此事件, 当然这跳转栏输入页码改变页时也同样触发此事件。 参数 pgButton 可选值: first,last,prev,next |
jqGrid的翻页导航是一个方法,你可以事先定义一些其他操作,比如:编辑、新增、删除及搜索。也可以增加自定义的函数。导航工具栏是定义到翻页控件上的。定义如下:
<table id="list"></table>
<div id="gridpager"></div>
...
pager : '#gridpager',
...
});
jQuery("#grid_id").navGrid('#gridpager',{parameters},prmEdit, prmAdd, prmDel, prmSearch, prmView);
grid_id :表格id
gridpager :导航栏id
parameters :参数列表
prmEdit, prmAdd, prmDel, prmSearch, prmView :事件
$.jgrid = { ... search : { caption: "Search...", Find: "Find", Reset: "Reset", odata : ['equal', 'not equal', 'less', 'less or equal','greater','greater or equal', 'begins with','does not begin with','is in','is not in','ends with','does not end with','contains','does not contain'], groupOps: [ { op: "AND", text: "all" }, { op: "OR", text: "any" } ], matchText: " match", rulesText: " rules" }, edit : { addCaption: "Add Record", editCaption: "Edit Record", bSubmit: "Submit", bCancel: "Cancel", bClose: "Close", saveData: "Data has been changed! Save changes?", bYes : "Yes", bNo : "No", bExit : "Cancel", }, view : { caption: "View Record", bClose: "Close" }, del : { caption: "Delete", msg: "Delete selected record(s)?", bSubmit: "Delete", bCancel: "Cancel" }, nav : { edittext: "", edittitle: "Edit selected row", addtext:"", addtitle: "Add new row", deltext: "", deltitle: "Delete selected row", searchtext: "", searchtitle: "Find records", refreshtext: "", refreshtitle: "Reload Grid", alertcap: "Warning", alerttext: "Please, select row", viewtext: "", viewtitle: "View selected row" }, ...
属性 |
类型 |
说明 |
默认值 |
add |
boolean |
是否启用新增功能,当点击按钮时会触发 editGridRow 事 件 |
true |
addicon |
string |
给新增功能设置图标,只有 UI theme 里的图标才可以使 用 |
ui-icon-plus |
addtext |
string |
新增按钮上的文 字 |
空 |
addtitle |
string |
当鼠标移到新增按钮上时显示的提 示 |
新增一 行 |
alertcap |
string |
当我们 edit,delete or view 一行记录时出现的提示信 息 |
警 告 |
alerttext |
string |
当 edit,delete or view 一行记录时的文本提 示 |
请选择一行记 录 |
closeOnEscape |
boolean |
是否可以使用 esc 键关闭对话 框 |
true |
del |
boolean |
是否启用删除功能,启用时会触发事件 delGridRow |
true |
delicon |
string |
设置删除按钮的图标,只有 UI theme 里的图标才可以使 用 |
ui-icon-trash |
deltext |
string |
设置到删除按钮上的文字信 息 |
空 |
deltitle |
string |
当鼠标移到删除按钮上时出现的提 示 |
删除锁选择的 行 |
edit |
boolean |
是否启用可编辑功能,当编辑时会触发事件 editGridRow |
true |
editicon |
string |
设置编辑按钮的图标,只有 UI theme 里的图标才可以使 用 |
ui-icon-pencil |
edittext |
string |
编辑按钮上文 字 |
空 |
edittitle |
string |
当鼠标移到编辑按钮上出现的提示信 息 |
编辑所选择的 行 |
position |
string |
定义按钮位置,可选值 left, center and right. |
left |
refresh |
boolean |
是否启用刷新按钮,当点击刷新按钮时会触发 trigger(“reloadGrid”) 事件,而且会清空搜索条件 值 |
true |
refreshicon |
string |
设置刷新图标,只有 UI theme 里的图标才可以使 用 |
ui-icon-refresh |
refreshtext |
string |
刷新按钮上文字信 息 |
空 |
refreshtitle |
string |
当鼠标移到刷新按钮上的提示信 息 |
重新加 载 |
refreshstate |
string |
指明表格如何刷新。 firstpage :从第一页开始刷新; current :只刷新当前页内 容 |
firstpage |
afterRefresh |
function |
当点击刷新按钮之后触发此事 件 |
null |
search |
boolean |
是否启用搜索按钮,会触发 searchGrid 事 件 |
true |
searchhicon |
string |
设置搜索按钮的图标,只有 UI theme 里的图标才可以使 用 |
ui-icon-search |
searchtext |
string |
搜索按钮上的文 字 |
空 |
searchtitle |
string |
当鼠标移到搜索按钮上的提示信 息 |
搜 索 |
view |
boolean |
是否启用查看按钮,会触发事件 viewGridRow |
false |
viewicon |
string |
设置查看按钮的图标,只有 UI theme 里的图标才可以使 用 |
ui-icon-document |
viewtext |
string |
查看按钮上文 字 |
空 |
viewtitle |
string |
当鼠标移到查看按钮上的提示信 息 |
查看所选记 录 |
...
pager : '#gridpager',
...
}).navGrid('#gridpager',{view:true, del:false},
{}, // use default settings for edit
{}, // use default settings for add
{}, // delete instead that del:false we need this
{multipleSearch : true}, // enable the advanced searching
{closeOnEscape:true} /* allow the view dialog to be closed when user press ESC key*/
);