萬盛學電腦網

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

JavaScript 動態操作 CSS Class 完整指南:原生 classList vs jQuery

前言

動態切換樣式類是前端交互的基礎操作。現代瀏覽器原生 Element.classList API 已提供極佳支援,配合舊專案常見的 jQuery addClass/removeClass/toggleClass,本文將兩者對比並給出最佳實踐。

原生 classList API(推薦)

支援:IE10+、所有現代瀏覽器。IE9 以下需 Polyfill。

核心方法

方法說明回傳值
add(String...)新增一或多個 classundefined
remove(String...)移除一或多個 classundefined
toggle(String[, force])切換;force=true 強制新增,false 強制移除Boolean(是否包含)
contains(String)檢查是否包含Boolean
replace(old, new)替換 classBoolean
item(index)按索引取得 classString/null
lengthclass 數量Number
toString()轉為空格分隔字串String

實戰範例

<style>
  .box { width:100px; height:100px; background:#ddd; transition:all .3s; }
  .active { background:#007bff; color:#fff; transform:scale(1.1); }
  .disabled { opacity:.5; pointer-events:none; }
</style>

<div id="box" class="box">點擊切換</div>
<button id="btnToggle">Toggle active</button>
<button id="btnDisable">Toggle disabled</button>

<script>
var box = document.getElementById('box');

document.getElementById('btnToggle').onclick = function () {
  box.classList.toggle('active');
};

document.getElementById('btnDisable').onclick = function () {
  box.classList.toggle('disabled');
};

// 批量新增
box.classList.add('shadow', 'rounded', 'animated');

// 替換
box.classList.replace('animated', 'pulse');
</script>

jQuery 寫法(舊專案維護)

// 單一
$('#box').addClass('active');
$('#box').removeClass('active');
$('#box').toggleClass('active');

// 多個
$('#box').addClass('shadow rounded animated');
$('#box').toggleClass('active disabled');

// 條件切換
$('#box').toggleClass('active', someCondition); // true→add, false→remove

// 回調函式(動態決定)
$('#items li').toggleClass('highlight', function (index, currentClass) {
  return index % 2 === 0; // 偶數行高亮
});

原生 vs jQuery 差異對照

場景原生 classListjQuery
多 class 一次操作add('a','b') / toggle('a','b')(不支援 toggle 多參數)addClass('a b') / toggleClass('a b')
條件式 toggletoggle('x', condition)toggleClass('x', condition)
替換 classreplace('old','new')需 removeClass('old').addClass('new')
迭代器模式手寫 forEach.each(fn) 內建
SVG 元素支援✅ 完整支援⚠️ 部分版本有 bug
效能極高(原生)略低(封裝層)

通用工具函式封裝(無依賴)

var ClassUtil = {
  has: function (el, cls) {
    return el.classList ? el.classList.contains(cls) :
           new RegExp('(^|\\s)' + cls + '(\\s|$)').test(el.className);
  },
  add: function (el, cls) {
    if (el.classList) {
      el.classList.add(cls);
    } else if (!this.has(el, cls)) {
      el.className += ' ' + cls;
    }
  },
  remove: function (el, cls) {
    if (el.classList) {
      el.classList.remove(cls);
    } else if (this.has(el, cls)) {
      el.className = el.className.replace(new RegExp('(^|\\s)' + cls + '(\\s|$)'), ' ').trim();
    }
  },
  toggle: function (el, cls, force) {
    if (el.classList) {
      return el.classList.toggle(cls, force);
    }
    if (force === undefined) force = !this.has(el, cls);
    force ? this.add(el, cls) : this.remove(el, cls);
    return force;
  }
};

CSS 側重點:善用 Class 而非 Inline Style

  • 關注點分離:JS 僅管狀態,CSS 管外觀
  • 效能:Class 切換觸發單次重繪,inline style 可能觸發多次
  • 動畫:配合 transition/animation 實現平滑過渡
  • 維護:設計師可獨立調整樣式無需動 JS

常見陷阱與避坑

  1. 空白字符:className = 'a b' 直接覆寫會丟失原有 class,務必用 classList 或工具函式
  2. 大小寫敏感:HTML class 不區分大小寫,但 CSS 選擇器區分,統一用小寫連字符
  3. SVG 元素:svgElement.className 回傳 SVGAnimatedString,必須用 classList 或 className.baseVal
  4. 重複添加:classList.add('x','x') 不會重複,安全

結語

現代專案首選原生 classList,零依賴、高效能、API 直觀。舊專案維護時,jQuery 寫法仍可用,但建議逐步遷移至原生或輕量工具函式,減少體積與依賴。

copyright © 萬盛學電腦網 all rights reserved