操作樣式是 jQuery 最常被使用的能力之一。這份筆記把 CSS 相關的 API 分成三類來記:基本屬性、尺寸、位置。
| 方法 | 說明 |
|---|---|
css(name) | 取得元素 CSS 規則中 name 屬性的值。 |
css(name, value) | 設定單一屬性。 |
css(name, fn(index, value)) | 以函數回傳值作為屬性值,函數會收到元素索引與目前值。 |
css({name1:value1, …, nameN:valueN}) | 一次設定多個屬性,是實務上最常用的形式。 |
值得留意的是,css() 的 getter 回傳的是 computed style,也就是瀏覽器計算後的實際值。這意味著即使你在樣式表裡寫 color: red,讀出來會是 rgb(255, 0, 0);寫 width: 50%,讀出來會是換算後的像素值。另外,設定時的屬性名可用駝峰式(backgroundColor)也可用連字號('background-color'),jQuery 兩者都接受。
| 方法 | 說明 |
|---|---|
height() | 取得元素 CSS 屬性 height 的值。 |
width() | 取得元素 CSS 屬性 width 的值。這兩個方法回傳的是元素在頁面中的實際尺寸,單位為數字(像素),因此可以直接拿來做數學運算,非常方便。 |
innerHeight() | 內部區域高度,含 padding,不含 border 與 margin。 |
innerWidth() | 內部區域寬度,含 padding。 |
outerHeight() | 外部區域高度,含 padding 與 border。 |
outerWidth() | 外部區域寬度,含 padding 與 border。若傳入 true 參數,即 outerHeight(true) 或 outerWidth(true),則會把 margin 也計入。 |
記憶方式很直覺:inner 是「裡面」(padding),outer 是「外面」(padding + border),加上 true 才是「最外面」(+ margin)。做居中計算時通常要用 outer,因為那才是元素實際佔據的視覺空間。
| 方法 | 說明 |
|---|---|
offset() | 取得元素相對於當前視窗的偏移,回傳含 top 與 left 的物件,例如 $("p").offset().top。此方法只對可見元素有效,隱藏元素會回傳 0。 |
offset(coord) | 設定偏移位置,參數為物件,例如 $("p").offset({"top":40, "left":15})。 |
offset(fn(index, coord)) | 以函數決定每個元素的偏移。 |
position() | 取得元素相對於最近定位祖先元素(offsetParent)的偏移,同樣回傳含 top 與 left 的物件。 |
scrollTop() | 取得垂直捲軸相對於元素最頂端的偏移值。 |
scrollTop(value) | 設定垂直捲動位置。 |
scrollLeft() | 取得水平捲軸相對於元素最左端的偏移值。 |
scrollLeft(value) | 設定水平捲動位置。這兩個方法的預設單位為 px;若 value 為負值,捲軸會移到最頂端或最左端;若超出最大值,則移到最底端或最右端。 |
offset() 與 position() 的差異是很多人混淆的點:offset 是相對文件(視窗),position 是相對定位父元素。實作浮動提示、拖曳、彈出定位時,通常要的是 offset;而在某個 position: relative 的容器內部放東西,則用 position 比較合適。