如何在Laravel中限制分页链接的显示数量并实现紧凑分页效果?
自定义Laravel分页的页码折叠展示
最快实现方式(无需改视图)
Laravel 8及以上版本自带了分页折叠能力,不用动模板代码就能实现省略号效果:
- 原来的控制器分页逻辑基础上,链式调用
onEachSide()方法,参数填当前页两侧需要露出的相邻页码数量。调用后系统会自动把间隔太大的页号替换成省略号,不会再把1到10的所有页号全量列出来。 - 按你要的首尾各留2个页号的效果,控制器代码直接改成:
$users = Users::paginate(5)->onEachSide(1);
改完之后的实际渲染效果:
- 站在第1页的时候,导航会输出
1 2 ... 9 10,和你要的初始样式完全一致 - 站在中间页(比如总10页的第5页),导航会输出
1 ... 4 5 6 ... 10,符合常规的分页交互逻辑 - 如果是Laravel 8以下的老版本,没有内置
onEachSide方法,直接参考后面的自定义视图方案即可。
自定义视图适配精准展示要求
如果内置的折叠逻辑和你预期的展示细节有出入(比如要求第5页时显示3 4 ... 5 ... 9 10的样式),可以手动改分页模板做精准控制:
- 先把系统内置的分页模板发布到本地项目根目录,执行命令:
php artisan vendor:publish --tag=laravel-pagination
- 打开发布生成的
resources/views/vendor/pagination目录,找到匹配你项目前端样式的模板文件(Tailwind写的找tailwind.blade.php,Bootstrap写的找对应版本的bootstrap-*.blade.php) - 调整模板里的页码渲染逻辑:
- 固定渲染最前面的2个页码、最后面的2个页码
- 中间区域只渲染当前页、以及当前页指定范围内的相邻页码
- 剩下的页码间隔统一用
...占位
- 保存模板后,Blade层还是正常输出
{{ $users->links() }}就行,不需要额外改代码。
内容的提问来源于stack exchange,提问作者atrix
相关产品推荐
相关产品推荐

