浅谈Emergence.js 检测元素可见性的 js 插件

2023-09-20 21:32:04 70

Emergence.js是一个轻量级，高性能的JS插件，用于检测和操作浏览器中的元素。

这个插件被设计为允许根据浏览器中的可见性对元素进行操作。它使开发人员可以自由使用自己的CSS或JS来查看动画还是状态的改变。它利用HTML5数据属性而不是类来简化开发。Emergence.js是同类型中最轻，最兼容的插件之一。

emergence.js的特点

无需依赖其他组件
支持IE8+和所有现代浏览器
压缩后只有1kb

安装

Emergence.js的安装非常的简单。npm的安装方法如下：

npminstallemergence.js

另外我们也可以直接下载它，在html文件中引入Emergence.js即可。

如何使用

添加data-emergence="hidden"到您想要观看的任何元素：

当元素在视口内变得可见时，属性将变为data-emergence="visible"。现在，您可以利用CSS来动画元素：

.element[data-emergence=hidden]{
/*隐藏状态*/
}
.element[data-emergence=visible]{
/*可见状态*/
}

自定义选项

Emergence.js有许多选项可以自定义。下面是默认值：

emergence.init({
container:window,
reset:true,
handheld:true,
throttle:250,
elemCushion:0.15,
offsetTop:0,
offsetRight:0,
offsetBottom:0,
offsetLeft:0,
callback:function(element,state){
if(state==='visible'){
console.log('Elementisvisible.');
}elseif(state==='reset'){
console.log('Elementishiddenwithreset.');
}elseif(state==='noreset'){
console.log('ElementishiddenwithNOreset.');
}
}
});

选项说明

container：容器，默认情况下，元素的可见性将由窗口的视口尺寸和X/Y滚动位置（设置为window）确定。但是，可以将其更改为自定义容器。例如：

varcustomContainer=document.querySelector('.wrapper');
//www.xttblog.com
emergence.init({
container:customContainer
});

Throttle：是一种防止与滚动和调整事件大小相关的性能问题的方法。油门将创建一个小的超时，并在事件过程中每隔一定的毫秒量稳定地检查元素的可见性。默认是250。

reset：确定数据属性状态是否在显示后重置。false如果您希望元素即使在离开视口后仍保持其显示状态，请将其重置为。默认是true。

handheld：Emergence将为大多数手持设备型号（如手机和平板电脑）进行检查。设置false为时，插件将不会在这些设备上运行。默认是true。

elemCushion：元素坐标将决定在视口内需要多少元素才算“可见”。0.5的值将等于50％的元素需要可见。默认是0.15。

offsetTop,offsetRight,offsetBottom,offsetLeft：在视口的任何边上提供偏移量（以像素为单位）。如果您有一个固定的组件（例如标题），那么这非常有用，您可以为标题的高度偏移相同的值。100应用于的值offsetTop将意味着元素只有在距离视口顶部大于100像素时才会被视为可见。所有的默认值是0。

callback：用于提供回调来确定元素何时可见，隐藏和重置。可能的状态是visible，reset和noreset。

另外Emergence.js还提供了两个高级方法emergence.engage();和emergence.disengage();他们的作用刚好相反。

Emergence.js依赖于以下浏览器API：querySelectorAll

为了支持IE8，请确保标准模式。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。

浅谈Emergence.js 检测元素可见性的 js 插件

热门推荐

随机推荐