做彈出式 dialog 時需要知道父頁面的尺寸來計算置中位置。這個看似簡單的需求,卻有好幾個看起來對、實際上錯的屬性。
嘗試了 document.body.clientWidth、window.screen.width、document.body.scrollWidth 這幾種方式之後,發現結果都不是想要的。這些屬性各有不同的語意:
document.body.clientWidth:body 元素的內容寬度。若 body 有 margin 或 padding,或是內容比視窗窄,數值就不等於視窗寬度。
window.screen.width:實體螢幕的解析度,不是瀏覽器視窗大小。使用者沒最大化視窗時,這個值完全對不上。
document.body.scrollWidth:內容的完整寬度,包含溢出部分。內容超出視窗時會大於視窗,反而更少或小於視窗時又不會自動撐滿。
最後找到的是這兩個:
window.innerWidth
window.innerHeight
它們回傳的是瀏覽器視窗的實際可視區域,包含捲軸。這正是計算置中位置需要的數值。
當時的解法值得分享:在需要取值的地方加上 debugger 斷點,等程式暫停後在監看視窗裡輸入 document.body,逐一檢視 body 的所有屬性,看哪個結果符合需求。若都不合用,再輸入 window,翻一遍 window 上的屬性。innerWidth 與 innerHeight 就是這樣找到的。
這個方法比胡乱試錯有效率得多,而且順便釐清了各屬性的實際行為。瀏覽器開發者工具的 Elements 面板中, also 可以直接對元素 hover 顯示其 computed 尺寸。
視窗可視區域:window.innerWidth / innerHeight(含捲軸)、document.documentElement.clientWidth / clientHeight(不含捲軸)。
文件完整尺寸:document.documentElement.scrollWidth / scrollHeight。
螢幕實體尺寸:screen.width / height、screen.availWidth / availHeight(扣除工作列)。
function openDialog(el) {
var w = window.innerWidth;
var h = window.innerHeight;
el.style.left = ((w - el.offsetWidth) / 2) + 'px';
el.style.top = ((h - el.offsetHeight) / 2) + 'px';
}
其實用 CSS 一行就能做到,不必算:
.dialog {
position: fixed;
inset: 0;
margin: auto;
width: max-content;
height: max-content;
}
或者更簡潔的:
.dialog {
position: fixed;
left: 50%; top: 50%;
transform: translate(-50%, -50%);
}
用 CSS 的好處是視窗尺寸變化時會自動重新置中,不必監聽 resize 事件重算。
行動裝置上的 innerHeight 會變動。手機瀏覽器的網址列會在捲動時收合,導致 innerHeight 動態改變。若需要穩定的視窗高度,用 100dvh(dynamic viewport height)這個 CSS 單位,或監聽 resize 重新計算。
先算後顯示。若元素在 display: none 狀態下,offsetWidth 會是 0,位置就算錯了。請先讓它可見(visibility: hidden 或 display: block)再取值定位。