JavaScript 中那些關於座標和距離的屬性與方法

樂亦慄發表於2019-05-27
JavaScript

一 前言

在前端開發中總會遇到各種各樣需要使用或計算座標和距離的情況，但是這些屬性和方法眾多，全部熟練地記下來並非是一件易事，大多隻能現查，耗費不少時間精力，於是便有了整理記錄的想法，即加深了印象，又方便隨時查閱。

二 window 物件

瀏覽器裡面，window 物件（注意，w為小寫）指當前的瀏覽器視窗。

它也是當前頁面的頂層物件，即最高一層的物件，所有其他物件都是它的下屬。一個變數如果未宣告，那麼預設就是頂層物件的屬性。

摘自《阮一峰 JavaScript 教程》

位置大小屬性

window.screenX , window.screenY

只讀屬性

返回瀏覽器視窗左上角相對於當前螢幕左上角的水平距離和垂直距離（單位畫素）。

window.innerHeight , window.innerWidth

只讀屬性

返回網頁在當前視窗中可見區域的高度和寬度，即「視口」（viewport）的大小（單位畫素）。

注意，這兩個屬性包括滾動條的高度和寬度。

window.outerHeight , window.outerWidth

只讀屬性

返回瀏覽器視窗的高度和寬度，包括瀏覽器選單和邊框（單位畫素）。

window.scrollX , window.scrollY

只讀屬性

別名： window.pageXOffset , window.pageYOffset

分別返回頁面的水平滾動距離和垂直滾動距離，單位都是畫素。

注意，這兩個屬性的返回值不是整數，而是雙精度浮點數。如果頁面沒有滾動，它們的值就是0。

摘自《阮一峰 JavaScript 教程》

為了跨瀏覽器相容性，請使用 window.pageXOffset 代替 window.scrollX。另外，舊版本的 IE（<9）兩個屬性都不支援，必須通過其他的非標準屬性來解決此問題。

摘自 MDN ：developer.mozilla.org/zh-CN/docs/…

window 物件的方法

window.scrollTo() , window.scroll() , window.scrollBy()

window.scrollTo 方法 ---> 別名： window.scroll 方法

用於將文件滾動到指定位置。

它接受兩個引數，表示滾動後位於視窗左上角的頁面座標。

也可以接受一個配置物件作為引數。

window.scrollTo(options)
複製程式碼

配置物件 options 有三個屬性。

  • top：滾動後頁面左上角的垂直座標，即 y 座標。
  • left：滾動後頁面左上角的水平座標，即 x 座標。
  • behavior：字串，表示滾動的方式，有三個可能值（smooth、instant、auto），預設值為 auto。

window.scrollBy 方法用於將網頁滾動指定距離（單位畫素）。

它接受兩個引數：水平向右滾動的畫素，垂直向下滾動的畫素。

注意：仔細體會這兩者的差別。

三 Element 節點

Element節點物件對應網頁的 HTML 元素。每一個 HTML 元素，在 DOM 樹上都會轉化成一個Element節點物件（簡稱元素節點）。

相關屬性

Element.clientHeight，Element.clientWidth

分別返回元素的高度和寬度，始終是整數值。

如果該元素是內聯元素（display: inline;），則返回值為 0。

從盒模型的概念上來講，返回的數值計算包括元素的 content 和 padding ，不包括 border 和 margin 。

如果有滾動條，返回的數值會減去滾動條佔據的寬度或高度。（即不包含滾動條在內）

// 瀏覽器視口高度
document.documentElement.clientHeight

// 網頁總高度
document.body.clientHeight
複製程式碼

Element.clientLeft，Element.clientTop

分別返回元素的左邊框寬度和上邊框寬度，沒有邊框則返回 0。

同樣不支援內聯元素。

（我沒太明白這兩個屬性有啥作用……）

Element.scrollHeight，Element.scrollWidth

返回當前元素的總高度和總寬度，包括溢位容器、當前並不可見的部分。

包括 padding 區域。

包括偽元素的寬度和高度。

不包含滾動條的寬度和高度。

來個小 demo 輔助下理解：

<div class="box"> 666 </div>
複製程式碼
.box {
  width: 200px; height: 200px; overflow: hidden;
  border: 1px solid red; padding: 10px; position: relative;
}
.box::after {
  position: absolute; content: '';
  width: 100px; height: 100px; left: 100%;
}
複製程式碼
let box = document.querySelector('.box')
console.log(box.scrollWidth) // 320
console.log(box.scrollHeight) // 220
複製程式碼

可以看到 box 元素的 scrollHeight 是 220，這個和我們提到的「包括 padding 區域」相符合。

那 box 元素的 scrollWidth 為啥是 320 ？ 是因為偽元素的位置和寬度，雖然偽元素溢位被隱藏了，但是這個屬性返回的數值依然包括它。

當然不僅僅包括它的寬度和高度，它所處的位置也會計算在內。

比如把偽元素的 css 改一下：

.box::after {
  position: absolute; content: '';
  width: 100px; height: 100px;
  left: 120%; top: 120%;
}
複製程式碼

現在你要不要猜一下 box 的 scrollWidth 和 scrollHeight 分別是多少？

Element.scrollLeft，Element.scrollTop

可讀寫，設定該屬性的值，會導致瀏覽器將當前元素自動滾動到相應的位置。

分別返回當前元素的水平滾動距離和垂直滾動距離。

對於那些沒有滾動條的網頁元素，這兩個屬性總是等於 0。

如果要檢視整張網頁的水平的和垂直的滾動距離，要從 document.documentElement 元素上讀取。

