分页导航DOM更新实践：JavaScript与jQuery的结合使用

在Web开发中，分页导航是展示大量数据时不可或缺的UI组件。合理的分页不仅可以提高应用性能，还能优化用户体验。本博客将通过一个实际的DOM结构和模拟数据，讲解如何使用JavaScript和jQuery来动态更新分页导航。

分页场景讲述

在设计分页导航时，我们会遇到多种场景，每种场景都需要不同的处理方式：

总页数较少：当数据量不大时，可能只需要显示所有页码，无需省略。
当前页在页码列表的边缘：如果当前页是第一页或最后一页，可能不需要“上一页”或“下一页”链接。

当前页在中间：需要在页码列表中适当位置显示当前页，并在边缘显示第一页和最后一页的链接。

大量页码的省略处理：当总页数很多时，不可能全部显示，需要用省略号代替中间的页码。

理解这些场景有助于我们编写灵活且健壮的分页逻辑。

模拟数据

假设我们从后端API获取了以下分页数据：

var paginationData = {page: 1,       // 当前页码pages : 5,     //总页数per_page: 10 ,  // 每页显示的项目数total: 50      // 总项目数
};

原始DOM结构

下面是现有的分页DOM结构，它包含了页码信息和分页控件：

 <footer id="pagination-footer" class="panel-footer"><div class="row"><div class="col-sm-5 text-center"><small class="text-muted inline m-t-sm m-b-sm">showing 20-30 of 50 items</small></div><div class="col-sm-7 text-right text-center-xs"><ul class="pagination pagination-sm m-t-none m-b-none"><li><a href=""><i class="fa fa-chevron-left"></i></a></li><li><a href="">1</a></li><li><a href="">2</a></li><li><a href="">3</a></li><li><a href="">4</a></li><li><a href=""><i class="fa fa-chevron-right"></i></a></li></ul></div></div></footer>

更新分页DOM的代码

现在，我们将使用模拟数据和原始DOM结构，编写updatePaginationDOM函数来更新分页导航：

/**
* 更新分页的DOM
* @param data 响应数据
*/
function updatePaginationDOM(data) {var footer = $('#pagination-footer');footer.empty(); // 清空原有分页DOMvar paginationHTML = `<div class="row">
<div class="col-sm-5 text-center">
<small class="text-muted inline m-t-sm m-b-sm">每页 ${data.per_page} 个，共 ${data.total} 个</small>
</div>
<div class="col-sm-7 text-right text-center-xs">
<ul class="pagination pagination-sm m-t-none m-b-none">`;// 当前页码大于1 ，添加“上一页”链接if (data.page > 1) {paginationHTML += `<li><a href="#" data-page-number="${data.page - 1}"><i class="fa fa-chevron-left"></i></a></li>`;}// 计算并添加页码链接const maxPagesToShow = 5; // 显示的页码数量const startPage = Math.max(1, data.page - Math.floor(maxPagesToShow / 2));// 计算显示的开始页码const endPage = Math.min(data.pages, startPage + maxPagesToShow - 1);// 计算显示的结束页码console.log(startPage,endPage)// 如果开始页码大于1，显示省略号和第一页的链接if (startPage > 1) {paginationHTML += `<li><a href="#">1</a></li>`;if (startPage > 2) paginationHTML += `<li><span>...</span></li>`;}for (let i = startPage; i <= endPage; i++) {paginationHTML += `<li class="${i === data.page ? 'active' : ''}"><a href="#">${i}</a></li>`;}if (endPage < data.pages) {if (endPage < data.pages - 1) paginationHTML += `<li><span>...</span></li>`;paginationHTML += `<li><a href="#" >${data.pages}</a></li>`;}// 当前页码小于总页数，添加“下一页”链接if (data.page < data.pages) {paginationHTML += `<li><a href="#" data-page-number="${data.page + 1}" ><i class="fa fa-chevron-right"></i></a></li>`;}paginationHTML += `
</ul>
</div>
</div>
`;footer.html(paginationHTML);// 使用事件委托来绑定分页链接的点击事件$('#pagination-footer .pagination a').on('click', function (e) {e.preventDefault(); // 阻止链接的默认行为var pageNumber = $(this).data('page-number');if (pageNumber) {loadMovies(pageNumber); // 调用 loadMovies 函数return}var page = $(this).text(); // 从链接文本获取页码if (page > 0) {loadMovies(page); // 调用 loadMovies 函数}});
}