萬盛學電腦網

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

jQuery css() 方法完整指南:單一/批量設值、獲取計算值、單位處理與效能

`.css()` 是 jQuery 操作樣式的核心方法,支援單一/批量設值、獲取計算後值、自動單位補齊、CSS Hooks 擴展。本文涵蓋所有用法、常見坑點與原生替代方案。

基本語法

// 獲取單一屬性 (回傳計算值,含單位)
$('#box').css('width');        // "300px"
$('#box').css('background-color'); // "rgb(255, 0, 0)"

// 設定單一屬性
$('#box').css('width', '400px');
$('#box').css('width', 400);   // 數字自動補 'px' (部分屬性除外)

// 批量設定 (物件字面量)
$('#box').css({
  width: '50%',
  height: 200,
  'background-color': '#f00',
  marginTop: 10   // 駝峰或連字號皆可
});

// 回調函式設定 (根據索引/舊值動態計算)
$('li').css('color', (i, val) => i % 2 ? 'red' : 'blue');

獲取值的細節

  • 回傳計算值(Computed Style),非原始樣式表值。如 `width: 50%` → 回傳 `"300px"`。
  • 顏色統一回傳 `rgb(r, g, b)` 或 `rgba(...)`,不回傳 hex/hsl。
  • 簡寫屬性(`margin`, `border`, `background`)不可獲取,需拆分長屬性。
  • 多元素集合:`.css('prop')` 僅回傳第一個元素的值。

CSS Hooks:擴展自定義屬性處理

$.cssHooks['rotate'] = {
  get: (elem, computed, extra) => $.css(elem, 'transform').match(/rotate\(([^)]+)\)/)?.[1] || '0deg',
  set: (elem, value) => {
    const current = $.css(elem, 'transform') || 'none';
    elem.style.transform = current.replace(/rotate\([^)]+\)/, '') + ` rotate(${value})`;
  }
};
$('#box').css('rotate', '45deg'); // 如原生屬性般操作

常見坑點

原生替代:`element.style` / `getComputedStyle`

// 設定內聯樣式
el.style.width = '300px';
el.style.setProperty('color', 'red', 'important'); // 支援 !important

// 獲取計算值
getComputedStyle(el).width; // "300px"

// 批量設定 (CSSStyleDeclaration 無批量 API,需迴圈)
Object.assign(el.style, { width: '300px', color: 'red' });

效能建議

  • 頻繁變更樣式 → 定義 CSS 類別,切換 `classList`。
  • 動畫 → CSS `transition`/`animation` 或 Web Animations API。
  • 必須 JS 計算樣式 → 讀寫分離,先讀取所有需求值,再一次性寫入,避免強制同步佈局。

`.css()` 便利但非萬能,理解其獲取計算值特性與重排成本,配合 CSS 類別策略,才能兼顧開發效率與執行效能。

copyright © 萬盛學電腦網 all rights reserved
問題原因解決
設定 `width: '50%'` 獲取卻是 `'300px'`回傳計算值需獲取原始值用 `style.width` 或 `attr('style')` 解析
批量設定無效屬性名需駝峰或加引號`marginTop` 或 `'margin-top'`
大量元素迴圈 `.css()` 極慢每次觸發重排/重繪改用 CSS 類別切換、或 `DocumentFragment` 批量構建
`!important` 無法透過 `.css()` 設定API 限制用 `.css('cssText', 'color:red!important;')` 或切換類別