信息发布→ 登录 注册 退出

Laravel如何自定义分页视图?(Pagination示例)

发布时间:2025-12-12

点击量:
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.phpbootstrap-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

  @if ($paginator->onFirstPage())
    上一页
  @else
    previousPageUrl() }}">上一页
  @endif

  @foreach ($elements as $element)
    @if (is_string($element))
      {{ $element }}
    @endif

    @if (is_array($element))
      @foreach ($element as $page => $url)
        @if ($page == $paginator->currentPage())
          {{ $page }}
        @else
          {{ $page }}
        @endif
      @endforeach
    @endif
  @endforeach

  @if ($paginator->hasMorePages())
    nextPageUrl() }}">下一页
  @else
    下一页
  @endif

然后在模板中调用:{{$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 和渲染流程。

标签:# 分页  # 关键在于  # 可选  # 会在  # 只需  # 多个  # 你可以  # 下一页  # 上一页  # 自定义  # css  # if  # win  # ai  # app  # bootstrap  # html  # laravel  # php  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!