萬盛學電腦網

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

如何用 jQuery UI 實作選項卡介面:從基礎到 AJAX 動態載入

jQuery UI Tabs 是建構選項卡介面的標準元件,支援靜態內容、AJAX 動態載入、動畫、鍵盤導航與無障礙。本文從基本結構出發,示範進階功能與現代替代方案。

基本 HTML 結構

<div id="tabs">
  <ul>
    <li><a href="#tab-1">標籤一</a></li>
    <li><a href="#tab-2">標籤二</a></li>
    <li><a href="#tab-3">標籤三</a></li>
  </ul>
  <div id="tab-1">
    <p>標籤一的靜態內容...</p>
  </div>
  <div id="tab-2">
    <p>標籤二的靜態內容...</p>
  </div>
  <div id="tab-3">
    <p>標籤三的靜態內容...</p>
  </div>
</div>

一行啟用

$(function() {
  $("#tabs").tabs();
});

常用配置選項

$("#tabs").tabs({
  active: 0,              // 預設啟用索引(0-based)
  collapsible: true,      // 允許全部摺疊(再次點擊關閉)
  event: "click",         // 觸發事件:click / mouseover
  heightStyle: "content", // "auto" (最高) / "fill" (填滿容器) / "content" (自適應)
  hide: { effect: "fadeOut", duration: 200 }, // 隱藏動畫
  show: { effect: "fadeIn", duration: 200 },  // 顯示動畫
  classes: {              // 自訂 CSS 類別
    "ui-tabs": "my-tabs",
    "ui-tabs-active": "my-active"
  }
});

進階:AJAX 動態載入內容

將 `` 指向**外部 URL** 而非頁面內錨點,Tabs 會自動透過 AJAX 載入並快取。

<div id="tabs-ajax">
  <ul>
    <li><a href="/partials/dashboard.html">儀表板</a></li>
    <li><a href="/partials/reports.html">報表</a></li>
    <li><a href="/partials/settings.html">設定</a></li>
  </ul>
  <!-- 內容容器會自動建立 -->
</div>

<script>
$("#tabs-ajax").tabs({
  beforeLoad: function(event, ui) {
    // 載入前:可修改請求、顯示 Loading
    ui.jqXHR = $.ajax({
      url: ui.tab.data("url") || ui.tab.find("a").attr("href"),
      dataType: "html",
      beforeSend: () => ui.panel.html('
載入中...
') }); }, load: function(event, ui) { // 載入成功:初始化內容區的元件(如表格、圖表) initializeComponents(ui.panel); }, beforeActivate: function(event, ui) { // 切換前:若新分頁未載入過,觸發載入 if (ui.newPanel.is(":empty")) { ui.newTab.find("a").trigger("click"); // 觸發 beforeLoad } } }); </script>

錯誤處理與回退

$("#tabs-ajax").tabs({
  beforeLoad: function(event, ui) {
    ui.jqXHR.fail(function() {
      ui.panel.html(
        ''
      );
      event.preventDefault(); // 阻止預設錯誤處理
    });
  }
});

方法操作

const tabs = $("#tabs").tabs();

// 程式化切換
tabs.tabs("option", "active", 1); // 切換到第 2 個
tabs.tabs("option", "active", -1); // 摺疊全部(需 collapsible: true)

// 取得/設定選項
const activeIndex = tabs.tabs("option", "active");
tabs.tabs("option", "disabled", [1, 2]); // 禁用索引 1,2

// 重新整理(動態新增/移除 tab 後)
tabs.tabs("refresh");

// 銷毀
tabs.tabs("destroy");

事件生命週期

事件觸發時機參數
beforeActivate切換前(可取消)event, ui: { oldTab, newTab, oldPanel, newPanel }
activate切換完成同前
beforeLoadAJAX 載入前event, ui: { tab, panel, jqXHR }
loadAJAX 載入成功同前
create初始化完成event, ui: { tab, panel }

無障礙合規

  • 自動產生符合 ARIA Authoring Practices 的標記:`role="tablist"`、`role="tab"`、`role="tabpanel"`、`aria-selected`、`aria-controls`、`aria-labelledby`、`tabindex` 管理。
  • 鍵盤操作:←/→ 切換、Home/End 跳首尾、Enter/Space 啟用。
  • 焦點管理:切換時自動將焦點移至新 Tab。

現代替代方案

方案特點依賴
原生 `
`/``
零 JS、語意化、SEO 友善、動畫需 CSS無
CSS `:target` / `:checked` Hack零 JS、支援深層連結、無障礙需額外處理無
Tabs 元件庫tabs (2KB)、Alpine.js、`x-tab`輕量
框架內建Vue ``/``、React `react-tabs`、Svelte `svelte-tabs`框架

遷移建議

  • 新專案**優先使用原生 HTML/框架元件**,避免引入 jQuery UI(已停止積極開發、體積大)。
  • 維護舊專案時,保持現有 `tabs()` 呼叫,逐步以原生/框架元件替換。
  • 若需 AJAX 載入,考慮使用 `