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.comemergence.init({ container: customContainer});

Throttle：是一種防止與滾動和調整事件大小相關的性能問題的方法。油門將創建一個小的超時，并在事件過程中每隔一定的毫秒量穩定地檢查元素的可見性。默認是250。

reset：確定數據屬性狀態是否在顯示后重置。false如果您希望元素即使在離開視口后仍保持其顯示狀態，請將其重置為。默認是true。

handheld：Emergence將為大多數手持設備型號（如手機和平板電腦）進行檢查。設置false為時，插件將不會在這些設備上運行。默認是true。

elemCushion：元素坐標將決定在視口內需要多少元素才算“可見”。0.5的值將等于50％的元素需要可見。默認是0.15。