Emergence.js 是一个轻量级，高性能的 JS 插件，用于检测和操作浏览器中的元素。
这个插件被设计为允许根据浏览器中的可见性对元素进行操作。它使开发人员可以自由使用自己的 CSS 或JS 来查看动画还是状态的改变。它利用 HTML5 数据属性而不是类来简化开发。Emergence.js 是同类型中最轻，最兼容的插件之一。
emergence.js 的特点
- 无需依赖其他组件
- 支持IE8 +和所有现代浏览器
- 压缩后只有1kb
安装
Emergence.js 的安装非常的简单。npm的安装方法如下：
npm install emergence.js
另外我们也可以直接下载它，在html文件中引入Emergence.js即可。
<script src="path/to/emergence.min.js"></script> <script> emergence.init(); </script>
如何使用
添加 data-emergence="hidden" 到您想要观看的任何元素：
< div class = “ element ” data-emergence = “ hidden ” > </ div >
当元素在视口内变得可见时，属性将变为 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('Element is visible.');
} else if (state === 'reset') {
console.log('Element is hidden with reset.');
} else if (state === 'noreset') {
console.log('Element is hidden with NO reset.');
}
}
});
选项说明
container：容器，默认情况下，元素的可见性将由窗口的视口尺寸和X / Y滚动位置（设置为window）确定。但是，可以将其更改为自定义容器。例如：
var customContainer = document.querySelector('.wrapper');
// www.xttblog.com
emergence.init({
container: customContainer
});
Throttle：是一种防止与滚动和调整事件大小相关的性能问题的方法。油门将创建一个小的超时，并在事件过程中每隔一定的毫秒量稳定地检查元素的可见性。默认是250。
reset：确定数据属性状态是否在显示后重置。false如果您希望元素即使在离开视口后仍保持其显示状态，请将其重置为。默认是true。