GlobalTooltip: delay 중 마우스 벗어나면 title 복원 안 되던 버그 수정

showFor 가 호출되면 title 속성을 즉시 제거하고 titleMap 에 저장한 뒤
setTimeout 으로 지연. 지연 중에 마우스가 벗어나 handleOut 가 호출되어도
triggerRef 는 아직 null 이라 hide() 가 title 을 복원하지 못해 해당 요소의
title 이 영구 제거되고 이후 [title] 선택자에 걸리지 않아 툴팁이 안 뜸.

- pendingRef 추가해 "delay 중 title 제거된 타겟" 추적
- hide / showFor / handleOver / handleOut 모두 pendingRef 고려해 복원
- 타이머 중 다른 타겟으로 이동 / 같은 타겟 반복 hover 케이스 처리

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
caadiq 2026-04-24 08:39:04 +09:00
parent 2d52a1668f
commit 01bbbbd6af

View file

@ -17,42 +17,62 @@ const DELAY_DEFAULT = 200
*/ */
export default function GlobalTooltip() { export default function GlobalTooltip() {
const [state, setState] = useState({ open: false, text: '', placement: 'top', coords: null }) const [state, setState] = useState({ open: false, text: '', placement: 'top', coords: null })
const triggerRef = useRef(null) const triggerRef = useRef(null) //
const pendingRef = useRef(null) // delay title ( )
const tooltipRef = useRef(null) const tooltipRef = useRef(null)
const timerRef = useRef(null) const timerRef = useRef(null)
const titleMap = useRef(new WeakMap()) const titleMap = useRef(new WeakMap())
useEffect(() => { useEffect(() => {
function restoreTitle() { function stripTitle(el) {
const el = triggerRef.current const t = el.getAttribute('title')
if (t && !titleMap.current.has(el)) {
titleMap.current.set(el, t)
el.removeAttribute('title')
}
}
function restoreTitle(el) {
if (el && titleMap.current.has(el)) { if (el && titleMap.current.has(el)) {
const prev = titleMap.current.get(el) el.setAttribute('title', titleMap.current.get(el))
el.setAttribute('title', prev)
titleMap.current.delete(el) titleMap.current.delete(el)
} }
} }
function hide() { function hide() {
clearTimeout(timerRef.current) clearTimeout(timerRef.current)
restoreTitle() restoreTitle(pendingRef.current)
restoreTitle(triggerRef.current)
pendingRef.current = null
triggerRef.current = null triggerRef.current = null
setState((s) => (s.open ? { ...s, open: false } : s)) setState((s) => (s.open ? { ...s, open: false } : s))
} }
function showFor(target) { function showFor(target) {
//
if (triggerRef.current === target || pendingRef.current === target) return
// pending
if (pendingRef.current) {
clearTimeout(timerRef.current)
restoreTitle(pendingRef.current)
pendingRef.current = null
}
const nativeTitle = target.getAttribute('title') const nativeTitle = target.getAttribute('title')
const dataTooltip = target.getAttribute('data-tooltip') const dataTooltip = target.getAttribute('data-tooltip')
const text = nativeTitle || dataTooltip const text = nativeTitle || dataTooltip
if (!text) return if (!text) return
if (nativeTitle && !titleMap.current.has(target)) {
titleMap.current.set(target, nativeTitle) if (nativeTitle) stripTitle(target)
target.removeAttribute('title') pendingRef.current = target
}
const placement = target.getAttribute('data-tooltip-placement') || 'top' const placement = target.getAttribute('data-tooltip-placement') || 'top'
const delay = Number(target.getAttribute('data-tooltip-delay')) || DELAY_DEFAULT const delay = Number(target.getAttribute('data-tooltip-delay')) || DELAY_DEFAULT
clearTimeout(timerRef.current) clearTimeout(timerRef.current)
timerRef.current = setTimeout(() => { timerRef.current = setTimeout(() => {
triggerRef.current = target triggerRef.current = target
pendingRef.current = null
setState({ open: true, text, placement, coords: null }) setState({ open: true, text, placement, coords: null })
}, delay) }, delay)
} }
@ -60,19 +80,22 @@ export default function GlobalTooltip() {
function handleOver(e) { function handleOver(e) {
const target = e.target.closest?.('[title], [data-tooltip]') const target = e.target.closest?.('[title], [data-tooltip]')
if (!target) return if (!target) return
if (triggerRef.current === target) return if (triggerRef.current === target || pendingRef.current === target) return
//
// trigger
if (triggerRef.current && triggerRef.current !== target) { if (triggerRef.current && triggerRef.current !== target) {
restoreTitle() restoreTitle(triggerRef.current)
triggerRef.current = null triggerRef.current = null
setState((s) => (s.open ? { ...s, open: false } : s))
} }
showFor(target) showFor(target)
} }
function handleOut(e) { function handleOut(e) {
if (!triggerRef.current) return const active = triggerRef.current || pendingRef.current
if (!active) return
const rt = e.relatedTarget const rt = e.relatedTarget
if (rt && triggerRef.current.contains(rt)) return if (rt && active.contains(rt)) return
hide() hide()
} }
@ -98,7 +121,8 @@ export default function GlobalTooltip() {
window.removeEventListener('scroll', hide, true) window.removeEventListener('scroll', hide, true)
window.removeEventListener('resize', hide) window.removeEventListener('resize', hide)
clearTimeout(timerRef.current) clearTimeout(timerRef.current)
restoreTitle() restoreTitle(pendingRef.current)
restoreTitle(triggerRef.current)
} }
}, []) }, [])