when

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

This function listen for passed trigger(s) on the passed HTMLElement and resolve the promise once one of them has reached his state.

Params

  1. $elm*-HTMLElement

    The element to listen on

  2. trigger*-String|String[]

    The trigger(s) to listen on

  3. settings{}TwhenSettings

    Some settings like offset, etc…

Return

  1. -SPromise<HTMLElement>

    A promise resolved when all the triggers are fulfilled

Example

import { when } from '@blackbyte/sugar/dom';
when($elm, 'inViewport', {
   whenInViewport: {
      offset: 50
   }
}).then(() => {
     // do something
});

Settings

  1. whenInViewport[object Object]Partial<TWhenInViewportSettings>

    Some settings for the whenInViewport function

  2. whenNearViewport[object Object]Partial<TWhenNearViewportSettings>

    Some settings for the whenNearViewport function

  3. whenEntersViewport[object Object]Partial<IWhenEntersViewportSettubgs>

    Some settings for the whenEntersViewport function

  4. whenOutOfViewport[object Object]Partial<TWhenOutOfViewportSettings>

    Some settings for the whenOutOfViewport function

  5. whenInteract[object Object]Partial<TWhenInteractSettings>

    Some settings for the whenInteract function

  6. whenVisible[object Object]Partial<TWhenVisibleSettings>

    Some settings for the whenVisible function

  7. whenStylesheetsReady[object Object]Partial<IWhenStyleSheetsReadySettings>

    Some settings for the whenStylesheetsReady function

Todo

  • testsnormal