本文深入讲解如何纯手写一个带动态省略号折叠、快速数字跳转和完善边界校验的复杂原生JavaScript分页控件。从数学区间推导、DOM结构设计、事件委托机制到生产环境防御编程,提供完整可直接运行的实现方案。
手写带省略号和跳转功能的复杂JS分页控件
时间:2026-11-22
浏览:437
文章目录
一、需求分析与组件参数体系
在实际企业级后台系统或数据密集的门户网站中,当列表总数据量达到数千或数万条时,常规的平铺式页码会导致界面横向撑破甚至换行坍塌。因此,复杂分页控件必须满足以下硬性指标:
- 动态折叠折叠策略:当总页数超出最大可见限制(通常设为 7 或 9 页)时,当前页附近的邻近页码保持展开,其余远端页码折叠为省略号
...。 - 首尾锚点固定:第 1 页和最后一页始终保持在控件两端可见,方便用户迅速返回首页或查看数据末页。
- 快捷跳转与键盘响应:提供数字输入框,用户可以键入目标页码,通过点击“确定”按钮或直接在键盘上敲击
Enter键完成切页。 - 完善的数据校验与边界收敛:应对非法字符、小数、越界数字(如负数或大于总页数的数字)进行主动清洗与钳位,杜绝程序崩溃。
- 事件委托与单向数据流:视图只根据内部状态进行统一重绘,避免在每次页码更新时为子 DOM 节点频繁增删事件监听器。
为了保证组件在多业务场景下的通用性与易扩展性,我们将组件的核心配置项收敛为清晰的属性体系:
| 参数名 | 类型 | 默认值 | 职责说明 |
|---|---|---|---|
container |
HTMLElement | string | 必填 | 挂载分页控件的 DOM 容器节点或选择器 |
total |
number | 0 | 后端返回的数据总记录数 |
pageSize |
number | 10 | 每页展示的记录行数 |
currentPage |
number | 1 | 初始化时所处的当前激活页码(从 1 开始计) |
pagerCount |
number | 7 | 页码按钮展示的最大可见阈值(建议取奇数以实现对称折叠) |
onChange |
function | noop | 页码发生有效变更时的回调函数,入参为 (newPage, prevPage) |
二、核心数学模型:动态折叠算法与省略号位置推导
折叠算法是整个控件最具技巧性的部分。许多初学者容易在这里写出大量交织的 if-else 嵌套,导致在页码切换至临界点时出现跳动、省略号重叠或缺失按钮等 Bug。
我们设定页码按钮最大展示容量为 pagerCount = 7。当通过 Math.ceil(total / pageSize) 计算出的总页数 totalPages <= pagerCount 时,无需折叠,直接渲染出从 1 到 totalPages 的连续序列。
当 totalPages > pagerCount 时,我们需要引入两个核心布尔标志量:
showPrevMore:是否需要在左侧显示省略号。判定条件为:currentPage > 4。当当前页离首页较远时,左侧折叠。showNextMore:是否需要在右侧显示省略号。判定条件为:currentPage < totalPages - 3。当当前页离尾页较远时,右侧折叠。
由此,我们即可严谨地导出三种互斥的页码分布状态:
-
靠拢首页(左无右有):
!showPrevMore && showNextMore
当前页位于前列(例如 1、2、3、4),左侧保持连续平铺,右侧折叠。
生成的页码序列为:[1, 2, 3, 4, 5, '...', totalPages]。 -
靠拢尾页(左有右无):
showPrevMore && !showNextMore
当前页位于末尾部分(例如totalPages - 3到totalPages),左侧折叠,右侧连续平铺。
生成的页码序列为:[1, '...', totalPages - 4, totalPages - 3, totalPages - 2, totalPages - 1, totalPages]。 -
居中活跃(左右双折叠):
showPrevMore && showNextMore
当前页处于中间纵深区间,两侧均需要省略号进行空间折叠,中间形成对称的三页滑动窗口。
生成的页码序列为:[1, '...', currentPage - 1, currentPage, currentPage + 1, '...', totalPages]。
三、组件 DOM 结构设计与语义化样式规范
在 HTML 表现层,分页器应当保持纯净的语义化层级。我们将最外层定义为统一的容器 .pager-container,内部横向排列四大子模块:上一页按钮、页码有序列表、下一页按钮,以及右侧的快速跳转输入区。
为了赋予控件工业级的视觉反馈,我们需要为不同状态规划明确的 CSS 类名:
.pager-item:代表可点击的具体数字页码,鼠标悬浮时展示阴影,携带data-page属性以便事件代理识别。.pager-item.active:代表当前所处的激活页,背景采用工程蓝#345E82高亮显示,文字反白,同时设置cursor: default阻止无效重复点击。.pager-ellipsis:代表省略号占位符,文本设为居中灰字,不可点击。button:disabled:当处于第 1 页时,上一页按钮被置为禁用;当处于末页时,下一页按钮置为禁用。
四、完整原生 JavaScript 实现与事件委托机制
许多初学代码的常见错误是在 render() 函数中通过 querySelectorAll 找到所有新建的数字按钮,然后逐个执行 addEventListener('click', ...)。在用户连续切页的过程中,这种频繁的绑定与解绑不仅拖慢运行时响应,还极易引发闭包变量常驻内存导致泄漏。
优雅的解法是事件委托(Event Delegation)。我们只在分页器的最外层容器 container 上挂载唯一的 click 和 keyup 监听器。每当用户发生点击,浏览器事件会自然冒泡至容器,通过 e.target.closest('[data-action]') 或 e.target.dataset.page 提取出本次交互的意图,随后完成状态校验并驱动视图渲染。
以下为精心封装的完整组件核心逻辑:
class Pagination {
constructor(options = {}) {
// 1. 初始化并融合默认配置
this.options = Object.assign({
container: null,
total: 0,
pageSize: 10,
currentPage: 1,
pagerCount: 7,
onChange: () => {}
}, options);
// 解析挂载宿主
this.container = typeof this.options.container === 'string'
? document.querySelector(this.options.container)
: this.options.container;
if (!this.container) {
throw new Error('[Pagination] 未找到指定的挂载容器节点');
}
this.currentPage = Math.max(1, parseInt(this.options.currentPage, 10) || 1);
this.totalPages = this.calcTotalPages();
// 2. 初始化渲染与挂载根级委托事件
this.init();
}
// 计算总页数
calcTotalPages() {
const pages = Math.ceil(this.options.total / this.options.pageSize);
return Math.max(1, pages);
}
// 算法核心:推导页码及省略号数组
getDisplayPages() {
const total = this.totalPages;
const current = this.currentPage;
const count = this.options.pagerCount;
// 总页数小于阈值时全量展开
if (total <= count) {
return Array.from({ length: total }, (_, i) => i + 1);
}
// 折叠判定
const showPrevMore = current > 4;
const showNextMore = current < total - 3;
if (!showPrevMore && showNextMore) {
// 分支 A: 靠拢首页
return [1, 2, 3, 4, 5, '...', total];
} else if (showPrevMore && !showNextMore) {
// 分支 B: 靠拢尾页
return [1, '...', total - 4, total - 3, total - 2, total - 1, total];
} else {
// 分支 C: 居中双折叠
return [1, '...', current - 1, current, current + 1, '...', total];
}
}
// 初始化组件与单一事件委托挂载
init() {
this.render();
this.bindDelegatedEvents();
}
// 事件委托捕获机制
bindDelegatedEvents() {
// 委托点击事件
this.container.addEventListener('click', (e) => {
// 1. 检查上一页/下一页翻页动作
const actionBtn = e.target.closest('[data-action]');
if (actionBtn && !actionBtn.disabled) {
const action = actionBtn.dataset.action;
if (action === 'prev') this.goTo(this.currentPage - 1);
if (action === 'next') this.goTo(this.currentPage + 1);
return;
}
// 2. 检查数字页码点击
const pageItem = e.target.closest('[data-page]');
if (pageItem) {
const targetPage = parseInt(pageItem.dataset.page, 10);
if (!isNaN(targetPage)) {
this.goTo(targetPage);
}
return;
}
// 3. 检查跳转确定按钮
const jumpBtn = e.target.closest('[data-action="jump"]');
if (jumpBtn) {
this.handleJumpSubmit();
}
});
// 委托回车按键跳转
this.container.addEventListener('keyup', (e) => {
if (e.target.classList.contains('pager-jumper-input') && e.key === 'Enter') {
this.handleJumpSubmit();
}
});
}
// 提取输入框值并触发安全跳转
handleJumpSubmit() {
const input = this.container.querySelector('.pager-jumper-input');
if (!input) return;
const rawVal = input.value.trim();
if (!rawVal) return;
const parsed = parseInt(rawVal, 10);
if (isNaN(parsed)) {
input.value = this.currentPage;
return;
}
// 执行边界钳位跳转
this.goTo(parsed);
}
// 状态跃迁与防御校验核心
goTo(targetPage) {
// 边界钳位收敛
let validPage = parseInt(targetPage, 10);
if (isNaN(validPage)) return;
if (validPage < 1) validPage = 1;
if (validPage > this.totalPages) validPage = this.totalPages;
// 相同页码拦截,抑制冗余更新
if (validPage === this.currentPage) {
const input = this.container.querySelector('.pager-jumper-input');
if (input) input.value = validPage;
return;
}
const prevPage = this.currentPage;
this.currentPage = validPage;
// 重新渲染视觉界面
this.render();
// 派发业务层回调
if (typeof this.options.onChange === 'function') {
this.options.onChange(this.currentPage, prevPage);
}
}
// 重载/更新总条数
setTotal(newTotal) {
this.options.total = Math.max(0, parseInt(newTotal, 10) || 0);
this.totalPages = this.calcTotalPages();
if (this.currentPage > this.totalPages) {
this.currentPage = this.totalPages;
}
this.render();
}
// 界面模板字符串拼装与更新
render() {
const pages = this.getDisplayPages();
const isFirst = this.currentPage <= 1;
const isLast = this.currentPage >= this.totalPages;
let pagesHtml = '';
pages.forEach((p) => {
if (p === '...') {
pagesHtml += `<li class="pager-ellipsis">...</li>`;
} else {
const activeClass = p === this.currentPage ? ' active' : '';
pagesHtml += `<li class="pager-item${activeClass}" data-page="${p}">${p}</li>`;
}
});
const html = `
<div class="pager-wrapper">
<button class="pager-btn pager-prev" data-action="prev" ${isFirst ? 'disabled' : ''} title="上一页"><</button>
<ul class="pager-pages">
${pagesHtml}
</ul>
<button class="pager-btn pager-next" data-action="next" ${isLast ? 'disabled' : ''} title="下一页">></button>
<div class="pager-jumper">
<span class="pager-text">前往</span>
<input type="number" class="pager-jumper-input" min="1" max="${this.totalPages}" value="${this.currentPage}" />
<span class="pager-text">页</span>
<button type="button" class="pager-jumper-btn" data-action="jump">确定</button>
</div>
<span class="pager-info">共 ${this.options.total} 条 / ${this.totalPages} 页</span>
</div>
`;
this.container.innerHTML = html;
}
}
五、快速跳转模块与输入边界防御逻辑
输入跳转模块是用户与分页器进行直接自由文本交互的入口,也是最容易产生边界异常的区域。若不加以严格清洗,一旦用户输入非数字、负数甚至超大数字,极易导致分页器陷入无限循环或派发出错误的业务请求。
在设计防御机制时,我们遵循以下三道安全关卡:
-
输入字符过滤与取整清洗:使用
parseInt(val, 10)处理输入。对于带小数的输入(如"3.8"),通过parseInt向下截断为整型3;对于包含非法字符或纯空格的情况,计算出的结果将是NaN,此时立刻终止流程并将输入框重置回当前的this.currentPage。 -
数值边界钳位(Clamping):目标页码必须处于区间
[1, totalPages]之间。如果用户输入"-10"或"0",将其强制提升至第1页;如果用户输入"9999",将其向下收敛至末页this.totalPages。同时,将输入框的展示值同步更正为钳位后的真实值。 -
同一目标页熔断拦截:若清洗与钳位后的目标页码与控件当前激活的
this.currentPage完全相同,说明页面无需切换。此时控件立即返回,既不触发 DOM 的完全重绘,也不触发业务层网络请求,从而有效节约客户端计算与服务端带宽。
六、完整可运行代码与集成示例
以下提供一段完整独立的 HTML 演示范例。你可以将该代码保存为 .html 文件,在现代浏览器中直接双击打开运行。控件内置了配套的美化样式,并模拟了真实业务场景中数据总数改变时的动态更新。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>JS分页控件集成演示</title>
<style>
/* 分页控件专用样式 */
.pager-wrapper {
display: inline-flex;
align-items: center;
gap: 8px;
font-size: 14px;
color: #2D3748;
user-select: none;
padding: 12px 16px;
background: #FFFFFF;
border: 1px solid #CBD8E6;
border-radius: 6px;
}
.pager-pages {
display: inline-flex;
list-style: none;
padding: 0;
margin: 0;
gap: 6px;
}
.pager-btn, .pager-item {
min-width: 34px;
height: 34px;
padding: 0 6px;
display: inline-flex;
justify-content: center;
align-items: center;
background: #FFFFFF;
border: 1px solid #CBD8E6;
border-radius: 4px;
cursor: pointer;
color: #345E82;
font-weight: 500;
transition: all 0.2s ease;
}
.pager-btn:hover:not(:disabled), .pager-item:hover:not(.active) {
background-color: #F2F6FA;
border-color: #345E82;
}
.pager-item.active {
background-color: #345E82;
color: #FFFFFF;
border-color: #345E82;
cursor: default;
}
.pager-btn:disabled {
cursor: not-allowed;
color: #A0AEC0;
border-color: #E2E8F0;
background-color: #F7FAFC;
}
.pager-ellipsis {
min-width: 34px;
height: 34px;
display: inline-flex;
justify-content: center;
align-items: center;
color: #718096;
cursor: default;
}
.pager-jumper {
display: inline-flex;
align-items: center;
gap: 6px;
margin-left: 10px;
}
.pager-jumper-input {
width: 50px;
height: 34px;
text-align: center;
border: 1px solid #CBD8E6;
border-radius: 4px;
outline: none;
font-size: 14px;
color: #1A2F45;
}
.pager-jumper-input:focus {
border-color: #345E82;
}
.pager-jumper-btn {
height: 34px;
padding: 0 12px;
background-color: #AD8060;
color: #FFFFFF;
border: none;
border-radius: 4px;
cursor: pointer;
font-size: 13px;
font-weight: 500;
transition: opacity 0.2s;
}
.pager-jumper-btn:hover {
opacity: 0.9;
}
.pager-info {
margin-left: 12px;
color: #718096;
font-size: 13px;
}
#log {
margin-top: 15px;
padding: 10px 14px;
background: #F7FAFC;
border: 1px solid #E2E8F0;
border-radius: 4px;
font-family: monospace;
color: #345E82;
}
</style>
</head>
<body>
<h3>分页组件挂载容器:</h3>
<div id="pagination-app"></div>
<div id="log">当前准备就绪...</div>
<script>
// 此处载入前文编写的 Pagination 类定义...
const pager = new Pagination({
container: '#pagination-app',
total: 250,
pageSize: 10,
currentPage: 1,
onChange: (newPage, prevPage) => {
document.getElementById('log').innerText =
`[业务事件派发] 页码由 ${prevPage} 切换至 ${newPage},正在发起异步网络请求...`;
}
});
</script>
</body>
</html>
七、常见边界问题排查与工程化建议
在实际团队协作和复杂业务集成中,开发者往往还会遇到一些特殊情景。以下是经过生产检验的关键规避建议:
当用户在第 20 页执行批量删除操作后,数据总条数可能从 200 条骤降至 50 条(总页数变为 5)。如果此时调用
setTotal() 仅仅更新 total,组件可能会残留不合法的当前页码。因此,在 setTotal() 逻辑中必须追加 if (this.currentPage > this.totalPages) this.currentPage = this.totalPages; 的自修正保护。
当网络存在延迟时,用户连续高速点击页码可能会触发多个并发数据请求。若较早发出的请求较晚返回,会导致列表数据与分页器的激活状态不一致。工程上建议在
onChange 业务回调中维护一个加载状态锁,或者在请求发起前中止上一轮未完结的 AbortController。
由于
input[type="number"] 在聚焦时鼠标滚轮滚动可能无意间改变其中的数值,建议在 CSS 中设置屏蔽样式或在初始化时绑定 wheel 事件调用 e.preventDefault(),避免破坏用户的阅读节奏。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。