Fork me on GitHub

MvcPager帮助文档 - Javascript API

MvcPager 3.0新增客户端Javascript API功能,利用Javascript API,可以遍历当前页面上所有的MvcPager,获取每个MvcPager的相关属性以及实现跳转到指定页面的功能。
注意:要使用Javascript API,必须引入jQuery脚本库并使用Html.RegisterMvcPagerScriptResource()方法注册MvcPager的客户端脚本插件!

页面加载后,可以使用 Webdiyer.MvcPagers 数组对象来获取当前页面上所有的MvcPager集合,每个MvcPager都是一个Webdiyer.MvcPager类型的Javascript对象,您可以使用索引号来获取某个MvcPager,也可以用 getById(id) 方法根据MvcPager的Id来获取指定的MvcPager。示例如下:

根据索引号获取第一个MvcPager:

var pager = Webdiyer.MvcPagers[0];

获取Id为mypager的MvcPager对象:

var pager = Webdiyer.MvcPagers.getById("mypager");

Webdiyer.MvcPager对象的主要属性如下:

名称说明
currentPageIndex当前页索引
pageCount总页数
id客户端DOM Id,,对应于PagerOptions.Id属性值
isAjaxPager是否AjaxPager
invalidPageErrMsg页索引无效时显示的错误信息,对应于PagerOptions.InvalidPageIndexErrorMessage属性值
outOfRangeErrMsg页索引超出范围时显示的错误信息,对应于PagerOptions.PageIndexOutOfRangeErrorMessage属性值
firstPageUrl首页Url
pageIndexName路由Url中页索引参数的名称,对应于PagerOptions.PageIndexParameterName属性值
pageIndexBox页索引输入或选择框的客户端ID选择器,以“#”前缀,对应于PagerOptions.PageIndexBoxId属性值
goToButton页索引输入或下拉框跳转按钮的客户端ID选择器,以“#”前缀,对应于PagerOptions.GoToButtonId属性值
maxPageIndexItems页索引下拉框中显示的最大页索引条数,对应于PagerOptions.MaximumPageIndexItems属性值

Webdiyer.MvcPager 对象提供了goToPage(pageIndex)方法以实现跳转到指定页,该方法在跳转之前会对传入的pageIndex参数进行验证,若该参数值为非数值类型,则会显示invalidPageErrMsg错误信息,若该参数值超出总页数或小于1,则会显示outOfRangeErrMsg错误信息。

示例:


跳转到第