PHPackages windwork/pager - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. windwork/pager ActiveLibrary[Utility & Helpers](/categories/utility) windwork/pager ============== windwork pager components,Windwork 分页组件 0.5.0(9y ago)0711MITPHPPHP >=5.5.0 Since May 11Pushed 8y agoCompare [ Source](https://github.com/windwork/wf-pager)[ Packagist](https://packagist.org/packages/windwork/pager)[ RSS](/packages/windwork-pager/feed)WikiDiscussions master Synced 3w ago READMEChangelog (3)DependenciesVersions (3)Used By (1) windwork 分页组件 ============= [](#windwork-分页组件) 通过设置总记录数和每页显示记录数，计算出分页导航参数并可生成分页导航html。 我们提供了3种不同的分页显示模板，如果不能满足你的需要，可自己编写分页模板。 安装 -- [](#安装) 该组件已包含在Windwork框架中，如果你已安装Windwork框架则可以直接使用。 - 安装方式一：通过composer安装（推荐） ``` composer require windwork/wf ``` - 安装方式二：传统方式安装 [下载源码](https://github.com/windwork/wf/releases)后，解压源码到项目文件夹中，然后require\_once $PATH\_TO\_WF/core/lib/Loader.php文件，即可自动加载组件中的类。 使用案例 ---- [](#使用案例) ``` // $userObj = new \app\user\model\UserModel(); // $total = $userObj->find()->count(); // 总用户数 $total = 125; // 总共记录数 $rows = 20; // 每页显示记录数 $pager = new \wf\pager\Pager($total, 12); // 在Windwork控制器中使用 $pager = pager($total, $rows); // 让sql知道从第几行获取数据，获取多少行 // $userObj->find()->fetchAll($pager->offset, $pager->rows); // 显示分页导航条 echo $pager->getHtml(); ``` 分页条显示风格 ------- [](#分页条显示风格) 可以选择使用不同风格显示导航条 - simple 默认简介风格导航 - mobile 使用于手机界面的导航 - complex 复杂导航，一般用在管理后台 ### 方式1、在构造函数中指定模板风格 [](#方式1在构造函数中指定模板风格) ``` // 导航选择使用模板 $tpl = 'simple'; // simple|mobile|complex $pager = new \wf\pager\Pager($total, 12, '', ['tpl' => $tpl]); $pager->getHtml() ``` ### 方式2、在模板中选择主题风格 [](#方式2在模板中选择主题风格) 当我们视图手机版和电脑版分开的时候，可以在视图中直接调用不同风格的分页导航条以适应不同的客户端。 ``` // 控制器中 $pager = new \wf\pager\Pager($total, 10); // PC版视图中使用默认分页导航条 {$pager->getHtml('complex')} // 手机版视图中使用手机分页导航条 {$pager->getHtml('mobile')} ``` 分页样式案例 ------ [](#分页样式案例) ``` .pagination { margin: 20px auto; padding: 0; height: 36px; font-size: 14px; } .pagination li { display: inline; } .pagination li a { display: inline; float: left; line-height: 36px; margin-left: -1px; padding: 0 12px; border: 1px solid #e0e0e0; position: relative; text-decoration: none; } .pagination li a:hover { background: #f8f8f8; } .pagination li.current a {background: #f8f8f8;} .pagination li a span { color:#2a6496; } .pagination li.current a span {color: #000; font-weight: bold; } .pagination li.paging-select { line-height: 36px; float: right; color:#999; } .pagination li.paging-select span { font-size: 12px; } .pagination li.paging-select select { border: 1px solid #e0e0e0; height: 28px; padding: 0 3px; } .pagination.mobile { font-size: 0; text-align: center; } .pagination.mobile li { display: inline-block; } .pagination.mobile li a span { font-size: 14px; } ``` 高级功能 ---- [](#高级功能) ### 1、自定义分页参数 [](#1自定义分页参数) 可配置参数： ``` $args = [ 'argSeparator' => '&', // 参数分隔符号 'valSeparator' => '=', // 参数变量名和值的分隔符 'pageVar' => 'page', // 分页页码的url请求变量名 'rowsVar' => 'rows', // 每页行数的url请求变量名 'rows_max' => 100, // 每页允许最多记录数 'tpl' => 'simple', // 默认分页样式，mobile）手机分页, simple）简单分页, complex）复杂分页 ]; ``` ``` $pager = new Pager(200, 10); $pager->uri = 'http://localhost/demo/xx'; // 得到默认格式的分页链接 // http://localhost/demo/xx?rows=10&page=2 $url = $pager->getPageUrl(2); // 通过设置参数获得自定义的分页变量分隔符 $args = [ 'argSeparator' => '/', // 参数分隔符号 'valSeparator' => ':', // 变量和值的分隔符 ]; $pager = new Pager(200, 10, '', $args); $pager->uri = 'http://localhost/demo/xx'; // 得到个性化格式的分页链接： // http://localhost/demo/xx/rows:10/page:2 $url = $pager->getPageUrl(2); ``` ### 要了解更多？ [](#要了解更多) > - [官方完整文档首页](http://docs.windwork.org/manual/) > - [官方源码首页](https://github.com/windwork) ### Health Score 23 — LowBetter than 26% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community8 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~43 days Total 2 Last Release 3288d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/24246959?v=4)[Windwork](/maintainers/windwork)[@windwork](https://github.com/windwork) --- Top Contributors [![cmpan](https://avatars.githubusercontent.com/u/399927?v=4)](https://github.com/cmpan "cmpan (18 commits)") --- Tags pagerpaginationpagerpaginationpaging ### Embed Badge ![Health badge](/badges/windwork-pager/health.svg) ``` [![Health](https://phpackages.com/badges/windwork-pager/health.svg)](https://phpackages.com/packages/windwork-pager) ``` ### Alternatives [jasongrimes/paginator A lightweight PHP paginator, for generating pagination controls in the style of Stack Overflow and Flickr. The 'first' and 'last' page links are shown inline as page numbers, and excess page numbers are replaced by ellipses. 3741.3M21](/packages/jasongrimes-paginator)[aplus/pagination Aplus Framework Pagination Library 2111.6M3](/packages/aplus-pagination)[kop/yii2-scroll-pager Infinite AJAX scrolling for Yii2 ListView widget 178724.3k10](/packages/kop-yii2-scroll-pager)[beberlei/porpaginas Library that generically solves several pagination issues with DAO/repository abstractions. 163632.5k13](/packages/beberlei-porpaginas)[stefangabos/zebra_pagination A generic, Twitter Bootstrap compatible, PHP pagination library that automatically generates navigation links 11923.6k](/packages/stefangabos-zebra-pagination)[ashleydawson/simple-pagination Simple, lightweight and universal service that implements pagination on collections of things 18162.2k2](/packages/ashleydawson-simple-pagination) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)