Function bindAdvance

shepherd.js/src/utils/bind.ts:29–64

(step: Step)

 * @param step The step instance
 */
export function bindAdvance(step: Step) {
  // An empty selector matches the step element
  const { event, selector } = step.options.advanceOn || {};
  if (event) {
    const handler = _setupAdvanceOnHandler(step, selector);

    // TODO: this should also bind/unbind on show/hide
    let el: Element | null = null;

    if (!isUndefined(selector)) {
      el = document.querySelector(selector);

      if (!el) {
        return console.error(
          `No element was found for the selector supplied to advanceOn: ${selector}`
        );
      }
    }

    if (el) {
      el.addEventListener(event, handler);
      step.on('destroy', () => {
        return (el as HTMLElement).removeEventListener(event, handler);
      });
    } else {
      document.body.addEventListener(event, handler, true);
      step.on('destroy', () => {
        return document.body.removeEventListener(event, handler, true);
      });
    }
  } else {
    return console.error(
      'advanceOn was defined, but no event name was passed.'
    );
  }
}