副队长BootStrap5探究(17)--分页 Pagination

点此查看 所有教程、项目、源码导航

文章目录

  • [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. 小结

  1. 外层推荐用 <nav> 包裹,添加 aria-label,提升无障碍可读性。
  2. 结构固定:ul.pagination > li.page-item > a.page-link。
  3. active 标记当前页码,disabled 用来标记不可点击项。
  4. 尺寸修饰类:pagination-lg、pagination-sm。
  5. 对齐靠 flex 工具类 justify-content-center、justify-content-end。
  6. Bootstrap 分页只负责样式,跳转逻辑需要自己写 JS 或者后端配合。
相关推荐
简 洁 冬冬2 天前
分页「向上取整」公式 `(total + size - 1) / size` 的完整推导
java·分页
程序员大阳5 天前
副队长BootStrap5探究(8)--输入框组 input group
源码分析·bootstrap5·输入框组·input group
程序员大阳5 天前
副队长BootStrap5探究(10)--复选框 check
源码分析·复选框·bootstrap5·check
程序员大阳6 天前
副队长BootStrap5探究(5)--图片 Image
源码分析·image·图片·bootstrap5
FungLeo6 天前
成为全栈·Vue 管理后台篇·分页只显示第一页:从接口total 定位到前端修复
前端·vue.js·状态模式·分页·naive ui·服务端分页·前端问题排查
程序员大阳6 天前
副队长BootStrap5探究(7)--表单输入框 form control
text·textarea·bootstrap5·表单输入框·form control·form label
程序员大阳6 天前
副队长BootStrap5探究(3)--彩色链接 Colored link
源码·bootstrap5·彩色链接·colored link
程序员大阳6 天前
副队长BootStrap5探究(6)--画像 Figure (图文组合组件)
源码分析·figure·图文混排·bootstrap5·画像·图文组合
程序员大阳8 天前
副队长BootStrap5教程(1)--序言
教程·背景·bootstrap5·序言