Laravel如何自定义分页视图？（Pagination示例）-Laravel-PHP中文网

Laravel如何自定义分页视图？（Pagination示例）

裘德小鎮的故事

发布： 2025-12-12 12:17:15

原创

948人浏览过

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

laravel如何自定义分页视图？（pagination示例）

在 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：

NNiji·Journey

二次元风格绘画生成器，由 Spellbrush 与 Midjourney 共同设计开发

查看详情

<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')}}

全局设置默认分页视图（可选）

在 App\Providers\AppServiceProvider@boot() 中添加：

use Illuminate\Pagination\Paginator;

Paginator::defaultView('pagination.simple');
// 或针对特定引擎（如 Bootstrap 5）
Paginator::defaultSimpleView('pagination.simple');

登录后复制

这样所有 $data->links() 都会自动使用该视图，无需每次手动指定。

基本上就这些。改样式靠 HTML/CSS，改逻辑靠 Blade 判断，关键在于理解 $paginator 提供的 API 和渲染流程。

以上就是Laravel如何自定义分页视图？（Pagination示例）的详细内容，更多请关注php中文网其它相关文章！