網上的 Tabs 插件很多,但真正能用的往往卡在兩件事上:風格與項目不搭,或者 API 設計彆扭。與其反覆魔改別人的代碼,不如自己寫一個——功能不必比別人強,順手才最重要。
本文的插件支持三種內容加載方式(iframe、ajax、直接 HTML)、可關閉標籤、默認選中、切換回調,並可通過參數自定義所有 class 名與圖示,方便對接項目已有的樣式體系。
(function ($) {
'use strict';
var defaults = {
type: "iframe", // 內容加載方式:iframe | ajax | html
onchanged: null, // 切換後的回調
style: {
header_panel: "tab-headers",
content_panel: "tab-contents",
header: "tab-header",
content: "tab-content",
selected: "selected",
icon_base: "fa",
icon_close: "fa-close"
}
};
var methods = {
// 初始化
init: function (options) {
return this.each(function () {
var $this = $(this);
if (!$this.hasClass("tw.tabs")) {
$this.addClass("tabs");
}
var settings = $this.data('tw.tabs');
if (typeof (settings) == 'undefined') {
settings = $.extend({}, defaults, options);
} else {
settings = $.extend({}, settings, options);
}
$this.data('tw.tabs', settings);
// 清空並重建骨架
$this.empty();
$this.append($("<ul class='" + settings.style.header_panel + "'></ul>"));
$this.append($("<div class='" + settings.style.content_panel + "'></div>"));
// 若配置中帶有初始數據,逐個添加
if (settings.data) {
if (typeof settings.data === 'string') {
settings.data = $.parseJSON(settings.data);
}
$.each(settings.data, function () {
$this.tabs("add", this);
});
}
});
},
// 添加一個標籤
add: function (tab) {
var $this = $(this);
var settings = $this.data("tw.tabs");
var headers = $this.find("." + settings.style.header_panel);
var contents = $this.find("." + settings.style.content_panel);
if (headers.find("[data-tab='" + tab.id + "']").length == 0) {
var header = $("<li class='" + settings.style.header + "' data-tab='" + tab.id + "'>"
+ "<i class='" + settings.style.icon_base + tab.icon + "'></i>"
+ "<span class='tab-title'>" + tab.name + "</span></li>");
// 可關閉標籤
if (tab.canClose) {
var close = $("<i class='" + settings.style.icon_base + settings.style.icon_close + "'></i>");
close.click(function () {
$this.tabs("remove", tab.id);
});
header.append(close);
}
header.data("tw.tab", tab);
header.click(function () {
$this.tabs("select", tab);
});
headers.append(header);
// 內容區
var content = $("<div class='" + settings.style.content + "' data-tab='" + tab.id + "'></div>");
if (settings.type == "iframe") {
content.append("<iframe src='" + tab.url + "?target_id=" + tab.id + "'></iframe>");
} else if (settings.type == "ajax") {
$.ajax({
url: tab.url,
type: "post",
async: false,
data: { target_id: tab.id },
success: function (result) {
content.html(result);
}
});
} else {
content.html(tab.content);
}
contents.append(content);
if (tab.selected) {
$this.tabs("select", tab);
}
} else {
$this.tabs("select", tab);
}
},
// 選中指定標籤
select: function (tab) {
var $this = $(this);
var settings = $this.data("tw.tabs");
$this.find("." + settings.style.selected).removeClass(settings.style.selected);
if (typeof tab == "object") {
$this.find("[data-tab='" + tab.id + "']").addClass(settings.style.selected);
} else {
$this.find("." + settings.style.header).eq(tab).addClass(settings.style.selected);
$this.find("." + settings.style.content).eq(tab).addClass(settings.style.selected);
}
if (settings.onchanged) {
settings.onchanged(tab);
}
},
// 刷新當前標籤內容
refresh: function () {
var $this = $(this);
var settings = $this.data("tw.tabs");
var selected = $this.find("." + settings.style.selected);
var tab = $this.find("." + settings.style.header).data("tw.tab");
if (settings.type == "iframe") {
selected.find("iframe").attr('src', tab.url + "?target_id=" + tab.id);
} else if (settings.type == "ajax") {
$.ajax({
url: tab.url,
type: "post",
async: false,
data: { target_id: tab.id },
success: function (result) {
selected.html(result);
}
});
} else {
selected.html(tab.content);
}
},
// 移除標籤
remove: function (id) {
var $this = $(this);
var settings = $this.data("tw.tabs");
var tab = $this.find("[data-tab='" + id + "']");
if (tab.find("." + settings.style.selected).length) {
var index = tab.eq(0).index() - 1;
$this.tabs("select", index);
}
tab.remove();
},
destroy: function () {
return $(this).each(function () {
$(this).removeData('tabs');
});
}
};
// 方法調度入口
$.fn.tabs = function () {
var method = arguments[0];
var args = arguments;
if (typeof (method) == 'object' || !method) {
method = methods.init;
} else if (methods[method]) {
method = methods[method];
args = $.makeArray(arguments).slice(1);
} else {
$.error('Method ' + method + ' does not exist on tw.tabs');
return this;
}
return method.apply(this, args);
};
})(jQuery);
.tabs { width: 100%; height: 100%; }
.tabs .tab-headers {
margin: 0; padding: 0 10px; height: 40px; list-style: none;
background: #f5f5f5; border-bottom: 1px solid #ccc;
}
.tabs .tab-headers .tab-header {
float: left; height: 30px; font-size: 12px;
padding: 7px 15px 0; margin-top: 10px; margin-right: 5px;
border: 1px solid #ccc; border-bottom: none;
position: relative; cursor: pointer;
}
.tabs .tab-headers .tab-header:hover { background: #ccc; color: #0094ff; }
.tabs .tab-headers .tab-header.selected {
background: #fff; border: none; cursor: default;
padding-top: 5px; margin-left: 1px; margin-right: 6px;
border-top: 3px solid #0094ff;
}
.tabs .tab-headers .tab-header .tab-title { margin-left: 5px; }
.tabs .tab-headers .tab-header .fa-close { position: relative; right: -6px; top: 0; }
.tabs .tab-headers .tab-header .tab-close:hover { color: #f00; cursor: pointer; }
.tabs .tab-contents { width: 100%; height: calc(100% - 40px); }
.tabs .tab-contents .tab-content { display: none; }
.tabs .tab-contents .tab-content.selected {
display: block; width: 100%; height: 100%; overflow: hidden;
}
.tabs .tab-contents .tab-content.selected iframe {
width: 100%; height: 100%; border: none;
}
$("#myTabs").tabs({
type: "ajax",
data: [
{ id: 1, name: "基本信息", url: "/Home/Profile", canClose: true },
{ id: 2, name: "訂單記錄", url: "/Home/Orders", selected: true }
],
onchanged: function (tab) { console.log("切換到", tab.id); }
});
$("#myTabs").tabs("add", { id: 3, name: "日誌", url: "/Home/Logs" });
$("#myTabs").tabs("remove", 2);
$("#myTabs").tabs("refresh");
方法調度模式。插件把 init/add/select/refresh/remove/destroy 收進 methods 對象,再通過 $.fn.tabs 依第一個參數分派。這是 jQuery 社區的事實標準寫法,比在 $.fn 上掛一堆 tabsXxx 方法要整潔得多。
配置持久化。用 $this.data('tw.tabs', settings) 保存配置,後續方法調用時再取出,避免了反覆傳參。
可以改進的地方:ajax 加載用了 async: false,這會阻塞主線程,新版 jQuery 已棄用該做法,應改為異步並在 success 中渲染;refresh 中引用了未定義的 content 變量,需要改為 selected;remove 裡用 tab.find(...) 判斷選中狀態邏輯有誤,應直接在 tab 上判 hasClass。 these 都是可以自行修掉的小瑕疵。
若需要更多關於選項卡操作技巧的內容,也可參考 JavaScript 選項卡相關的整理資料,思路與此一致,只是少了框架封裝。