萬盛學電腦網

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

jQuery 網頁換膚進階:CSS 文件動態切換 + Cookie 持久化完整方案

兩種換膚架構對比

方案核心機制優點缺點適用場景
類名切換 (上文)單 CSS 文件含所有主題,body 切換類名無閃爍、切換極快、無網絡請求、易維護CSS 文件大、所有主題打包下載主題數少(≤10)、色系變化為主
文件切換 (本文)每主題獨立 CSS 文件,動態替換 <link> href按需加載、主題完全隔離、支持任意差異切換有延遲、可能閃爍、需管理多文件主題差異大、主題多、需動態下發

文件切換方案完整實現

HTML 結構:關鍵雙 Link 模式

<head>
    <!-- 基礎樣式(不隨主題變化) -->
    <link href="css/base.css" rel="stylesheet" type="text/css" />
    
    <!-- 主題樣式:必須有 id,通過 JS 修改 href -->
    <link href="css/skin_0.css" rel="stylesheet" type="text/css" id="themeStyle" />
    
    <!-- jQuery + Cookie 插件 -->
    <script src="js/jquery-3.6.0.min.js"></script>
    <script src="js/jquery.cookie.js"></script>
</head>
<body>
    <ul id="skin" class="skin-selector">
        <li id="skin_0" class="selected" title="灰色">灰色</li>
        <li id="skin_1" title="紫色">紫色</li>
        <li id="skin_2" title="紅色">紅色</li>
        <li id="skin_3" title="天藍">天藍</li>
        <li id="skin_4" title="橙色">橙色</li>
        <li id="skin_5" title="淡綠">淡綠</li>
    </ul>
    
    <div class="page-content">...</div>
</body>

核心 JS 邏輯

<script>
$(function() {
    var $skinItems = $("#skin li");
    var $themeLink = $("#themeStyle");
    
    // 1. 綁定點擊事件
    $skinItems.click(function() {
        switchSkin(this.id);
    });
    
    // 2. 讀取 Cookie 恢復主題
    var savedSkin = $.cookie("MyCssSkin");
    if (savedSkin) {
        switchSkin(savedSkin);
    }
    
    // 3. 核心切換函數
    function switchSkin(skinName) {
        // UI 反饋:高亮當前選項
        $("#" + skinName).addClass("selected").siblings().removeClass("selected");
        
        // 核心:修改 link href 觸發瀏覽器重新加載 CSS
        $themeLink.attr("href", "css/" + skinName + ".css");
        
        // 持久化:設置 Cookie (10天過期,全站生效)
        $.cookie("MyCssSkin", skinName, { 
            path: '/', 
            expires: 10 
        });
    }
});
</script>

CSS 文件組織 (css/skin_0.css 示例)

/* skin_0.css - 灰色主題 */
body { background: #f0f0f0; color: #333; }
.header { background: #666; color: #fff; }
.nav a { color: #333; }
.nav a:hover { color: #999; }
.btn-primary { background: #999; border-color: #888; }
.card { border: 1px solid #ddd; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }

/* skin_1.css - 紫色主題 */
body { background: #f3e5f5; color: #4a148c; }
.header { background: #7b1fa2; color: #fff; }
.nav a { color: #4a148c; }
.nav a:hover { color: #ce93d8; }
.btn-primary { background: #ab47bc; border-color: #8e24aa; }
.card { border: 1px solid #e1bee7; box-shadow: 0 2px 4px rgba(123,31,162,0.1); }

/* ... 其他主題同理 */

關鍵技術細節深度解析

1. Cookie 插件依賴

原文使用 jquery.cookie.js (已停維護)。現代替代:

// 原生封裝 (無依賴)
const Cookie = {
    set(name, value, days) {
        var expires = "";
        if (days) {
            var date = new Date();
            date.setTime(date.getTime() + days * 864e5);
            expires = "; expires=" + date.toGMTString();
        }
        document.cookie = name + "=" + encodeURIComponent(value) + expires + "; path=/";
    },
    get(name) {
        var cookies = document.cookie.split("; ");
        for (var c of cookies) {
            var [k, v] = c.split("=");
            if (k === name) return decodeURIComponent(v);
        }
        return null;
    },
    remove(name) {
        this.set(name, "", -1);
    }
};

// 使用
Cookie.set("MyCssSkin", "skin_2", 10);
var skin = Cookie.get("MyCssSkin");

2. 閃爍問題 (FOUC) 解決方案

動態切換 CSS 會導致短暫無樣式閃爍:

// 方案一:預加載所有主題 CSS (隱藏 link)
$('head').append(
    $('#skin li').map(function() {
        return '<link rel="stylesheet" href="css/' + this.id + '.css" class="preload-theme" disabled>';
    }).get().join('')
);

// 切換時啟用目標、禁用其他
function switchSkin(skinName) {
    $('.preload-theme').prop('disabled', true);
    $('.preload-theme[href*="' + skinName + '"]').prop('disabled', false);
    // ... UI 更新、Cookie
}

// 方案二:內聯關鍵 CSS + 異步加載完整 CSS
// 方案三:CSS 變量方案 (無閃爍,推薦現代項目)

3. 避免重複請求:瀏覽器緩存利用

同一主題二次切換會命中緩存 (304 Not Modified),極快。確保服務端配置正確的 Cache-Control、ETag。

擴展:服務端渲染 (SSR) 同步主題

避免頁面首次渲染「默認主題 → 目標主題」閃爍:

<!-- 服務端模板 (如 JSP, FreeMarker, Thymeleaf, EJS) -->
<head>
    <link href="css/base.css" rel="stylesheet" />
    <link href="css/${cookie.MyCssSkin ?: 'skin_0'}.css" rel="stylesheet" id="themeStyle" />
</head>

服務端直接讀取 Cookie 輸出正確主題,瀏覽器首屏直出正確樣式。

現代化重構:CSS 變量 + 類名切換 (融合兩者優勢)

<!-- 單一 CSS 文件定義所有主題變量 -->
<link href="css/themes.css" rel="stylesheet" id="themeStyle" />

<script>
// 切換只改 body 類名,無網絡請求、零閃爍
function switchSkin(skinName) {
    document.body.className = document.body.className.replace(/theme-\w+/g, '') + ' ' + skinName;
    Cookie.set("MyCssSkin", skinName, 365);
}

// themes.css 內容
:root { --bg: #fff; --text: #333; --accent: #007bff; }
.theme-dark { --bg: #1a1a1a; --text: #f0f0f0; --accent: #4dabf7; }
.theme-purple { --bg: #f3e5f5; --text: #4a148c; --accent: #ab47bc; }
/* ... */

總結

jQuery 換膚的「文件切換 + Cookie」方案是經典 jQuery 時代的產物,核心技巧在於 link[href] 動態修改觸發瀏覽器重新加載樣式表。現代開發強烈建議遷移至 CSS 變量 + 類名切換 方案:單文件、零請求、無閃爍、極易維護、原生響應系統主題偏好。若項目必須保持多獨立 CSS 文件架構,請務必添加預加載機制消除 FOUC,並考慮 SSR 同步輸出首屏主題。

copyright © 萬盛學電腦網 all rights reserved