瀏覽器之間的相容性問題,讓「取得寬高與位置」這件事在原生 JavaScript 裡變得相當痛苦。jQuery 提供了簡潔又跨瀏覽器的解法。
// 瀏覽器可視區域的高度
$(window).height();
// 瀏覽器可視區域的寬度
$(window).width();
// 文件的實際高度
$(document.body).height();
// 文件的實際寬度
$(document.body).width();
這兩組經常被搞混:$(window) 是使用者當下看得到的範圍,$(document) 則是包含捲動部分的完整內容。做固定頁首或浮動側欄時,兩者的差異就是關鍵。
// 距離頂部的垂直捲動量
$(document).scrollTop();
// 距離左側的水平捲動量
$(document).scrollLeft();
指定參數時也能反過來「設定」捲動位置,例如回到頁首:
$("html, body").animate({ scrollTop: 0 }, "slow");
offset 回傳集合中第一個元素的位移資訊,預設是相對於 body,結果物件包含 top 與 left 兩個屬性。
offset(options, results)
| 參數 | 說明 | 預設值 |
|---|---|---|
| options.relativeTo | 指定作為計算基準的祖先元素,該元素應為 relative 或 absolute 定位。省略則以 body 為基準 | body |
| options.scroll | 是否把捲動量計入 | true |
| options.padding | 是否把 padding 計入 | false |
| options.margin | 是否把 margin 計入 | true |
| options.border | 是否把邊框計入 | true |
兩者都回傳 top/left,但含義不同:offset() 是相對於文件的絕對位置,position() 是相對於最近的定位祖先元素。做拖曳或絕對定位的浮層時,選錯方法就會出現「位置莫名其妙偏掉」的狀況。
var pos = $("#myBox").offset();
console.log("頁面座標:" + pos.left + ", " + pos.top);
var inner = $("#myBox").position();
console.log("相對於父層:" + inner.left + ", " + inner.top);
實務上的判斷很簡單:要拿去和滑鼠座標(event.pageX / pageY)比對時用 offset();要拿去設定元素的 CSS left / top 時,通常該用 position()。