Skip to content

Hover Preview Card

Show a content preview when someone hovers or focuses a link.

Demos

Size

Usage

vue
<script setup lang="ts">
import { Accordion } from '~/components/ui/accordion'

const items = [
  { value: 'source', label: 'Do I own the source?', content: 'Yes. Copy and adapt the files.' },
]
</script>

<template>
  <Accordion :items="items" />
</template>

Installation

Complete the shared installation. Copy HoverPreviewCard.vue and index.ts into app/components/ui/hover-preview-card/.

API

Variants and defaults

PropValuesDefault
sizexs, sm, md, lg, xlmd

Width fits the content by default, capped at 20rem and the viewport. Panel padding stays at 12px across sizes. size controls text size, line height, and corner radius. The default trigger gap is 4px. Use class or ui.content to set an explicit width when needed. Child components retain their own size props.

Props

PropTypeDefaultDescription
side"top" | "right" | "bottom" | "left""bottom"Preferred side.
align"start" | "center" | "end""center"Alignment on the cross-axis.
sideOffsetnumber4Gap in px.
openDelaynumber600Delay before opening.
closeDelaynumber150Delay before closing.
disabledbooleanfalsePrevents opening.
forceMountbooleanfalseKeeps closed content mounted, hidden, and inert.
openOnClickbooleantrueToggles on touch/pen click. Mouse continues to use hover/focus.
arrowbooleanfalseRenders arrow element.
ariaLabelstring—Adds labelled role="dialog" semantics for interactive previews.
teleportstring | false"body"Teleport target.
uiHoverPreviewCardUi—Classes for structural parts.

Slots

SlotPropsDescription
triggerisOpen, triggerPropsTrigger content.
contentclosePreview content.

Events

EventPayloadDescription
open-change(open, details)Fired before open state changes.

Keyboard

KeyBehavior
Tab / focusOpens on trigger focus and remains open while focus is in trigger or content.
EscapeCloses the card and returns focus to trigger.