Parameters

Name	Type	Default	Description
placement	'above' | 'below' | 'start' | 'end' | MaybeRefOrGetter	'above'	Side of the trigger the card is placed on. Logical: start / end mirror under RTL. Flips when there is no room.
alignment	'start' | 'center' | 'end' | MaybeRefOrGetter	'center'	Alignment along the placement axis.
delay	number | MaybeRefOrGetter	300	Delay before showing the hover card on hover, in milliseconds.
hideDelay	number | MaybeRefOrGetter	200	Delay before hiding after the pointer or focus leaves, so the pointer can travel into the card.
focusTrigger	'auto' | 'always' | 'never' | MaybeRefOrGetter	'auto'	When focus opens the card. auto only attaches focus listeners to naturally focusable elements.
touchTrigger	'auto' | 'tap' | 'none' | MaybeRefOrGetter	'auto'	What a tap does where there is no hover. auto opens on tap unless the trigger performs an action of its own; tap always opens; none never opens on touch.
isEnabled	boolean | MaybeRefOrGetter	true	Whether the hover and focus triggers are live.
label	string | undefined | MaybeRefOrGetter	—	Accessible name for the card. When provided the card is exposed as a named role="dialog"; when omitted it falls back to role="group", which may validly be unnamed.
isOpen	boolean | undefined | MaybeRefOrGetter	—	Controlled open state. true force-shows, false force-hides, undefined lets hover and focus manage visibility.
isDefaultOpen	boolean	false	Whether the card is shown on mount.
onShow	() => void	—	Called when the card becomes visible.
onHide	() => void	—	Called when the card is hidden.

Returns

Field	Type	Description
isOpen	Ref<boolean>	Whether the card is showing.
triggerRef	Ref<HTMLElement | null>	Trigger element. Bind it with :ref; the hook attaches the handlers and ARIA relationships.
contentRef	Ref<HTMLElement | null>	Card container.
id	string	Unique ID of the card.
anchorId	string	CSS identifier for the anchor element, for advanced positioning cases.
describedBy	string	ID to compose into aria-describedby. The hook already writes it onto triggerRef; it is here for hand-written ARIA.
contentStyle	ComputedRef<CSSProperties>	Inline coordinates for the card.
resolvedPlacement	ComputedRef<'above' | 'below' | 'start' | 'end'>	Placement actually in effect, after flipping for available space.
isDialog	ComputedRef<boolean>	Whether the card is exposed as a named dialog rather than an unnamed group.
contentProps	ComputedRef<Record<string, unknown>>	Attributes for the card: id, role, aria-label, and the pointer/focus handlers that keep it open.
show	() => void	Imperatively show the card immediately.
hide	() => void	Imperatively hide the card immediately.