轻松实现分页：thinkphp使用自定义样式【UI美化】

从 ThinkPHP 6.x 开始，分页的渲染逻辑已经变了。必须用 render() 方法显式指定一个自定义模板路径，否则无论你怎么折腾配置文件，它都会使用默认模板。这里面有几个关键点：

• 分页对象必须调用 $list->render()，而不是直接 echo $list——后者会完全忽略你指定的模板。
• 模板文件的路径要写清楚，比如 'paginators/bootstrap5'，那它在视图目录下的真实位置就是 view/paginators/bootstrap5.html。
• 模板内部能用的变量都有哪些？$page（当前页码）、$total（总记录数）、$lastPage（总页数）、$hasPrev / $hasNext 这些布尔值，都直接可用。
• 千万别在模板里写 PHP 逻辑。生成链接用 ThinkPHP 的模板语法就够了，比如 {:url('index', ['page' => $i])}。

如何让分页链接带查询参数（比如搜索关键词）？

这是另一个高频问题。默认情况下，分页生成的链接只保留 page 参数，其他像 ?keyword=abc&type=1 这些全都会被丢掉。用户翻页后，搜索条件就失效了。这可不是 bug，框架就是那么设计的——它需要你手动告诉它“把哪些参数带上”。

最稳妥的做法是在控制器里构造分页时，传入一个 query 选项：

request->param('keyword', '');
$type = $this->request->param('type', '');
$list = Db::name('article')
    ->where('title', 'like', "%{$keyword}%")
    ->where('type', $type)
    ->paginate([
        'query' => ['keyword' => $keyword, 'type' => $type],
        'page' => $this->request->param('page', 1),
    ]);
$this->assign('list', $list);
?>

• query 数组里的键值对，框架会自动拼接到每一页的 URL 里，你不需要手动去拼 url() 函数。
• 如果参数是一个数组（比如 category[]=1&category[]=2 这种），记得用 http_build_query() 提前处理，否则会被转成字符串。
• 有一个很容易踩的坑：别在模板里用 $Request.param() 动态获取参数，因为分页链接生成时，上下文已经切换了，很容易漏掉参数甚至报错。

自定义分页样式时 class 冲突怎么办？

你写了个 ，但 CSS 就是不起效。原因通常有两个：一是框架自带的 pagination class 权重比你高；二是你删掉了框架依赖的关键状态 class。

• ThinkPHP 的分页模板里，当前页会带上 class="active"，上一页/下一页不可用时是 class="disabled"。这两个 class 是框架渲染状态的基石，必须保留，否则很多基于状态的样式会完全失效。
• 尽量不要用 !important 去强行覆盖。更好的做法是使用更具体的选择器，比如 .my-pagination .active > a。
• 如果你用的是 Element Plus 之类的纯前端组件库，它的分页组件和 ThinkPHP 的服务端分页结构根本对不上，硬套是行不通的。要么老老实实改模板去适配，要么改用纯前端分页——这时候你就得上 limit + count 了，别再走 paginate。

为什么分页跳转后页面顶部没滚动到列表位置？

这个问题听起来像前端行为，但经常被误以为是“分页出错了”。点页码后浏览器默认跳到页面顶部，而你的列表可能在页面的中间或底部，所以视觉上就觉得“页面没动”。

说到最后，ThinkPHP 分页的麻烦，从来不是样式写起来多复杂。真正的坑在于：参数怎么透传、哪些 class 绝对不能删、滚动行为怎么自己补。这些细节要是不处理好，UI 做得再漂亮，用户点一下翻页，页面也卡在第一屏动不了。