jQuery 當年最迷人的地方,是它讓「選到元素之後要做什麼」變得非常直覺,而樣式操作正是最常被用到的一塊。從單一屬性設定到 class 切換、從尺寸讀取到滾動位置,這篇文章把 jQuery 的 CSS 相關 API 一次梳理清楚,並說明在什麼時機該用哪一種。
.css() 是最直接的樣式操作,同時肩負 getter 與 setter 兩種角色:
// 讀取(回傳字串,可能是 computed style)
$('#box').css('color');
// 單一設定
$('#box').css('color', 'red');
// 多屬性一次設定,物件語法可讀性最好
$('#box').css({
color: '#333',
fontSize: '14px',
marginTop: '10px'
});
幾個容易踩到的細節:屬性名稱可用 camelCase 也可用連字號;數字值不會自動加單位(除了 zIndex 等少數例外),需要時要自己補 'px';讀取時若元素在隱藏狀態,尺寸類的值可能不合理。
直接寫 inline style 會產生優先權過高、難以維護的問題。實務上更推薦把樣式寫在 CSS 檔,用 class 控制狀態:
el.addClass('is-active'); // 加上
el.removeClass('is-active'); // 移除
el.toggleClass('is-open'); // 有則移除、無則加上
el.toggleClass('is-open', cond); // 依條件決定
el.hasClass('is-active'); // 判斷(回傳布林)
動畫或過渡效果也應寫在 CSS 的 transition 裡,讓 jQuery 只負責切換 class,效能與可維護性都更好。
這是舊 code 常見的 bug 來源:checked、selected、disabled 這類屬性反映的是元素的「目前狀態」,應使用 prop();而 class、id、data-* 這類是 HTML 上的「初始設定」,用 attr()。jQuery 1.6 之後兩者已明確分家,混用會得到看似矛盾的結果。
el.width(); // 內容寬(不含 padding、border) el.innerWidth(); // 含 padding el.outerWidth(); // 含 padding 與 border el.outerWidth(true); // 再加上 margin el.height(); el.innerHeight(); el.outerHeight(true);
設定時同理,傳入數值即可,jQuery 會補上 px。
el.offset(); // 相對文件的座標 { top, left }
el.position(); // 相對 offsetParent 的座標
el.offset({ top: 100, left: 200 }); // 可寫入
$(window).scrollTop(); // 讀取垂直滾動量
$(window).scrollTop(500); // 滾動到指定位置
$(window).scrollTop() + $(window).height() >= $(document).height(); // 是否到底
<style>
.panel { max-height: 0; overflow: hidden;
transition: max-height .3s ease; }
.panel.is-open { max-height: 400px; }
</style>
<button id="toggle">展開</button>
<div class="panel"><p>內容...</p></div>
<script>
$('#toggle').on('click', function () {
const panel = $('.panel');
panel.toggleClass('is-open');
$(this).text(panel.hasClass('is-open') ? '收起' : '展開');
});
</script>
動畫交給 CSS,狀態判斷交給 jQuery,這就是現代寫法與「用 animate() 逐格改 height」舊寫法的差別。
jQuery 的 CSS API 簡單到不需要背,但「用 jQuery 改樣式」與「用 jQuery 切換狀態」是兩種不同層次的寫法。學會把視覺狀態交給 CSS、把行為交給 JavaScript,你就掌握了這套 API 的真正用法。