萬盛學電腦網

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

JavaScript 控制背景圖顯示/隱藏並記憶使用者偏好

需求場景

節日活動頁面使用大幅背景圖增強視覺衝擊,但部分使用者偏好簡潔介面。需提供「關閉背景」按鈕,點擊後:

  1. 立即隱藏背景圖
  2. 記錄偏好至 Cookie(設定有效期)
  3. 後續造訪在 Cookie 有效期內自動隱藏背景
  4. Cookie 過期後自動恢復顯示

完整實作代碼

HTML 結構

<div id="pageTop">
  <em id="closeBgBtn" title="關閉背景" role="button" tabindex="0" aria-label="關閉背景圖片"></em>
</div>
<div id="mainContent">...頁面主要內容...</div>

CSS 樣式

* { margin: 0; padding: 0; box-sizing: border-box; }
body { font: 16px/1.5 "Microsoft JhengHei", sans-serif; transition: background 0.3s ease; }
#pageTop { position: relative; width: 100%; max-width: 1200px; margin: 0 auto; height: 80px; }
#closeBgBtn {
  position: absolute; right: 20px; bottom: 20px;
  width: 40px; height: 40px;
  background: url('images/close-btn.svg') no-repeat center / contain;
  cursor: pointer; display: block; z-index: 10;
  opacity: 0.7; transition: opacity 0.2s;
}
#closeBgBtn:hover { opacity: 1; }
#closeBgBtn:focus { outline: 2px solid #3498db; outline-offset: 2px; }

/* 背景圖樣式類別 */
body.has-bg {
  background: url('images/bg-body.jpg') no-repeat center top / cover,
              url('images/bg-html.jpg') repeat-x left top;
}
body.no-bg { background: #f5f5f5; }

JavaScript 核心邏輯

(function() {
  // 設定
  var COOKIE_NAME = "hideBgPref";
  var COOKIE_DAYS = 30;  // 30 天有效期
  var $body = $('body');
  var $btn = $('#closeBgBtn');

  // Cookie 工具函式
  function setCookie(name, value, days) {
    var expires = "";
    if (days) {
      var date = new Date();
      date.setTime(date.getTime() + (days * 24 * 60 * 60 * 1000));
      expires = "; expires=" + date.toUTCString();
    }
    document.cookie = name + "=" + encodeURIComponent(value) + expires + "; path=/; SameSite=Lax";
  }

  function getCookie(name) {
    var match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
    return match ? decodeURIComponent(match[2]) : null;
  }

  // 初始化:檢查 Cookie 決定是否顯示背景
  function initBackground() {
    var hidden = getCookie(COOKIE_NAME) === "1";
    if (hidden) {
      $body.removeClass('has-bg').addClass('no-bg');
      $btn.hide();
    } else {
      $body.removeClass('no-bg').addClass('has-bg');
      $btn.show();
    }
  }

  // 切換背景顯示狀態
  function toggleBackground(hide) {
    if (hide) {
      $body.removeClass('has-bg').addClass('no-bg');
      $btn.hide();
      setCookie(COOKIE_NAME, "1", COOKIE_DAYS);
    } else {
      $body.removeClass('no-bg').addClass('has-bg');
      $btn.show();
      setCookie(COOKIE_NAME, "0", COOKIE_DAYS);
    }
  }

  // 事件綁定
  $btn.on('click', function() {
    toggleBackground(true);
  });

  // 鍵盤無障礙支援
  $btn.on('keydown', function(e) {
    if (e.key === 'Enter' || e.key === ' ') {
      e.preventDefault();
      toggleBackground(true);
    }
  });

  // 初始化
  $(initBackground);
})();

關鍵技術點解析

1. CSS 類別切換而非直接操作 style

使用 .has-bg/.no-bg 類別控制背景,優點:

  • 樣式集中管理,易維護
  • 可搭配 CSS Transition 產生淡入淡出效果
  • 避免內聯樣式優先級問題

2. Cookie 設定最佳實踐

  • path=/:全站生效
  • SameSite=Lax:平衡安全性與跨站導航體驗
  • encodeURIComponent:防止特殊字元破壞 Cookie 格式
  • 有效期 30 天符合大多數活動週期,可依需求調整

3. 無障礙支援

  • role="button" tabindex="0":讓非按鈕元素可聚焦、可鍵盤操作
  • aria-label:螢幕報讀器朗讀提示
  • :focus 樣式:鍵盤導航可見焦點

進階擴充:使用者可重新開啟背景

若需讓使用者「再次開啟背景」,可在隱藏狀態下顯示「開啟背景」按鈕:

function toggleBackground(hide) {
  if (hide) {
    // ... 隱藏邏輯
    $btn.hide();
    $('#openBgBtn').show();  // 顯示開啟按鈕
  } else {
    // ... 顯示邏輯
    $btn.show();
    $('#openBgBtn').hide();
  }
}

$('#openBgBtn').on('click', function() {
  toggleBackground(false);
});

現代替代方案:localStorage

Cookie 會隨每次 HTTP 請求發送,增加頻寬。若無需伺服器端讀取偏好,建議改用 localStorage:

// 寫入
localStorage.setItem('hideBgPref', '1');
// 讀取
var hidden = localStorage.getItem('hideBgPref') === '1';
// 移除(重置偏好)
localStorage.removeItem('hideBgPref');

優點:不隨請求發送、容量大 (5MB)、無過期時間。缺點:無法由伺服器端讀取、無法設定自動過期。

總結

背景圖顯示控制看似簡單,涉及 DOM 操作、CSS 狀態管理、Cookie/本地儲存、無障礙存取等多層面。採用「類別切換 + Cookie 記憶 + 完整無障礙」模式,能提供穩定、可維護、使用者友善的體驗。現代專案建議優先使用 localStorage,並搭配 CSS Custom Properties 管理主題變數。

copyright © 萬盛學電腦網 all rights reserved