DIV CSS 佈局教程網

基於 jQuery 打造自定義 Tabs 選項卡插件
編輯:JQuery入門技巧     

網上的 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 選項卡相關的整理資料,思路與此一致,只是少了框架封裝。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved