jQuery UI Tabs 是建構選項卡介面的標準元件,支援靜態內容、AJAX 動態載入、動畫、鍵盤導航與無障礙。本文從基本結構出發,示範進階功能與現代替代方案。
<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"
}
});
將 `` 指向**外部 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 | 切換完成 | 同前 |
beforeLoad | AJAX 載入前 | event, ui: { tab, panel, jqXHR } |
load | AJAX 載入成功 | 同前 |
create | 初始化完成 | event, ui: { tab, panel } |
| 方案 | 特點 | 依賴 |
|---|---|---|
| 原生 ` `/` ` | 零 JS、語意化、SEO 友善、動畫需 CSS | 無 |
| CSS `:target` / `:checked` Hack | 零 JS、支援深層連結、無障礙需額外處理 | 無 |
| Tabs 元件庫 | tabs (2KB)、Alpine.js、`x-tab` | 輕量 |
| 框架內建 | Vue ` | 框架 |
jQuery UI Tabs 曾是標準解法,理解其 API 與無障礙實作細節,有助於維護舊專案並平滑遷移至現代架構。