直接改 --bs-pagination-bg 无效,因当前页高亮由 .page-item.active .page-link 的 background-color 决定;需同时覆盖 background-color、border-color、color 和 box-shadow,并为 .disabled 和 :hover 状态单独声明样式,且 .active 必须加在 .page-item 上而非 .page-link。

为什么直接改 --bs-pagination-bg 没用
因为 --bs-pagination-bg 只控制 .pagination 容器背景,而当前页高亮实际由 .page-item.active .page-link 的 background-color 决定。Bootstrap 5 中 .page-link 默认背景是硬编码的 var(--bs-white),完全不读这个变量。你在 :root 里改它,对页码按钮零影响。
.page-item.active .page-link 必须显式覆盖的四项
只写 background-color 会出视觉断裂:悬停时回退默认色、焦点环突兀、文字看不清、禁用态错乱。必须一并处理:
-
background-color:比如#0d47a1 -
border-color:不能留默认灰边,否则和新背景不协调 -
color:深色背景配浅色字,漏掉就变白字压黑底 -
box-shadow(替代outline):建议用box-shadow: 0 0 0 0.2rem rgba(13, 71, 161, 0.25),兼顾键盘可访问性
别漏掉 .disabled 和 :hover 状态
分页首/末页常为 .disabled,若不单独声明,它们在深色主题下会继承默认浅灰背景+深灰文字,几乎不可读。同样,:hover 若没同步调色,鼠标移过去会突然变回 Bootstrap 原色,交互感断裂。
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
- 必须加:
.my-pagination .page-item.disabled .page-link - 建议合并写:
.my-pagination .page-link:hover, .my-pagination .page-link:focus - 所有规则都应以自定义容器开头(如
.my-pagination),避免污染bootstrap-table等第三方分页
HTML 结构错位会导致样式完全失效
Bootstrap 5 要求 .active 类必须加在 <li class="page-item active"> 上,不是加在 <a class="page-link"></a> 上。写成 <li class="page-item"><a class="page-link active"></a></li> 是无效的——CSS 选择器 .page-item.active .page-link 根本匹配不到。
立即学习“前端免费学习笔记(深入)”;
另外,.page-item 是 display: inline-flex,别用 mx-1 或 px-2 类调间距,它们对实际项间空隙基本没用;该用 --bs-pagination-margin-x(v5.3+)或 .page-item:not(:last-child) 微调。

















