萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 實現分頁控件完整源碼解析與擴展指南

插件架構設計

採用 $.fn.extend 擴展 jQuery 原型,以插件形式調用:$('#pager').JPager(config, pageIndex, pageSize)。核心功能模組:

  • 頁碼導航:首頁、上頁、下頁、末頁、頁碼跳轉、輸入框跳轉
  • 狀態管理:禁用首/尾頁、高亮當前頁
  • 自定義模板:支援用戶自定義顯示區域(總頁數、當前頁、總記錄數等)
  • 回調配置:cfg.callback(pageIndex, pageSize) 通知業務層加載數據

核心源碼精簡版(關鍵邏輯)

$.fn.extend({
    JPager: function(cfg, pageIndex, pageSize) {
        var $container = this.empty();
        var token = '#' + this.attr('id');
        
        // 1. 計算總頁數
        var totalPages = Math.ceil(cfg.recordCount / pageSize);
        if (pageIndex < 1) pageIndex = 1;
        if (pageIndex > totalPages) pageIndex = totalPages;
        
        // 2. 生成導航按鈕
        var html = '';
        html += '<a id="_first" class="number">首頁</a>';
        html += '<a id="_pre" class="number">上頁</a>';
        // ... 頁碼區域 ...
        html += '<a id="_next" class="number">下頁</a>';
        html += '<a id="_last" class="number">末頁</a>';
        html += '<input id="_pos" type="text" /><button id="_go">GO</button>';
        html += '<span id="_left"></span><span id="_right"></span>'; // 自定義模板插槽
        
        $container.html(html);
        
        // 3. 綁定事件
        $('#_first', $container).click(function() { $(token).JPager(cfg, 1, pageSize); });
        $('#_pre', $container).click(function() { $(token).JPager(cfg, pageIndex-1, pageSize); });
        $('#_next', $container).click(function() { $(token).JPager(cfg, pageIndex+1, pageSize); });
        $('#_last', $container).click(function() { $(token).JPager(cfg, totalPages, pageSize); });
        $('#_go', $container).click(function() {
            var idx = parseInt($('#_pos').val());
            $(token).JPager(cfg, idx, pageSize);
        });
        
        // 4. 頁碼區域渲染邏輯(省略:當前頁居中、省略號處理)
        // ...
        
        // 5. 狀態類切換
        if (pageIndex === 1) $('#_first,#_pre', $container).addClass('unable');
        if (pageIndex === totalPages) $('#_last,#_next', $container).addClass('unable');
        
        // 6. 執行用戶回調
        if (cfg.callback) cfg.callback(pageIndex, pageSize);
    }
});

使用示例

// HTML
<div id="pager"></div>

// JS
$('#pager').JPager({
    recordCount: 156,      // 總記錄數(必填)
    pageSize: 10,          // 每頁大小
    callback: function(page, size) {
        loadData(page, size); // 業務層請求數據
    },
    customer: {
        template: '共 %total% 頁,當前第 %current% 頁,共 %recordCount% 條',
        position: 'right'
    }
}, 1, 10); // 初始第 1 頁

擴展與優化建議

  1. TypeScript 類型定義:為配置物件、回調函數添加類型,提升開發體驗。
  2. 無障礙支援:添加 role="navigation"、aria-label、鍵盤導航支持。
  3. 響應式設計:小屏幕自動折疊頁碼,僅顯示首/末/上/下/當前頁。
  4. 解耦渲染與邏輯:採用 Virtual DOM 或模板引擎(Handlebars/art-template)分離 HTML 結構。
  5. 緩存機制:前端緩存已請求頁面數據,避免重複請求。

現代替代方案

新專案建議使用成熟分頁組件:

  • Element UI el-pagination (Vue)
  • Ant Design Pagination (React/Vue)
  • Bootstrap 5 Pagination + 原生 JS 邏輯
  • 原生 <nav aria-label="Pagination"> + Fetch API
copyright © 萬盛學電腦網 all rights reserved