首页 > 文章 > php教程

ThinkPHP分页器使用教程与样式修改

时间：2025-10-24 08:01:44 384浏览收藏

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《ThinkPHP分页器使用与样式自定义》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

ThinkPHP通过Paginator类实现分页，使用paginate方法处理查询结果并支持自定义参数如每页数量、当前页码和URL参数，示例中User模型按状态筛选后分页输出；可通过配置文件或继承Paginator类自定义分页样式，结合CSS框架美化外观，需注意query参数传递以保留搜索条件。

ThinkPHP框架怎么实现分页功能_ThinkPHP分页器配置与样式自定义

ThinkPHP 是一个广泛使用的 PHP 开发框架，内置了强大的分页功能，能快速实现数据的分页展示。在实际开发中，只需要正确调用分页类并结合查询结果即可完成分页输出。同时，ThinkPHP 允许开发者自定义分页样式，以满足前端设计需求。

启用分页功能的基本步骤

在 ThinkPHP 中（以 ThinkPHP 6 为例），分页功能主要通过 Paginator 类实现。使用 paginate 方法可以直接对数据库查询结果进行分页处理。

示例如下：

// 控制器中
use app\model\User;

public function index()
{
    $list = User::where('status', 1)->paginate([
        'list_rows' => 10, // 每页显示数量
        'page'      => input('page', 1), // 当前页码
        'query'     => request()->param() // 保留URL参数
    ]);
    
    return view('index', ['users' => $list]);
}

上述代码会自动计算总页数、当前页数据，并生成分页导航链接。模板中通过 {$users|raw} 输出分页 HTML。

配置分页参数与自定义选项

ThinkPHP 的 paginate 方法支持多种配置项，可以灵活调整分页行为。

list_rows：每页显示记录数，默认为 15
page：当前页码，可从请求中获取
query：附加到分页链接的参数，如搜索条件
var_page：分页参数名，默认为 'page'
path：分页链接路径，可用于设置伪静态路径

例如：

User::paginate([
    'list_rows' => 8,
    'page'      => input('page'),
    'query'     => ['keyword' => 'thinkphp'],
    'path'      => '/user/list'
]);

自定义分页样式与模板

默认分页样式可能不符合项目 UI 风格，ThinkPHP 支持通过继承 Paginator 类或配置模板来自定义外观。

方式一：使用系统提供的简单方法修改外观

可在配置文件 config/paginator.php 中设置：

return [
    'type'     => 'bootstrap', // 可替换为自定义类
    'var_page' => 'page',
    'path'     => false,
    'fragment' => '',
];

方式二：完全自定义分页 HTML

创建自定义分页类，继承 \think\Paginator：

namespace app\pagination;

use think\Paginator;

class MyPage extends Paginator
{
    public function render()
    {
        if ($this->hasPages()) {
            $html = '';
            $html .= $this->previous('«');
            $html .= $this->getLinks();
            $html .= $this->next('»');
            $html .= '';
            
            return $html;
        }
        return '';
    }

    protected function getLinks()
    {
        $html = '';
        foreach ($this->getUrlRange(1, $this->lastPage()) as $page => $url) {
            $html .= $this->getPageLinkWrapper($url, $page);
        }
        return $html;
    }
}

然后在调用时指定使用该类：

User::paginate(10, false, ['page' => input('page'), 'type' => 'app\pagination\MyPage']);

前端样式整合建议

为了使分页更美观，可结合 CSS 框架如 Bootstrap 或 Element Plus 进行样式美化。

例如添加如下 CSS：

.custom-pagination {
    margin: 20px 0;
    text-align: center;
}
.custom-pagination a, .custom-pagination span {
    display: inline-block;
    padding: 5px 10px;
    margin: 0 3px;
    border: 1px solid #ddd;
    color: #007bff;
}
.custom-pagination .active {
    background: #007bff;
    color: white;
}

确保分页输出时保留必要的 class 名称，或在自定义类中加入 active 判断逻辑。

基本上就这些。ThinkPHP 的分页机制简洁高效，配合自定义类和样式，可以轻松实现符合项目需求的分页效果。不复杂但容易忽略的是 query 参数传递和路径配置，记得测试翻页时是否保留搜索条件。

到这里，我们也就讲完了《ThinkPHP分页器使用教程与样式修改》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于ThinkPHP,样式自定义,分页器,paginate方法,Paginator类的知识点！

ThinkPHP 样式自定义分页器 paginate方法 Paginator类