点此查看 所有教程、项目、源码导航
文章目录
- [1. 开篇介绍与环境引入](#1. 开篇介绍与环境引入)
- [2. 使用方法](#2. 使用方法)
-
- [2.1 基础分页](#2.1 基础分页)
- [2.2 激活状态 active](#2.2 激活状态 active)
- [2.3 禁用状态 disabled](#2.3 禁用状态 disabled)
- [2.4 分页尺寸 pagination-lg / pagination-sm](#2.4 分页尺寸 pagination-lg / pagination-sm)
- [2.5 分页对齐](#2.5 分页对齐)
- [3. 底层实现关键点解析](#3. 底层实现关键点解析)
- [4. 小结](#4. 小结)
1. 开篇介绍与环境引入
分页组件用来做多页数据导航,给用户提供上一页、页码、下一页跳转入口,Bootstrap 5 内置分页样式,支持对齐、尺寸、禁用、激活状态。
先引入BootStrap相关的环境:
html
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title></title>
<!-- Bootstrap 5 CSS -->
<link rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.3.8/css/bootstrap.min.css">
</head>
<body>
<!-- Bootstrap JS + Popper,用于部分交互 -->
<script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.3.8/js/bootstrap.bundle.min.js"></script>
</body>
</html>
2. 使用方法
2.1 基础分页
根容器添加 pagination,内部用 page-item 包裹 page-link。
html
<nav aria-label="Page navigation">
<ul class="pagination">
<li class="page-item"><a class="page-link" href="#">上一页</a></li>
<li class="page-item"><a class="page-link" href="#">1</a></li>
<li class="page-item"><a class="page-link" href="#">2</a></li>
<li class="page-item"><a class="page-link" href="#">3</a></li>
<li class="page-item"><a class="page-link" href="#">下一页</a></li>
</ul>
</nav>
效果:

2.2 激活状态 active
标记当前所在页码。
html
<nav aria-label="Page navigation">
<ul class="pagination">
<li class="page-item"><a class="page-link" href="#">上一页</a></li>
<li class="page-item"><a class="page-link" href="#">1</a></li>
<li class="page-item active"><a class="page-link" href="#">2</a></li>
<li class="page-item"><a class="page-link" href="#">3</a></li>
<li class="page-item"><a class="page-link" href="#">下一页</a></li>
</ul>
</nav>
效果:

2.3 禁用状态 disabled
不可点击的页码,比如首页的上一页。
html
<nav aria-label="Page navigation">
<ul class="pagination">
<li class="page-item disabled"><a class="page-link" href="#" tabindex="-1">上一页</a></li>
<li class="page-item"><a class="page-link" href="#">1</a></li>
<li class="page-item active"><a class="page-link" href="#">2</a></li>
<li class="page-item"><a class="page-link" href="#">3</a></li>
<li class="page-item"><a class="page-link" href="#">下一页</a></li>
</ul>
</nav>
效果:

2.4 分页尺寸 pagination-lg / pagination-sm
放大或者缩小分页按钮。
html
<!-- 大号 -->
<nav aria-label="Page navigation">
<ul class="pagination pagination-lg">
<li class="page-item"><a class="page-link" href="#">1</a></li>
<li class="page-item active"><a class="page-link" href="#">2</a></li>
<li class="page-item"><a class="page-link" href="#">3</a></li>
</ul>
</nav>
<!-- 默认 -->
<nav aria-label="Page navigation">
<ul class="pagination">
<li class="page-item"><a class="page-link" href="#">1</a></li>
<li class="page-item active"><a class="page-link" href="#">2</a></li>
<li class="page-item"><a class="page-link" href="#">3</a></li>
</ul>
</nav>
<!-- 小号 -->
<nav aria-label="Page navigation">
<ul class="pagination pagination-sm">
<li class="page-item"><a class="page-link" href="#">1</a></li>
<li class="page-item active"><a class="page-link" href="#">2</a></li>
<li class="page-item"><a class="page-link" href="#">3</a></li>
</ul>
</nav>
效果:

2.5 分页对齐
配合 flex 工具类实现居中、靠右。
html
<!-- 默认 -->
<nav aria-label="Page navigation">
<ul class="pagination">
<li class="page-item"><a class="page-link" href="#">上一页</a></li>
<li class="page-item active"><a class="page-link" href="#">1</a></li>
<li class="page-item"><a class="page-link" href="#">下一页</a></li>
</ul>
</nav>
<!-- 居中 -->
<nav aria-label="Page navigation">
<ul class="pagination justify-content-center">
<li class="page-item"><a class="page-link" href="#">上一页</a></li>
<li class="page-item active"><a class="page-link" href="#">1</a></li>
<li class="page-item"><a class="page-link" href="#">下一页</a></li>
</ul>
</nav>
<!-- 靠右 -->
<nav aria-label="Page navigation">
<ul class="pagination justify-content-end">
<li class="page-item"><a class="page-link" href="#">上一页</a></li>
<li class="page-item active"><a class="page-link" href="#">1</a></li>
<li class="page-item"><a class="page-link" href="#">下一页</a></li>
</ul>
</nav>

3. 底层实现关键点解析
下面是精简复刻版本,去掉大量浏览器兼容代码,只保留核心逻辑。
使用上面的HTML代码,加下面自己写的CSS,能得到基本类似的效果,大家可以尝试下。
css
.pagination {
/* 取消ul默认列表样式 */
padding-left: 0;
list-style: none;
/* 横向排列分页项 */
display: flex;
}
.page-link {
/* 分页按钮基础样式 */
position: relative;
display: block;
padding: 0.5rem 0.75rem;
color: #0d6efd;
text-decoration: none;
/* 边框 */
border: 1px solid #dee2e6;
/* 第一个和最后一个圆角单独控制 */
}
.page-item:first-child .page-link {
border-top-left-radius: 0.375rem;
border-bottom-left-radius: 0.375rem;
}
.page-item:last-child .page-link {
border-top-right-radius: 0.375rem;
border-bottom-right-radius: 0.375rem;
}
.page-link:hover {
/* hover背景变色 */
background-color: #e9ecef;
border-color: #dee2e6;
}
.page-item.active .page-link {
/* 当前激活页:蓝底白字 */
color: #fff;
background-color: #0d6efd;
border-color: #0d6efd;
}
.page-item.disabled .page-link {
/* 禁用状态:灰色,禁止点击感 */
color: #6c757d;
pointer-events: none;
background-color: #fff;
border-color: #dee2e6;
}
.pagination-lg .page-link {
/* 大号分页,放大内边距和字号 */
padding: 0.75rem 1rem;
font-size: 1.25rem;
}
.pagination-sm .page-link {
/* 小号分页,缩小内边距和字号 */
padding: 0.25rem 0.5rem;
font-size: 0.875rem;
}
效果:

4. 小结
- 外层推荐用
<nav>包裹,添加aria-label,提升无障碍可读性。 - 结构固定:
ul.pagination>li.page-item>a.page-link。 active标记当前页码,disabled用来标记不可点击项。- 尺寸修饰类:
pagination-lg、pagination-sm。 - 对齐靠 flex 工具类
justify-content-center、justify-content-end。 - Bootstrap 分页只负责样式,跳转逻辑需要自己写 JS 或者后端配合。