動態切換樣式類是前端交互的基礎操作。現代瀏覽器原生 Element.classList API 已提供極佳支援,配合舊專案常見的 jQuery addClass/removeClass/toggleClass,本文將兩者對比並給出最佳實踐。
classList API(推薦)支援:IE10+、所有現代瀏覽器。IE9 以下需 Polyfill。
| 方法 | 說明 | 回傳值 |
|---|---|---|
add(String...) | 新增一或多個 class | undefined |
remove(String...) | 移除一或多個 class | undefined |
toggle(String[, force]) | 切換;force=true 強制新增,false 強制移除 | Boolean(是否包含) |
contains(String) | 檢查是否包含 | Boolean |
replace(old, new) | 替換 class | Boolean |
item(index) | 按索引取得 class | String/null |
length | class 數量 | 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>
// 單一
$('#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; // 偶數行高亮
});
| 場景 | 原生 classList | jQuery |
|---|---|---|
| 多 class 一次操作 | add('a','b') / toggle('a','b')(不支援 toggle 多參數) | addClass('a b') / toggleClass('a b') |
| 條件式 toggle | toggle('x', condition) | toggleClass('x', condition) |
| 替換 class | replace('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;
}
};
transition/animation 實現平滑過渡className = 'a b' 直接覆寫會丟失原有 class,務必用 classList 或工具函式svgElement.className 回傳 SVGAnimatedString,必須用 classList 或 className.baseValclassList.add('x','x') 不會重複,安全現代專案首選原生 classList,零依賴、高效能、API 直觀。舊專案維護時,jQuery 寫法仍可用,但建議逐步遷移至原生或輕量工具函式,減少體積與依賴。