Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/ui/sidebar-hover-sweep.ts
T

72 lines
2.6 KiB
TypeScript

import { useCallback, useEffect, useRef, type PointerEventHandler } from "react";
const SIDEBAR_HOVER_ITEM_SELECTOR = '[data-sidebar-hover-item="true"]';
const SIDEBAR_HOVER_SURFACE_SELECTOR = '[data-sidebar-hover-surface="true"]';
const SIDEBAR_SWEEP_HOVER_ATTRIBUTE = "data-sidebar-sweep-hover";
const SIDEBAR_SWEEP_HOVER_DURATION_MS = 150;
type SidebarHoverSweepOptions = {
onPointerMove?: PointerEventHandler<HTMLElement>;
onPointerLeave?: PointerEventHandler<HTMLElement>;
};
export function useSidebarHoverSweep({ onPointerMove, onPointerLeave }: SidebarHoverSweepOptions) {
const previousClientYRef = useRef<number | null>(null);
const cleanupTimersRef = useRef(new Map<HTMLElement, ReturnType<typeof setTimeout>>());
const pulseSurface = useCallback((surface: HTMLElement) => {
const existingTimer = cleanupTimersRef.current.get(surface);
if (existingTimer !== undefined) clearTimeout(existingTimer);
surface.setAttribute(SIDEBAR_SWEEP_HOVER_ATTRIBUTE, "true");
const timer = setTimeout(() => {
surface.removeAttribute(SIDEBAR_SWEEP_HOVER_ATTRIBUTE);
cleanupTimersRef.current.delete(surface);
}, SIDEBAR_SWEEP_HOVER_DURATION_MS);
cleanupTimersRef.current.set(surface, timer);
}, []);
useEffect(
() => () => {
for (const timer of cleanupTimersRef.current.values()) clearTimeout(timer);
cleanupTimersRef.current.clear();
},
[],
);
const handlePointerMove = useCallback<PointerEventHandler<HTMLElement>>(
(event) => {
onPointerMove?.(event);
const currentClientY = event.clientY;
const previousClientY = previousClientYRef.current;
previousClientYRef.current = currentClientY;
if (previousClientY === null || previousClientY === currentClientY) return;
const lowerBound = Math.min(previousClientY, currentClientY);
const upperBound = Math.max(previousClientY, currentClientY);
const items = event.currentTarget.querySelectorAll<HTMLElement>(SIDEBAR_HOVER_ITEM_SELECTOR);
for (const item of items) {
const bounds = item.getBoundingClientRect();
const centerY = bounds.top + bounds.height / 2;
if (centerY <= lowerBound || centerY >= upperBound) continue;
const surface = item.querySelector<HTMLElement>(SIDEBAR_HOVER_SURFACE_SELECTOR);
if (surface) pulseSurface(surface);
}
},
[onPointerMove, pulseSurface],
);
const handlePointerLeave = useCallback<PointerEventHandler<HTMLElement>>(
(event) => {
previousClientYRef.current = null;
onPointerLeave?.(event);
},
[onPointerLeave],
);
return { handlePointerMove, handlePointerLeave };
}