Function autoAnimate

src/index.ts:883–971

(
  el: HTMLElement,
  config: Partial<AutoAnimateOptions> | AutoAnimationPlugin = {},
)

 * @param options - An optional object of options.
 */
export default function autoAnimate(
  el: HTMLElement,
  config: Partial<AutoAnimateOptions> | AutoAnimationPlugin = {},
): AnimationController {
  if (supportedBrowser && resize) {
    const mediaQuery = window.matchMedia("(prefers-reduced-motion: reduce)")
    const isDisabledDueToReduceMotion =
      mediaQuery.matches &&
      !isPlugin(config) &&
      !(config as Partial<AutoAnimateOptions>).disrespectUserMotionPreference
    if (!isDisabledDueToReduceMotion) {
      enabled.add(el)
      if (getComputedStyle(el).position === "static") {
        Object.assign(el.style, { position: "relative" })
      }
      forEach(el, updatePos, poll, (element) => resize?.observe(element))
      if (isPlugin(config)) {
        options.set(el, config as AutoAnimationPlugin)
      } else {
        options.set(el, {
          duration: 250,
          easing: "ease-in-out",
          ...(config as Partial<AutoAnimateOptions>),
        })
      }
      const mo = new MutationObserver(handleMutations)
      mo.observe(el, { childList: true })
      mutationObservers.set(el, mo)
      parents.add(el)
    }
  }
  const controller: AnimationController = Object.freeze({
    parent: el,
    enable: () => {
      enabled.add(el)
    },
    disable: () => {
      enabled.delete(el)
      // Cancel any in-flight animations and pending timers for immediate effect
      forEach(el, (node) => {
        const a = animations.get(node)
        try {
          a?.cancel()
        } catch {}
        animations.delete(node)
        const d = debounces.get(node)
        if (d) clearTimeout(d)
        debounces.delete(node)
        const i = intervals.get(node)
        if (i) clearInterval(i)
        intervals.delete(node)
      })
    },
    isEnabled: () => enabled.has(el),
    destroy: () => {
      enabled.delete(el)
      parents.delete(el)
      options.delete(el)