在很多场景下我们需要通过JavaScript来获取视口或DOM元素的大小、位置以及滚动高度。最常见的一个效果,导航吸顶的一个效果。那么今天就来学习这方面相关的知识。
window
和 document
在开始了解视口宽高、位置和滚动高度相关的知识之前,先简单的来了解window
和document
。在学习新的API之前,我都喜欢在调式工具中将对应的API打印出来。比如:
window
对象表示一个包含DOM文档的窗口,其document
属性指向窗口中截入的DOM文档。window
对象实现了Window
接口。一些额外的全局函数、命名空间、对象、接口和构造函数与window
没有典型的关联,但却是有效的,它们在JavaScript参考和DOM参考中列出。
再把document
打印出来:
Document
接口提供了一些在浏览器服务中作为页面内容入口点而加载的一些页面,也就是DOM树。DOM树包括诸如<body>
、<head>
以及其他元素。其也为document
提供了全局性的函数,例如获取页面的URL
,在文档中创建新的元素的函数。
两者之间的区别:
Window
对象表示浏览器中打开的窗口;window
对象可以省略。比如alert()
、window.alert()
Document
对象是Window
对象的一部分。那么document.body
就可以写成window.document.body
。浏览器的HTML文档成为Document
对象
视口宽高
这里的视口指的是浏览器窗口。在JavaScript中,可以通过window.innerHeight
和window.outerHeight
获取整个窗口的高度,window.innerWidth
和window.outerWidth
获取整个窗口的宽度。
上图展示的是浏览器视口的高度的。
属性名 | 描述 | 备注 |
---|---|---|
window.innerHeight | 浏览器窗口高度,如果存在水平滚动条,则包括滚动条 | 只读属性,没有默认值 |
window.outerHeight | 浏览器窗口整个高度,包括窗口标题、工具栏、状态栏等 | 只读属性,没有默认值 |
window.innerWidth | 浏览器窗口宽度,如果存在垂直滚动条,则包括滚动条 | 只读属性,没有默认值 |
window.outerWidth | 浏览器窗口整个宽度,包括侧边栏,窗口镶边和调正窗口大小的边框 | 只读属性,没有默认值 |
看一个实际页面:
注意:IE8及以下版本不支持
window.innerHeight
和window.innerWidth
等属性。
对于不支持window.innerHeight
等属性的浏览器中,可以读取documentElement
和body
的高度。它们的大小和window.innerHeight
是一样的。事实上也略有不同。
document.documentElement.clientHeight
document.body.clientHeight
其中documentElement
是文档根元素,就是<html>
标签;body
就是<body>
元素:
而document.documentElement.clientHeight
和document.body.clientHeight
区别在于:
document.documentElement.clientHeight
:不包括整个文档的滚动条,但包括<html>
元素的边框document.body.clientHeight
:不包括整个文档的滚动条,也不包括<html>
元素的边框,也不包括<body>
的边框和滚动条
挂靠在window
下的宽高还有window.screen
,window.screen
包含有关于用户屏幕的信息。它包括:
window.screen.width
:显示器屏幕的宽度window.screen.height
:显示器屏幕的高度window.screen.availHeight
:浏览器窗口在屏幕上可占用的垂直空间,即最大高度window.screen.availWidth
:返回浏览器窗口可占用的水平宽度window.screenTop
:浏览器窗口在屏幕上的可占用空间上边距离屏幕上边界的距离window.screenLeft
:返回浏览器可用空间左边距离屏幕(系统桌面)左边界的距离
除此之外,还有偏移量的控制:
offsetHeight
:元素的像素高度,高度包含该元素的垂直内边距和边框,且是一个整数。通常,元素的offsetHeight
是一种元素CSS高度的衡量标准,包括元素的边框、内边距和元素的水平滚动条(如果存在且渲染的话),不包含:before
或:after
等伪类元素的高度。对于文档的body
对象,它包括代替元素的CSS高度线性总含量高。浮动元素的向下延伸内容高度是被忽略的。
offsetWidth
:一个元素的布局宽度。offsetWidth
是测量包含元素的边框、水平线上的内边距、竖直方向滚动条以及CSS设置的宽度的值。
offsetLeft
:当前元素左上角相对于offsetParent
节点的左边界偏移的像素值。对块级元素来说,offsetTop
、offsetLeft
、offsetWidth
及 offsetHeight
描述了元素相对于 offsetParent
的边界框。然而,对于可被截断到下一行的行内元素(如 span
),offsetTop
和 offsetLeft
描述的是第一个边界框的位置(使用 Element.getClientRects()
来获取其宽度和高度),而 offsetWidth
和 offsetHeight
描述的是边界框的尺寸(使用 Element.getBoundingClientRect
来获取其位置)。因此,使用 offsetLeft
、offsetTop
、offsetWidth
、offsetHeight
来对应 left
、top
、width
和 height
的一个盒子将不会是文本容器 span
的盒子边界。
offsetTop
:当前元素相对于其 offsetParent
元素的顶部的距离。
offsetParent
:返回一个指向最近的(closest
,指包含层级上的最近)包含该元素的定位元素。如果没有定位的元素,则 offsetParent
为最近的 table
元素对象或根元素(标准模式下为 html
;怪异模式下为 body
)。当元素的 style.display
设置为 none
或定位为fixed
时,offsetParent
返回 null
。
结合上面的,我们用一张图来阐述,更易帮我们理解:
简单的小结一下
那么我们常用位置和大小的计算,可以这样处理。都是基于浏览器的标准模式之下。
浏览器可视区宽高
// 不包含滚动条
// width
document.documentElement.clientWidth
// height
document.documentElement.clientHeight
// 包含滚动条(ie9+, 不是css规范)
// width
window.innerWidth
// height
window.innerHeight
其最佳的方式是:
let height = window.innerHeight || document.documentElement.clientHeight || document.body.clientHeight
let width = window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth
其实使用
offsetHeight
作为Fallback要比clientHeight
更好。
元素距离文档顶部距离
当offsetParent
为body
时,可以通过el.offsetTop
确定元素距离文档顶部大小。当offsetParent
不为body
时,就需要一层层循环至offsetParent
为null
。
function getTop(el) {
let top = el.offsetTop;
let currentParent = el.offsetParent;
while (currentParent != null) {
top += currentParent.offsetTop;
currentParent = currentParent.offsetParent;
}
return top;
}
元素距离文档左侧距离
元素距离文档左侧距离实现思路和上面的元素距离文档顶部距离的类似。当offsetParent
为body
时,可以通过el.offsetLeft
确定元素距离文档顶部大小。当offsetParent
不为body
时,就需要一层层循环至offsetParent
为null
。
function getLeft(el) {
let left = el.offsetLeft;
let currentParent = el.offsetParent;
while (currentParent != null) {
left += currentParent.offsetLeft;
currentParent = currentParent.offsetParent;
}
return left
}
滚动高度
与滚动scroll
相关的方法主要有window
对象下的scrollX
、scrollY
、scrollTo
和scroll
;Element
对象下的scrollWidth
、scrollHeight
、scrollLeft
和scrollTop
。
属性名称 | 描述 | 备注 |
---|---|---|
scrollX | 返回文档/页面水平方向滚动的像素值 | pageXOffset 是scrollX 的别名 |
scrollY | 返回文档在垂直方向已滚动的像素值 | pageYOffset 是 scrollY 的别名 |
scrollTo | 滚动到文档中的某个坐标 | 该函数实际上和 window.scroll 是一样的 |
scroll | 滚动窗口至文档中的特定位置 | window.scrollTo 同样能高效地完成同样的任务 |
scrollWidth | 返回元素的内容区域宽度或元素的本身的宽度中更大的那个值 | 若元素的宽度大于其内容的区域(例如,元素存在滚动条时), scrollWidth 的值要大于clientWidth |
scrollHeight | 一个元素内容高度的度量,包括由于溢出导致的视图中不可见内容 | 没有垂直滚动条的情况下,scrollHeight 值与元素视图填充所有内容所需要的最小值clientHeight 相同。包括元素的padding ,但不包括元素的border 和margin |
scrollLeft | 可以读取或设置元素滚动条到元素左边的距离 | 如果这个元素的内容排列方向(direction ) 是rtl (right-to-left) ,那么滚动条会位于最右侧(内容开始处),并且scrollLeft 值为0 。此时,当你从右到左拖动滚动条时,scrollLeft 会从0 变为负数 |
scrollTop | 可以获取或设置一个元素的内容垂直滚动的像素数 | 一个元素的 scrollTop 值是这个元素的顶部到它的最顶部可见内容(的顶部)的距离的度量。当一个元素的内容没有产生垂直方向的滚动条,那么它的 scrollTop 值为0 |
window.scrollX
和window.scrollY
两个属性在IE9以下的版本都未支持。如果我们要获取页面垂直和水平的滚动距离,我们一般这样来处理:
// 判断是否支持pageXOffset
let supportPageOffset = window.pageXOffset !== undefined
// 判断渲染模式是不是标准模式
let isCSS1Compat = ((document.compatMode || '') === 'CSS1Compat')
/**
* 如果支持pageXOffset,直接用window.pageXOffset。如果不支持,判断渲染模式
* 如果是标准模式,用document.documentElement.scrollLeft
* 如果是混合模式,用document.body.scrollLeft
**/
let x = supportPageOffset ? window.pageXOffset : isCSS1Compat ? document.documentElement.scrollLeft : document.body.scrollLeft
let y = supportPageOffset ? window.pageYOffset : isCSS1Compat ? document.documentElement.scrollTop : document.body.scrollTop
而window.scrollTo()
不需要做兼容处理,可以直接使用,另外与window.scroll()
相同。window.scroll()
有两个参数:
x-coord
:值表示你想要置于左上角的像素点的横坐标y-coord
:值表示你想要置于左上角的像素点的纵坐标
scrollWidth
返回该元素区域宽度和自身宽度中较大的一个,若自身宽度大于内容宽度(存在滚动条),那么scrollWidth
将大于clientWidth
。需要注意的是,改属性返回的是四舍五入后的整数值,如果需要小数,则需要使用getBoundingClientRect()
。
scrollHeight
返回该元素内容高度。包括被overflow
隐藏掉的部分,包含padding
,但不包含margin
。和scrollWidth
类似,如果需要小数,则需要使用getBoundingClientRect()
。
这两个属性最常见的使用场景就是:判断元素是否滚动到底部,比如下面的代码,如果返回的值为true
,表示滚动到底部,反之则不是:
ele.scrollHeight - ele.scrollTop === ele.clientHeight。
特别是在移动端,经常会有下拉列表无限加载的需求。我们来看@Quickeryi提供的一个示例:
/**
* @param warp {DOM || null} 外层容器,当为null时,默认以整个文档结构为外容器
* @param threshold {Number} 滚动阀值,即可以设置一个值,当滚动到离地步还有一段距离时,就开始执行callback
* @param cb {Function} 回掉函数
*/
let scrollToLoad = (warp, threshold, cb) => {
let scrollTop = 0,
warpHeight,
listHeight,
_threshold_ = threshold || 0;
if (!warp) {
// 获取滚动条当前的位置
if (document.documentElement && document.documentElement.scrollTop) {
scrollTop = document.documentElement.scrollTop;
} else if (document.body) {
scrollTop = document.body.scrollTop;
}
// 获取当前可视范围的高度
if (document.body.clientHeight && document.documentElement.clientHeight) {
warpHeight = Math.min(document.body.clientHeight, document.documentElement.clientHeight);
} else {
warpHeight = Math.max(document.body.clientHeight, document.documentElement.clientHeight);
}
// 获取list完整的高度
listHeight = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight);
} else {
scrollTop = warp.scrollTop;
warpHeight = warp.clientHeight;
listHeight = warp.scrollHeight;
}
if (listHeight <= warpHeight + scrollTop - _threshold_) {
cb && cb();
}
}
scrollLeft
代表元素滚动条距离元素左边的多少像素,其值可以是任意整数,然而:
- 如果元素不能滚动,比如没有内容溢出,那么
scrollLeft
的值是0
- 如果给
scrollLeft
设置的值小于0
,那么其值将变为0
- 如果给
scrollLeft
设置的值大于元素内容最大宽度,那么其值将被设置为元素最大宽度
scrollTop
和scrollLeft
类似,只是方向不一样:
- 如果一个元素不能被滚动,内容未溢出,
scrollTop
将被设置为0
- 设置
scrollTop
的值小于0
,其值将被设为0
- 如果设置了超出这个容器可滚动的值, 其值将被设为最大值
比如我们要获取或设置页面垂直方向的滚动距离,我们就可以这样操作:
//获取滚轮滚动的距离,适配所有的浏览器
function getScrollY(){
return window.pageYOffset || document.documentElement.scrollTop;
}
//设置垂直方向滚轮滚动的距离,适配所有的浏览器,num为滚动距离
function setScrollY(num){
document.body.scrollTop = document.documentElement.scrollTop = num;
}
水平方向的同理,只需要将window.pageYOffset
更换成widnow.pageXOffset
,document.documentElement.scrollTop
更换成document.documentElement.scrollLeft
。
上面的两个小示例中,我们总是把window
下的scrollY
(pageYoffset
)、scrollX
(pageXoffset
)方法和element
下的scrollTop
、scrollLeft
方法混在一起用,其实这两个是有本质区别的。一个获取的是window
窗口的滚动距离,一个获取的是某一个元素的滚动距离,当获取的元素是body
时,window.scrollY(window.pageYoffset) = document.body.scrollTop
。
如果我们需要获取各种浏览器可见窗口大小的话,我们可以这样做:
function getWindowSizeInfo () {
let size = `网页可见区域宽度clientWidth: ${document.body.clientWidth},
网页可见区域高度clientHeight: ${document.body.clientHeight},
网页可见区域宽度offsetWidth: ${document.body.offsetWidth} (包括边线和滚动条宽度),
网页可见区域高度offsetHeight: ${document.body.offsetHeight} (包括边线的宽度),
网页正文全文宽度scrollWidth: ${document.body.scrollWidth},
网页正文全文高度scrollHeight: ${document.body.scrollHeight},
网页内容被卷去的高度scrollTop: ${document.body.scrollTop} (Firefox浏览器),
网页内容被卷去的高度scrollTop: ${document.documentElement.scrollTop} (IE浏览器),
网页内容被卷去的宽度scrollLeft: ${document.body.scrollLeft},
网页内容正文部分上screenTop: ${window.screenTop},
网页内容正文部分左screenLeft: ${window.screenLeft},
屏幕分辨率的高度height: ${window.screen.height},
屏幕分辨率的宽度width: ${window.screen.width},
屏幕可用区域高度availHeight: ${window.screen.availHeight},
屏幕可用区域宽度availWidth: ${window.screen.availWidth}`
return size
}
另外如果我们需要获取网页客户区的宽度、滚动条宽度、滚动条距离左边和顶部的距离,我们可以这样做:
function getClientAndScrollInfo() {
let clientWidth = clientHeight = scrollHeight = scrollWidth = scrollLeft = scrollTop = 0;
if (document.compatMode == 'BackCompat') {
clientWidth = document.body.clientWidth;
clientHeight = document.body.clientHeight;
scrollWidth = document.body.scrollWidth;
scrollHeight = document.body.scrollHeight;
scrollTop = document.body.scrollTop;
scrollLeft = document.body.scrollLeft;
} else {
clientWidth = document.documentElement.clientWidth;
clientHeight = document.documentElement.clientHeight;
scrollWidth = document.documentElement.scrollWidth;
scrollHeight = document.documentElement.scrollHeight;
scrollTop = document.documentElement.scrollTop;
scrollLeft = document.documentElement.scrollLeft;
}
return info = `
clientWidth: ${clientWidth}px,
clientHeight: ${clientHeight}px,
scrollWidth: ${scrollWidth}px,
scrollHeight: ${scrollHeight}px,
scrollTop: ${scrollTop}px,
scrollLeft: ${scrollLeft}px
`
}
总结
由于使用JavaScript检测视窗或元素有六个DOM的尺寸属性:offsetWidth
、offsetHeight
、clientWidth
、clientHeight
、scrollWidth
、scrollHeight
。再加上offsetTop
、offsetLeft
、scrollTop
、scrollLeft
、clientTop
和clientLeft
等方向距离的属性。这样一来,让事情就变得复杂,对于像我这样的初学者而言,极难理解,也易产生一些错误。正因这个原因,整理了一篇这样的文章,因涉及的内容较多,有些零乱,加上是初学者,难免有不对之处,如果有不对之处,烦请各路大婶拍正。
由于内容过多,最后简单的总结一下下。首先上一张图:
一图胜过千言万语。熟悉CSS的同学应该知道,元素的盒模型分为content-box
和border-box
之类。那么在JavaScript中,上述的这些属性也略有不同。
content-box
时情况
offsetWidth
和offsetHeight
:
- 元素盒子总宽高:
width + padding + border
- 在
box-sizing:content-box
时,width= 内容区域的宽度
- 不管是否超出元素限制范围(内容有溢出容器)都是总宽高
clientWidth
和clientHeight
:
- 一般情况下,即元素盒子可见区的
width + padding
- 可视区只针对取值的元素本身,以元素本身的角度出发,也就是说当我们限制元素宽度时只有能看见的部分会列入计算,减去滚动条的宽度
- 如果有个子元素超过自己的宽高,那么
clientWidth
和clientHeight
仍然是width + padding
scrollWidth
和scrollHeight
:
- 整个盒子内的总宽高
- 元素本身的
padding
加上内部元素的宽高
offsetTop
和offsetLeft
:
- 定义
ele.offsetTop
是可读属性,返回改元素与offsetParent
元素的距离 - 当
position
为static
时,offsetParent
就会是根节点root
或者外层结构中最接近的table cell
元素,其他有position
的属性(relative
、absolute
、fixed
)都会让被设定的外层元素变成offsetParent
- 计算元素和
offsetParent
的距离(改元素本身的margin
加上offsetParent
的padding
) - 当元素CSS有
display: none
时,offsetParent
的值为null
clientTop
和clientLeft
:
- 单纯就是
border
宽度 - 定义为返回该方向的
border
宽度 - 该属性不包含元素的
padding
或margin
- 使用类似
document.getElementById('ele').style.borderTopWidth
的方法取得一样的值
scrollTop
和scrollLeft
:
- 如果该目标元素没有滚动条,则值为
0
- 从元素
border
内开始计算,scrollTop
与scrollLeft
是取有内容卷起的那个元素卷到哪 - 按照规定
scrollTop
不会小于0
,但是在OSX系统下的Chrome和Safari浏览器下有可能会产生负值
border-box
时情况
offsetWidth
和offsetHeight
:
- 由于
border-box
的关系,CSS设定的width
会等于总宽 - 在
border-box
模式下width
不等于内容区域的宽度,而是整个块区域的宽度,但不包含margin
clientWidth
和clientHeight
:
border-box
状态时,算法变成:width - border
=内容区域 + padding
scrollWidth
和 scrollHeight
:
- 取得值没有差异,虽然是往内减,但该有的
padding
还是存在
offsetTop
和offsetLeft
:
- 取得值没有差异
clientTop
和clientLeft
:
- 取得值没有差异
scrollTop
和scrollLeft
:
- 取得值没有差异
简而言之,上述的内容就是JavaScript中的三大系列offset
、client
和scroll
。而这三大系列都是以DOM元素节点的属性形式存在的。类比访问关系,也是以属性形式存在。不同点在于,访问关系是为了获取其他节点,而三大系列是为了获取元素节点更多的信息。最后以网上最经典的一张图来展示这三大系列之间的关系:
内容涉及较多,加上自己是初学者,如果文章中有不对之处,还望各路大婶拍正。文章中有些图片来自于互联网!
如需转载,烦请注明出处:https://www.w3cplus.com/javascript/offset-scroll-client.html