ホームページ >ウェブフロントエンド >jsチュートリアル >jqueryページネーションプラグインの使い方
今回は、jquery ページング プラグインの使い方と、jquery ページング プラグインの使用方法に関する注意点についてお届けします。ここでは実際のケースを見てみましょう。
jqPaginator は、さまざまなアプリケーション シナリオに適した、シンプルで高度にカスタマイズされた jQuery ページネーション コンポーネントです。
インターネット上にはさまざまな種類のページング コンポーネントがありますが、非常に「満足のいく」ものを見つけるのは難しいため、jqPaginator が誕生しました。
私の考える理想的なページング コンポーネントは、CSS フレームワークに制限されず、さまざまなスタイルの Web ページで使用できるべきです。私の単純な経験から言えば、この目標を達成するには、高度にカスタマイズされた Html 構造が重要なポイントとなります。そこで、jqPaginator はさまざまなシーンに柔軟に対応できるよう、無理のない範囲でのカスタマイズを心がけています。
効果のスクリーンショット:
使用方法は非常に簡単です。最初にjQueryとjqPaginatorを導入し、次にページングを初期化できます
$('#id').jqPaginator({ totalPages: 100, visiblePages: 10, currentPage: 1, first: '<li class="first"><a href="javascript:void(0);">First</a></li>', prev: '<li class="prev"><a href="javascript:void(0);">Previous</a></li>', next: '<li class="next"><a href="javascript:void(0);">Next</a></li>', last: '<li class="last"><a href="javascript:void(0);">Last</a></li>', page: '<li class="page"><a href="javascript:void(0);">{{page}}</a></li>', onPageChange: function (num) { $('#text').html('当前第' + num + '页'); }});
上記の例は最初のデモ、Bootstrapですスタイルのページング。特定のパラメータについては後ほど説明します。ここで理解する必要があるのは、id の代わりに class を使用すると、クラスのすべての要素が初期化されて、上記の「2 ページングのリンク」効果が実現されるということです。
パラメータ | デフォルト値 | 説明 |
---|---|---|
totalPages | 0 | ページングの総ページ数を設定します |
totalCounts | 0 | 合計数を設定しますページングのエントリ数 |
pageSize | 0 | 各ページのエントリ数を設定します 注: totalPages または totalCounts + pageSize を設定します。そうでない場合は、totalCounts と pageSize を設定した後、totalPages が自動的に報告されます。計算された。 |
currentPage | 1 | 現在のページ番号を設定します |
visiblePages | 7 | 表示されるページの最大数を設定します(たとえば、100がある場合、現在のページ1が現在のページです) 1の場合、1ページから7ページが表示されます) |
disableClass | 'disabled' | ホームページ、前ページ、次ページ、最後のページの「無効状態」スタイルを設定します |
activeClass | 'active' | 現在のページ番号のスタイルを設定します |
first | (なし) | 「ホームページ」のHTML構造を設定します |
prev | (なし) | 「」のHTML構造を設定します前ページ「 |
次 | (なし) | 「下」を設定「1ページ」のHTML構造 |
last | (なし) | 「最後のページ」のHTML構造を設定 |
page | (none) | ページ番号の HTML 構造を設定します。ここで使用できるのは、{{page }} は現在のページを表し、{{totalPages}} は総ページ数を表します。{{totalCounts} } はエントリの総数を表します (例: 上記の「ミニマリスト スタイル」デモでは {{placeholder}} を使用し、visiblePages を 1 に設定することで実装されています。) |
wrapper | (none) | ページング用の HTML ラッパー構造体、例: 、通常は使用されません |
onPageChange | (none) | コールバック関数 に移動します。ページが変更されると(最初のページの初期化時を含む)、「対象ページ」のページ番号が渡されます |
jqPaginator提供了两个扩展方法,方便初始化后对组件进行操作。
$('#id').jqPaginator('option', options)
初始化后,动态修改配置
$('#id').jqPaginator('option', { currentPage: 1});
$('#id').jqPaginator('destroy')
销毁jqPaginator
$('#id').jqPaginator('destroy');
源码下载:https://github.com/keenwon/jqPaginator
官方地址:http://jqpaginator.keenwon.com/
推荐解决方案(结合后台):
首页通过一个具体后台查询跳转过来,带上总页数等数据,方便初始化分页导航条,并在table中显示第一页数据。
后续点击每一页按钮都发出ajax请求,并将该页数据作为json返回,填充到table中,这样做的好处是,不用每一次都查询总条数,只需要查询当前页面数据即可,速度快,减少数据库负担。具体代码如下,仅供参考:
<script type="text/javascript">$(function(){ $('#page').jqPaginator({ //totalPages: 100, pageSize:2,//每一页多少条记录 totalCounts:${totalCount}, visiblePages: 10, currentPage: 1, first: '<li class="first"><a href="javascript:void(0);">First</a></li>', prev: '<li class="prev"><a href="javascript:void(0);">Previous</a></li>', next: '<li class="next"><a href="javascript:void(0);">Next</a></li>', last: '<li class="last"><a href="javascript:void(0);">Last</a></li>', page: '<li class="page"><a href="javascript:void(0);">{{page}}</a></li>', onPageChange: function (num) { // alert('当前第' + num + '页'); //此处可以ajax加载下一页数据 $.get('ajaxpage',{num:num},function(data){ $("#tab").html('<tr><th>书籍Id</th><th>书名</th><th>价格</th><th>操作</th></tr>'); for(var i=0;i<data.length;i++){ $("#tab").append('<tr><td>'+data[i].id+'</td><Td>'+data[i].bookName+'</Td><td>'+data[i].bookPrice+'</td>'+ '<td><a href="/test_maven/updateBook?id=${book.id }">修改</a> <a href="#">删除</a></td> </tr>'); } },'json') } }); })</script><title>Insert title here</title></head><body><h1>所有书籍</h1><table id="tab"> <tr><th>书籍Id</th><th>书名</th><th>价格</th><th>操作</th></tr> <c:forEach items="${books }" var="book"> <tr><td>${book.id }</td><Td>${book.bookName }</Td><td>${book.bookPrice }</td> <td><a href="/test_maven/updateBook?id=${book.id }">修改</a> <a href="#">删除</a></td> </tr> </c:forEach></table>
本文将为大家介绍一款非常赞的jQuery分页插件:jqPaginator。
jqPaginator简洁、高度自定义的jQuery分页组件,适用于多种应用场景。
现在网上各种各样的分页组件很多,但是很难找到十分”称心如意”的,于是jqPaginator诞生了。
我心中理想的分页组件,要不受CSS框架限制,可以使用在各种不同风格中的网页中。以我浅显的经验来看,要达到这个目标,关键的一点就是高度自定义的Html结构。所以jqPaginator努力做到合理范围内的自定义,使其灵活的使用了各种不同的场景。
效果截图:
用法很简单,首先引入jQuery和jqPaginator,之后就可以初始化分页了
$('#id').jqPaginator({ totalPages: 100, visiblePages: 10, currentPage: 1, first: '<li class="first"><a href="javascript:void(0);">First</a></li>', prev: '<li class="prev"><a href="javascript:void(0);">Previous</a></li>', next: '<li class="next"><a href="javascript:void(0);">Next</a></li>', last: '<li class="last"><a href="javascript:void(0);">Last</a></li>', page: '<li class="page"><a href="javascript:void(0);">{{page}}</a></li>', onPageChange: function (num) { $('#text').html('当前第' + num + '页'); }});
上例就是第一Demo,Bootstrap风格的分页。具体参数稍后介绍,这里要了解的是,如果使用的不是id,而是class,就会初始化该class的所有元素,实现上面”两个分页联动”的效果。
参数 | 默认值 | 说明 |
---|---|---|
totalPages | 0 | 设置分页的总页数 |
totalCounts | 0 | 设置分页的总条目数 |
pageSize | 0 | 设置每一页的条目数 注意:要么设置totalPages,要么设置totalCounts + pageSize,否则报错;设置了totalCounts和pageSize后,会自动计算出totalPages。 |
currentPage | 1 | 设置当前的页码 |
visiblePages | 7 | 设置最多显示的页码数(例如有100也,当前第1页,则显示1 - 7页) |
disableClass | ‘disabled’ | 设置首页,上一页,下一页,末页的”禁用状态”样式 |
activeClass | ‘active’ | 设置当前页码样式 |
first | (无) | 设置”首页”的Html结构 |
prev | (无) | 设置”上一页”的Html结构 |
next | (无) | 设置”下一页”的Html结构 |
last | (无) | 设置”末页”的Html结构 |
page | (无) | 设置页码的Html结构,其中可以使用{{page}}代表当前页,{{totalPages}}代表总页数,{{totalCounts}}代表总条目数(例如:上面的”极简风格”的Demo,就是使用了{{占位符}},并将visiblePages设为1实现的。) |
wrapper | (无) | 分页结构的Html包裹,例如:,一般不会用到 |
onPageChange | (无) | 回调函数,当换页时触发(包括初始化第一页的时候),会传入”目标页”的页码 |
jqPaginator提供了两个扩展方法,方便初始化后对组件进行操作。
$('#id').jqPaginator('option', options)
初始化后,动态修改配置
$('#id').jqPaginator('option', { currentPage: 1});
$('#id').jqPaginator('destroy')
销毁jqPaginator
$('#id').jqPaginator('destroy');
源码下载:https://github.com/keenwon/jqPaginator
官方地址:http://jqpaginator.keenwon.com/
推荐解决方案(结合后台):
首页通过一个具体后台查询跳转过来,带上总页数等数据,方便初始化分页导航条,并在table中显示第一页数据。
后续点击每一页按钮都发出ajax请求,并将该页数据作为json返回,填充到table中,这样做的好处是,不用每一次都查询总条数,只需要查询当前页面数据即可,速度快,减少数据库负担。具体代码如下,仅供参考:
<script type="text/javascript">$(function(){ $('#page').jqPaginator({ //totalPages: 100, pageSize:2,//每一页多少条记录 totalCounts:${totalCount}, visiblePages: 10, currentPage: 1, first: '<li class="first"><a href="javascript:void(0);">First</a></li>', prev: '<li class="prev"><a href="javascript:void(0);">Previous</a></li>', next: '<li class="next"><a href="javascript:void(0);">Next</a></li>', last: '<li class="last"><a href="javascript:void(0);">Last</a></li>', page: '<li class="page"><a href="javascript:void(0);">{{page}}</a></li>', onPageChange: function (num) { // alert('当前第' + num + '页'); //此处可以ajax加载下一页数据 $.get('ajaxpage',{num:num},function(data){ $("#tab").html('<tr><th>书籍Id</th><th>书名</th><th>价格</th><th>操作</th></tr>'); for(var i=0;i<data.length;i++){ $("#tab").append('<tr><td>'+data[i].id+'</td><Td>'+data[i].bookName+'</Td><td>'+data[i].bookPrice+'</td>'+ '<td><a href="/test_maven/updateBook?id=${book.id }">修改</a> <a href="#">删除</a></td> </tr>'); } },'json') } }); })</script><title>Insert title here</title></head><body><h1>所有书籍</h1><table id="tab"> <tr><th>书籍Id</th><th>书名</th><th>价格</th><th>操作</th></tr> <c:forEach items="${books }" var="book"> <tr><td>${book.id }</td><Td>${book.bookName }</Td><td>${book.bookPrice }</td> <td><a href="/test_maven/updateBook?id=${book.id }">修改</a> <a href="#">删除</a></td> </tr> </c:forEach></table>
相信看了本文案例你已经掌握了方法,更多精彩请关注php中文网其它相关文章!
推荐阅读:
以上がjqueryページネーションプラグインの使い方の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。