Laravel 自定义分页视图需先执行 php artisan vendor:publish –tag=laravel-pagination 发布默认模板,再通过 $paginator->links(‘pagination.custom’) 指定视图或在 appServiceProvider 中设 Paginator::defaultView() 全局生效。

在 laravel 中自定义分页视图,核心是替换默认的 resources/views/vendor/pagination 下的 Blade 模板文件,或通过 links() 方法指定自定义视图名称。
复制默认分页视图到项目中
Laravel 的分页视图默认由框架提供,但允许你覆盖。只需运行以下命令,Laravel 会自动把默认分页模板发布到你的项目里:
php artisan vendor:publish –tag=laravel-pagination
执行后,会在 resources/views/vendor/pagination 目录下生成多个 Blade 文件(如 tailwind.blade.php、bootstrap-5.blade.php 等),你可以任选一个作为基础修改。
使用自定义视图名称渲染分页
在控制器或 Blade 模板中调用分页时,不直接用 $users->links(),而是传入视图路径:
-
{{$users->links('pagination.custom')}}→ 对应resources/views/pagination/custom.blade.php - 视图文件中可自由写 html + Blade 逻辑,例如用
@if($paginator->onFirstPage()) ... @endif控制上一页按钮是否禁用 - 常用变量:
$paginator(分页器实例)、$elements(页码数组)、$previousPageUrl、$nextPageUrl等
编写一个极简自定义分页模板
比如新建 resources/views/pagination/simple.blade.php:
<div class="pagination"> @if ($paginator->onFirstPage()) <span class="disabled">上一页</span> @else <a href="{{ $paginator->previousPageUrl() }}">上一页</a> @endif @foreach ($elements as $element) @if (is_string($element)) <span class="dots">{{ $element }}</span> @endif @if (is_array($element)) @foreach ($element as $page => $url) @if ($page == $paginator->currentPage()) <span class="current">{{ $page }}</span> @else <a href="{{ $url }}">{{ $page }}</a> @endif @endforeach @endif @endforeach @if ($paginator->hasMorePages()) <a href="{{ $paginator->nextPageUrl() }}">下一页</a> @else <span class="disabled">下一页</span> @endif </div>
然后在模板中调用:{{$users->links('pagination.simple')}}
全局设置默认分页视图(可选)
在 AppProvidersAppServiceProvider@boot() 中添加:
use IlluminatePaginationPaginator; Paginator::defaultView('pagination.simple'); // 或针对特定引擎(如 Bootstrap 5) Paginator::defaultSimpleView('pagination.simple');
这样所有 $data->links() 都会自动使用该视图,无需每次手动指定。
基本上就这些。改样式靠 HTML/css,改逻辑靠 Blade 判断,关键在于理解 $paginator 提供的 API 和渲染流程。
以上就是Laravel如何自定义分页视图?(Pagination示例)的详细内容,更多请关注php中文网其它相关文章!