v6.0.0

CHANGELOG.md

@@ -1,3 +1,16 @@
+## v6.0.0
+
+-   Корректная работа сообытий mouseenter/mouseleave на тач-устройствах
+-   Предовтращаем лишние показы всплывающей подсказки
+
+## v5.0.0
+
+-   Регистрируем сообытия mouseenter/mouseleave на тач-устройствах
+
+## v4.1.1
+
+-   Исправление зависаний (в некоторых случаях) всплывающих подсказок
+
 ## v4.1.0
 
 -   Отключаем события mouseenter/mouseleave для toch-устройств

index.js

@@ -8,7 +8,22 @@ const attributeToOption = (attribute) => {
     return attribute.charAt(0).toLowerCase() + attribute.slice(1);
 };
 
-const isTouchDevice = () => 'ontouchstart' in window || navigator.maxTouchPoints > 0;
+let visibilityListenerRegistered = false;
+const handleVisibilityChange = () => {
+    if (document.hidden) {
+        // Скрываем все активные всплывающие подсказки
+        for (const $tooltip of document.querySelectorAll('.tooltip')) {
+            const ref = $tooltip._reference;
+            if (ref?._tooltip) {
+                // Очищаем таймеры появления при скрытии страницы
+                clearTimeout(ref._tooltip._showTimeout);
+                if (ref._tooltip.isVisible) {
+                    ref._tooltip.hide({ immediately: true });
+                }
+            }
+        }
+    }
+};
 
 export const createTooltip = ($el, content, options) => {
     options = {
@@ -43,8 +58,6 @@ export const createTooltip = ($el, content, options) => {
         }
     }
 
-    let showTimeout;
-    let hideTimeout;
     let rafId;
     const listeners = [];
 
@@ -55,6 +68,8 @@ export const createTooltip = ($el, content, options) => {
         $container: undefined,
         $arrow: undefined,
         $interactive: undefined,
+        _showTimeout: undefined,
+        _hideTimeout: undefined,
         autoUpdateCleanup: () => {},
 
         setContent(updatedContent) {
@@ -152,6 +167,10 @@ export const createTooltip = ($el, content, options) => {
                 return;
             }
 
+            clearTimeout($el._tooltip._showTimeout);
+            clearTimeout($el._tooltip._hideTimeout);
+            cancelAnimationFrame(rafId);
+
             $el._tooltip.$tooltip?.remove();
 
             // Вызываем autoUpdateCleanup только если всплывающая подсказка была видна (иначе вызывать её не имеет смысла)
@@ -173,7 +192,7 @@ export const createTooltip = ($el, content, options) => {
     }
 
     $el._tooltip.show = async ({ immediately } = {}) => {
-        clearTimeout(hideTimeout);
+        clearTimeout($el._tooltip._hideTimeout);
 
         if (!$el._tooltip.$tooltip) {
             const { computePosition, offset, flip, shift, arrow } = await import('@floating-ui/dom');
@@ -280,23 +299,26 @@ export const createTooltip = ($el, content, options) => {
 
         const { autoUpdate } = await import('@floating-ui/dom');
 
-        showTimeout = setTimeout(
+        $el._tooltip._showTimeout = setTimeout(
             async () => {
-                if (!$el._tooltip.isVisible) {
+                const isMouseEnterTrigger = options.trigger.includes('mouseenter');
-                    (options.appendTo === 'parent' ? $el.parentElement : options.appendTo).append(
+                const isHovering = $el.matches(':hover');
-                        $el._tooltip.$tooltip,
-                    );
-                    $el._tooltip.isVisible = true;
-                    $el._tooltip.autoUpdateCleanup = autoUpdate(
-                        $el,
-                        $el._tooltip.$tooltip,
-                        $el._tooltip.updatePosition,
-                    );
 
+                // Проверяем $el._tooltip на сущестование и актуальность показа всплывающей подсказки
                 if (
-                        options.hideOnClick &&
+                    !$el._tooltip ||
-                        (options.trigger.includes('click') || options.trigger.includes('manual'))
+                    $el._tooltip.isVisible ||
+                    (isMouseEnterTrigger && !isHovering) ||
+                    document.hidden
                 ) {
+                    return;
+                }
+
+                (options.appendTo === 'parent' ? $el.parentElement : options.appendTo).append($el._tooltip.$tooltip);
+                $el._tooltip.isVisible = true;
+                $el._tooltip.autoUpdateCleanup = autoUpdate($el, $el._tooltip.$tooltip, $el._tooltip.updatePosition);
+
+                if (options.hideOnClick && (options.trigger.includes('click') || options.trigger.includes('manual'))) {
                     document.body.addEventListener('click', $el._tooltip.hideOnClickListener);
                     listeners.push({
                         el: document.body,
@@ -319,17 +341,20 @@ export const createTooltip = ($el, content, options) => {
                 if (options.onShown) {
                     options.onShown($el._tooltip);
                 }
-                }
             },
             immediately ? 0 : options.delay[0],
         );
     };
 
     $el._tooltip.hide = ({ immediately } = {}) => {
-        clearTimeout(showTimeout);
+        clearTimeout($el._tooltip._showTimeout);
-        hideTimeout = setTimeout(
+        $el._tooltip._hideTimeout = setTimeout(
             async () => {
-                if ($el._tooltip.isVisible) {
+                // Проверяем $el._tooltip на сущестование
+                if (!$el._tooltip || !$el._tooltip.isVisible) {
+                    return;
+                }
+
                 if (options.onHide) {
                     options.onHide($el._tooltip);
                 }
@@ -341,6 +366,11 @@ export const createTooltip = ($el, content, options) => {
                     }).finished;
                 } catch {} // eslint-disable-line no-empty
 
+                // Ещё одна проверка на сущестование $el._tooltip после await
+                if (!$el._tooltip) {
+                    return;
+                }
+
                 if ($el._tooltip.$tooltip) {
                     $el._tooltip.$tooltip.remove();
                 }
@@ -350,7 +380,6 @@ export const createTooltip = ($el, content, options) => {
                 if (options.onHidden) {
                     options.onHidden($el._tooltip);
                 }
-                }
             },
             immediately ? 0 : options.delay[1],
         );
@@ -379,21 +408,34 @@ export const createTooltip = ($el, content, options) => {
     };
 
     $el._tooltip.clickListener = () => {
+        if (document.hidden) {
+            return;
+        }
         if (!$el._tooltip.isVisible) {
             $el._tooltip.show();
         }
     };
 
-    $el._tooltip.mouseEnterListener = () => {
+    $el._tooltip.mouseEnterListener = (event) => {
+        if (event.pointerType !== 'mouse' || document.hidden) {
+            return;
+        }
         $el._tooltip.show();
     };
 
-    $el._tooltip.mouseLeaveListener = ({ relatedTarget }) => {
+    $el._tooltip.mouseLeaveListener = (event) => {
-        if (options.interactive && relatedTarget && $el._tooltip.$tooltip?.contains(relatedTarget)) {
+        if (event.pointerType !== 'mouse') {
+            return;
+        }
+
+        if (options.interactive && event.relatedTarget && $el._tooltip.$tooltip?.contains(event.relatedTarget)) {
             $el._tooltip.$tooltip.addEventListener(
-                'mouseleave',
+                'pointerleave',
-                ({ relatedTarget }) => {
+                (event) => {
-                    if (!relatedTarget || !$el.contains(relatedTarget)) {
+                    if (event.pointerType !== 'mouse') {
+                        return;
+                    }
+                    if (!event.relatedTarget || !$el.contains(event.relatedTarget)) {
                         $el._tooltip.hide();
                     }
                 },
@@ -405,6 +447,9 @@ export const createTooltip = ($el, content, options) => {
     };
 
     $el._tooltip.focusListener = () => {
+        if (document.hidden) {
+            return;
+        }
         $el._tooltip.show();
     };
 
@@ -416,13 +461,11 @@ export const createTooltip = ($el, content, options) => {
         for (const trigger of options.trigger.split(' ')) {
             switch (trigger) {
                 case 'mouseenter': {
-                    if (!isTouchDevice()) {
+                    $el.addEventListener('pointerenter', $el._tooltip.mouseEnterListener);
-                        $el.addEventListener('mouseenter', $el._tooltip.mouseEnterListener);
+                    listeners.push({ el: $el, event: 'pointerenter', listener: $el._tooltip.mouseEnterListener });
-                        listeners.push({ el: $el, event: 'mouseenter', listener: $el._tooltip.mouseEnterListener });
 
-                        $el.addEventListener('mouseleave', $el._tooltip.mouseLeaveListener);
+                    $el.addEventListener('pointerleave', $el._tooltip.mouseLeaveListener);
-                        listeners.push({ el: $el, event: 'mouseleave', listener: $el._tooltip.mouseLeaveListener });
+                    listeners.push({ el: $el, event: 'pointerleave', listener: $el._tooltip.mouseLeaveListener });
-                    }
                     break;
                 }
                 case 'click': {
@@ -430,8 +473,8 @@ export const createTooltip = ($el, content, options) => {
                     listeners.push({ el: $el, event: 'click', listener: $el._tooltip.clickListener });
 
                     if (!options.interactive) {
-                        $el.addEventListener('mouseleave', $el._tooltip.mouseLeaveListener);
+                        $el.addEventListener('pointerleave', $el._tooltip.mouseLeaveListener);
-                        listeners.push({ el: $el, event: 'mouseleave', listener: $el._tooltip.mouseLeaveListener });
+                        listeners.push({ el: $el, event: 'pointerleave', listener: $el._tooltip.mouseLeaveListener });
                     }
                     break;
                 }
@@ -450,4 +493,9 @@ export const createTooltip = ($el, content, options) => {
     };
 
     registerListeners();
+
+    if (!visibilityListenerRegistered) {
+        document.addEventListener('visibilitychange', handleVisibilityChange);
+        visibilityListenerRegistered = true;
+    }
 };

package.json

@@ -1,6 +1,6 @@
 {
     "name": "@advdominion/tooltip",
-    "version": "4.1.0",
+    "version": "6.0.0",
     "type": "module",
     "packageManager": "yarn@4.9.4",
     "main": "index.js",