document.documentElement.scrollLeft
document.documentElement.scrollTop
複製程式碼

Element.offsetHeight，Element.offsetWidth

分別返回元素的高度和寬度，包括元素本身的高和寬、padding 和 border ，以及滾動條的高和寬。

如果元素的 display 為 none，則返回 0。

與 clientHeight 和 clientWidth 相比，我想這對屬性用的更多一點，因為更多的時候我們需要獲取的是元素的完整寬高。

Element.offsetLeft，Element.offsetTop

返回當前元素左上角相對於 Element.offsetParent 節點的水平和垂直位移。

說到這個我們來了解下 Element.offsetParent：

Element.offsetParent 屬性返回最靠近當前元素的、並且 CSS 的 position 屬性不等於 static 的上層元素。

如果該元素是不可見的（display屬性為none），或者位置是固定的（position屬性為fixed），則offsetParent屬性返回null。

如果某個元素的所有上層節點的position屬性都是static，則Element.offsetParent屬性指向元素。

摘自《阮一峰 JavaScript 教程》

相關方法

Element.getBoundingClientRect()

返回一個物件，提供當前元素的大小、位置等資訊。

我常用來它獲取元素的寬高和座標。

該物件有如下屬性：

  • width
  • height
  • x 元素左上角相對於 視口 的橫座標
  • y
  • left
  • right
  • top
  • bottom

由於元素相對於視口（viewport）的位置，會隨著頁面滾動變化，因此表示位置的四個屬性值，都不是固定不變的。如果想得到絕對位置，可以將 left 屬性加上 window.scrollX ， top 屬性加上 window.scrollY。

摘自《阮一峰 JavaScript 教程》

四 滑鼠事件

MouseEvent 介面

let event = new MouseEvent('click', {
    // ...
})
複製程式碼

通過 addEventListener 新增的 click 事件所產生的事件物件也是 MouseEvent 例項。

let box = document.querySelector('.box')

box.addEventListener('click', (e) => {
  console.log(e) // 事件物件
})
複製程式碼

這個事件物件，也就是 MouseEvent 例項，有很多屬性，這裡來簡單分析一下。

MouseEvent.clientX 和 MouseEvent.clientY

只讀屬性

分別返回滑鼠位置相對於 瀏覽器視窗 左上角的水平座標和垂直座標。（不受滾動距離的影響）

可以這樣理解：

client 本來就是客戶端的意思，web 中的客戶端就是瀏覽器，那 clientX 和 clientY 自然就是相對於瀏覽器的位置了。

這兩個屬性還分別有一個別名 MouseEvent.x 和 MouseEvent.y 。

MouseEvent.screenX，MouseEvent.screenY

只讀屬性

分別返回滑鼠位置相對於 螢幕（顯示器螢幕區域） 左上角的水平座標和垂直座標。

screen 是螢幕的意思，所以，你懂的。

MouseEvent.offsetX，MouseEvent.offsetY

只讀屬性

分別返回滑鼠位置相對於 目標節點（即當前元素） 左上角 padding 邊緣 的 水平距離和垂直距離。

offset 有偏移的意思，所以這裡也可以理解為滑鼠位置相對於目標元素內部左上角的偏移值，和目標元素本身以及外部的元素都無關。

那 「padding 邊緣」是什麼意思呢？

我們拿圖說話：

offsetX 和 offsetY

上圖中三個元素分別有紅藍綠三種邊框來區分，紅藍邊框寬度為 1px ， 綠邊框為 30px 。每個元素都有 padding 值。具體程式碼如下：

<!-- HTML -->
<body>
  <div class="parent">
    <div class="hello">Hello</div>
  </div>
</body>
複製程式碼
/* css */
body {
  border: 1px solid red; margin: 0; padding: 20px;
}
.parent {
  border: 1px solid blue; padding-top: 50px;
}
.hello {
  width: 100px; height: 100px; padding: 100px; border: 30px solid green;
}
複製程式碼

我們給 hello 元素新增一個 click 時間監聽函式：

// js
let hello = document.querySelector('.hello')

hello.addEventListener('click', (e) => {
  console.log(e)
  console.log(e.offsetX)
  console.log(e.offsetY)
})

複製程式碼

分別點選 hello 元素的綠色邊框和空白區域，會發現前者的值為負數，後者的值為整數，且都是相對空白區域的左上角開始計算的。

這就是我們一開始提到的 「滑鼠位置相對於 目標節點（即當前元素） 左上角 padding 邊緣 的 水平距離和垂直距離」 這句話的意思。

MouseEvent.pageX，MouseEvent.pageY

只讀屬性

分別返回滑鼠位置相對於文件左上角的距離。（包括滾動距離）

MouseEvent.movementX，MouseEvent.movementY

只讀屬性

返回當前位置與上一個 mousemove 事件之間的水平距離和垂直距離。

很明顯這兩個屬性和 mousemove 事件肯定有著密切的關係，所以我們再瞭解一下 mousemove 事件：

當滑鼠在一個節點內部移動時觸發。當滑鼠持續移動時，該事件會連續觸發。為了避免效能問題，建議對該事件的監聽函式做一些限定，比如限定一段時間內只能執行一次。

說到這個應該會牽扯到「節流」，暫不深入了。

這兩個屬性還是很有用的，我雖然沒咋用過，不過目前想來可以用來判斷滑鼠的移動方向等。

參考連結：

window 物件 - WangDoc.com

Element 節點 - WangDoc.com

滑鼠事件 - WangDoc.com

（完）

相關文章