viewportEvents

Type:Function
Status:stable
Since:1.0.0
Platform:js
@blackbyte.sugar.js.dom.event

Monitor when the passed element enter or exit the viewport

Params

  1. $elm*-HTMLElement

    The element to monitor

  2. $settings{}Partial<TViewportEventsSettings>

    Some settings to configure your detector

Return

  1. -Function

    The passed HTMLElement

Example

import { viewportEvents } from '@blackbyte/sugar/dom';
viewportEvents($elm);
$elm.addEventListener('viewport.enter', (e) => {
  // do something on enter
});
$elm.addEventListener('viewport.leave', (e) => {
  // do something on leave
});

Settings

  1. offset25String

    An offset to detect the enter/leave earlier or later

  2. oncefalseBoolean

    Specify if you want to event to be dispatched only once

Todo

  • testsnormal

Changelog

  • 1.0.0
    Rename events from viewport.in / viewport.out to viewport.enter / viewport.leave