萬盛學電腦網

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

jQuery Tab 選項卡 AJAX 動態加載內容實戰教程

核心思路

  1. Tab 標題綁定 mouseover/click 事件
  2. 切換活動標題樣式
  3. 根據 href 或 data-url 異步加載內容到面板容器
  4. 阻止默認鏈接跳轉

基礎結構

<ul id="tabs" class="tab-nav">
    <li class="active"><a href="/api/news/1">新聞 1</a></li>
    <li><a href="/api/news/2">新聞 2</a></li>
    <li><a href="/api/news/3">新聞 3</a></li>
</ul>
<div id="tabContent" class="tab-panel"></div>

基礎版實現

$(function() {
    var $tabs = $('#tabs');
    var $panel = $('#tabContent');
    var currentXHR = null; // 緩存當前請求,用於取消
    
    $tabs.on('click', 'a', function(e) {
        e.preventDefault(); // 阻止跳轉
        var $link = $(this);
        var url = $link.attr('href');
        
        // 切換標題狀態
        $link.parent().addClass('active').siblings().removeClass('active');
        
        // 取消上一個未完成請求
        if (currentXHR) currentXHR.abort();
        
        // 顯示加載中
        $panel.html('
加載中...
'); // 發送請求 currentXHR = $.ajax({ url: url, type: 'GET', dataType: 'html', // 期望 HTML 片段 success: function(html) { $panel.html(html); currentXHR = null; }, error: function(xhr, status) { if (status !== 'abort') { $panel.html('
加載失敗,請重試
'); } currentXHR = null; } }); }); // 初始化:觸發第一個 Tab $tabs.find('a:first').trigger('click'); });

進階版:緩存機制 + 參數傳遞 + 回調

var TabLoader = (function() {
    var cache = {}; // url -> html 緩存
    var loadingTpl = '
加載中...
'; var errorTpl = '
加載失敗:{msg}
'; function load($tab, $panel, options) { var url = $tab.data('url') || $tab.attr('href'); var method = $tab.data('method') || 'GET'; var params = $tab.data('params') || {}; // 合併 data-* 屬性參數 $.each($tab.data(), function(key, val) { if (key !== 'url' && key !== 'method' && key !== 'params') { params[key] = val; } }); $tab.addClass('active').siblings().removeClass('active'); $panel.html(loadingTpl); // 緩存命中 if (cache[url] && !options.forceRefresh) { $panel.html(cache[url]); options.onLoad && options.onLoad(cache[url]); return; } return $.ajax({ url: url, type: method, data: params, dataType: 'html', success: function(html) { cache[url] = html; $panel.html(html); options.onLoad && options.onLoad(html); }, error: function(xhr, status, err) { if (status !== 'abort') { $panel.html(errorTpl.replace('{msg}', err || status)); } } }); } return { init: function(tabSelector, panelSelector, options) { var $tabs = $(tabSelector); var $panel = $(panelSelector); $tabs.on('click', 'a', function(e) { e.preventDefault(); load($(this), $panel, options || {}); }); // 鍵盤支持 $tabs.on('keydown', 'a', function(e) { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); $(this).trigger('click'); } else if (e.key === 'ArrowRight') { e.preventDefault(); $(this).parent().next().find('a').focus().trigger('click'); } else if (e.key === 'ArrowLeft') { e.preventDefault(); $(this).parent().prev().find('a').focus().trigger('click'); } }); // 自動激活第一個 $tabs.find('a:first').trigger('click'); }, clearCache: function() { cache = {}; }, refresh: function($tab, $panel) { load($tab, $panel, {forceRefresh: true}); } }; })(); // 使用 TabLoader.init('#tabs a', '#tabContent', { onLoad: function(html) { console.log('內容已加載'); } });

服務端返回格式建議

返回純 HTML 片段,無需包裝完整頁面:

<!-- /api/news/1 返回 -->
<div class="news-list">
    <article><h3>標題</h3><p>摘要</p></article>
    <article>...</article>
</div>

常見優化點

  • 🚀 預加載:mouseenter 時預請求,click 時直接用緩存
  • 💾 localStorage 持久化緩存:跨會話保留,配合版本號失效
  • 🔄 防抖:快速切換 Tab 時取消上一請求
  • 📜 歷史管理:history.pushState 更新 URL,支持瀏覽器前進後退
  • ♿ 無障礙:role="tablist"、aria-selected、aria-controls

無障礙增強示例

<ul role="tablist">
    <li role="presentation">
        <a role="tab" aria-selected="true" aria-controls="panel1" href="#panel1">Tab 1</a>
    </li>
</ul>
<div role="tabpanel" id="panel1" aria-labelledby="tab1"></div>

<script>
$tabs.on('click', 'a', function() {
    $(this).attr('aria-selected', 'true')
           .parent().siblings().find('a').attr('aria-selected', 'false');
    // ... 加載邏輯
});

掌握此模式,可快速構建高性能、可維護的 Tab 動態加載界面。

copyright © 萬盛學電腦網 all rights reserved