李涛自留地
回到顶部
首页 > jQuery学习 > jquery判断元素是否显示怎么做?两种取法对照

jquery判断元素是否显示怎么做?两种取法对照

文章目录

判断元素在不在页面上占位置,jQuery 给了两条不同的路:一条向浏览器要布局结果,一条读样式里算出来的 display 值。这两条路在嵌套结构里经常给出相反的结论,jquery判断元素是否显示之所以容易写错,根源就在这里——父级藏起来时,子元素自己的 display 依然是 block。

is方法返回什么

$(el).is(':visible') 返回布尔值,问的是这个元素现在有没有布局盒,判断就从这一句开始。jQuery 3 的实现是三项取或:offsetWidth、offsetHeight、getClientRects().length,任意一项成立就算可见。

布局盒、祖先链与可见性三层叠放的剖面

空的内联 <span></span> 没有宽高,但浏览器给了它一个 client rect,在 3.x 里返回 true;锁在 1.x 上的项目,同一段代码返回 false。跨大版本迁移时这条最容易漏。

判断还顺着祖先链走。父级 display:none,子元素样式一个字没改,:visible 照样返回 false。

$('.item').is(':visible') 另有一层误解:它答的是这个集合里有没有至少一个可见,不是每个都可见。要数几个可见,用 $('.item').filter(':visible').length。

先取元素,再看布局盒,顺序不能颠倒——脱离文档的节点没有盒,一律 false。

下面这段在控制台里能直接看到两个答案打架,前提是父容器已经被藏起来。

const $item = $('#panel .item');    // #panel 处于 display:none
console.log($item.css('display'));  // "block"
console.log($item.is(':visible'));  // false

两行输出分别是 "block" 和 false,跟前面说的一致:display 只报元素自己,is 把整条链都算进去了。

:visible 是 jQuery 自己扩展的伪类,浏览器不认。丢进原生接口会直接抛错:SyntaxError: Failed to execute 'querySelectorAll' on 'Document': ':visible' is not a valid selector. 要用原生,得自己按同一套条件筛:[...document.querySelectorAll('.item')].filter(el => el.offsetWidth || el.offsetHeight || el.getClientRects().length)——NodeList 没有 filter,先展开成数组才不会抛 TypeError。

visibility:hidden 和 opacity:0 的元素,:visible 都算可见,因为它们占着位置。所以jquery判断元素是否显示要分两层:先看有没有布局盒,再看画不画得出来。

取元素到布局盒判断的分支走向图

:hidden 是它的反面,取值正好相反,同样会把 input[type=hidden] 算成隐藏——这类元素从来就没有布局盒。

display取值怎么读

$(el).css('display') 返回计算值,是字符串:"none"、"block"、"inline-block"、"flex"、"table-row"。读法只有一个要点:等于 "none" 就是不渲染,其余都算渲染。

它不回答另外几个问题——在不在视口里、有没有被 overflow:hidden 裁掉、尺寸是不是 0。这些都得另查。

display:contents 的元素有值却没有盒,:visible 会判它不可见,子元素其实照常渲染。

行内 style 写的、样式表里写的、JS 改的,取到的都是最终算出来的那个值,不用关心来源。所以读 display 只答了一半,它说的是元素自己以什么盒模型参与排版,jquery判断元素是否显示的另一半得去问布局盒。

这组能看出单独读 display 会漏什么。

console.log($('#tip').css('display'));    // "block"
console.log($('#tip').css('visibility')); // "hidden"
console.log($('#tip').is(':visible'));    // true

三行依次是 "block"、"hidden"、true。元素明明看不见,两条判断都说它可见——它们只管布局盒,不管最后画没画出来。

两个 API 也都不管视口。列表滚到屏幕外,元素既不是 display:none,:visible 还是 true。要判断有没有进入视口,那是 IntersectionObserver 的活。

offsetParent 会不会判错

el.offsetParent === null 常被当成快捷写法,不依赖 jQuery,读一次布局,比 :visible 少两项。

有两处会判错。position:fixed 的元素按规范 offsetParent 就返回 null,弹层、吸顶导航正好是 fixed,于是它们被稳稳当当地判成隐藏。祖先 visibility:hidden 它也看不出来。

真要自己算,el.getClientRects().length > 0 比 offsetParent 稳一些,fixed 的情况能给出正确结果,代价还是读一次布局。

左栏 is 在隐藏父级下取到 false,右栏 display 仍读到 block

所以拿 offsetParent 做jquery判断元素是否显示,只适合粗筛:渲染前把 display:none 的元素排掉,能省一次布局读取。判断用户看得见还是看不见,它不够用。

前提、代价、适用场景怎么比

前提不一样。:visible 要求元素挂在文档里,脱离文档的节点没有布局盒,得先 insert 再判断。display 取值不挑这个。offsetParent 同样要求元素参与布局。

代价差得更多。:visible 一次要读 offsetWidth、offsetHeight、getClientRects,是实打实的布局读取。滚动回调里对两千个行节点跑一次 .filter(':visible'),滚动立刻发涩。display 取值走 getComputedStyle,只取一个属性,轻一些。offsetParent 读一次布局,最省。三者都在读浏览器状态,没有一个真的免费。

高频场景的省法不在挑 API,而在别让回调去问「现在可见吗」。把状态记在切换的地方:展开时加 class,收起时去掉,回调只读这个 class,布局读取就从每帧挪到了每次点击。

把这些写法摆在一起,差别有两处:代价差一个量级,准确度也各有漏。offsetParent 漏掉 fixed 和 visibility:hidden,:visible 漏掉 visibility 和 opacity,display 取值只答元素自己。

适用场景基本能把两条路分开,offsetParent 算前一条的简化版。要回答用户此刻能不能看见,用 :visible,再补一条 visibility 检查。要知道元素以什么盒模型在排(inline、flex、grid),或者要在 CSS 层做分支,读 display 取值。只做一次性的粗筛、节点量又大,offsetParent 够用,前提是排除掉 fixed。

该用哪一个

多数场景下判断元素是否显示,默认选 :visible 就够了。它答的是占不占位置,嵌套时不会像 display 取值那样被父级骗过去;但看不见的元素它照样算可见,真要问「用户看不看得见」,visibility 和 opacity 还得各查一次。代价是每次调用都读布局,别塞进高频回调的循环里。

需要盒模型信息、要区分 display 的取值种类,读 display 取值。

只做一次粗筛、节点量大、又要排除 fixed,offsetParent 可以顶上。

当时在折叠面板上,先写的是 display 判断。面板收起靠父容器 display:none,子项自己的 display 一直是 block,于是每一项都被判成显示,展开动画按着错的列表跑了一遍才归位。改成 :visible 之后对上了,代价落在滚动列表那一段,布局读取从一次变成一串。

重来一次,第一步会先问:要判断的是元素自己,还是它整条祖先链。写错的版本基本都跳过了这一问。

若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。