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/.
app/components/ui/hover-preview-card/HoverPreviewCard.vue
<script setup lang="ts">
import { AlertDialog as Primitive } from 'akaza-ui'
import { computed, useAttrs, useTemplateRef } from 'vue'
import { cn } from '../../../utils/ui'
import uiConfig from '../ui.config'
import {
alertDialogVariants,
resolveAlertDialogVariants,
type AlertDialogProps,
type AlertDialogSlots,
} from './index'
defineOptions({ inheritAttrs: false })
// Preserve Akaza defaults when optional props, including Boolean aliases, are omitted.
const props = withDefaults(defineProps<AlertDialogProps>(), {
as: undefined,
teleport: undefined,
transition: undefined,
duration: undefined,
title: undefined,
ariaLabel: undefined,
description: undefined,
ui: undefined,
modelValue: undefined,
})
defineSlots<AlertDialogSlots>()
const attrs = useAttrs()
const styles = computed(() => alertDialogVariants(resolveAlertDialogVariants(props, uiConfig)))
const mergedUi = computed(() => {
const overrides = props.ui as Record<string, string | undefined> | undefined
return Object.fromEntries(
Object.entries(styles.value).map(([part, style]) => [
part,
cn(style(), overrides?.[part], part === 'content' ? props.class : undefined),
]),
)
})
const primitiveProps = computed(() => {
const { class: _class, ui: _ui, width: _width, ...native } = props
return native
})
const primitive = useTemplateRef<InstanceType<typeof Primitive>>('primitive')
defineExpose({
get open() {
return primitive.value!.open
},
get close() {
return primitive.value!.close
},
get toggle() {
return primitive.value!.toggle
},
get titleId() {
return primitive.value!.titleId
},
get descriptionId() {
return primitive.value!.descriptionId
},
})
</script>
<template>
<component
:is="Primitive"
ref="primitive"
v-bind="{ ...primitiveProps, ...attrs }"
:ui="mergedUi"
>
<template v-for="(_, name) in $slots" #[name]="scope"
><slot :name="name as keyof AlertDialogSlots" v-bind="scope ?? {}"
/></template>
</component>
</template>
API
Variants and defaults
| Prop | Values | Default |
|---|---|---|
size | xs, sm, md, lg, xl | md |
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
| Prop | Type | Default | Description |
|---|---|---|---|
side | "top" | "right" | "bottom" | "left" | "bottom" | Preferred side. |
align | "start" | "center" | "end" | "center" | Alignment on the cross-axis. |
sideOffset | number | 4 | Gap in px. |
openDelay | number | 600 | Delay before opening. |
closeDelay | number | 150 | Delay before closing. |
disabled | boolean | false | Prevents opening. |
forceMount | boolean | false | Keeps closed content mounted, hidden, and inert. |
openOnClick | boolean | true | Toggles on touch/pen click. Mouse continues to use hover/focus. |
arrow | boolean | false | Renders arrow element. |
ariaLabel | string | — | Adds labelled role="dialog" semantics for interactive previews. |
teleport | string | false | "body" | Teleport target. |
ui | HoverPreviewCardUi | — | Classes for structural parts. |
Slots
| Slot | Props | Description |
|---|---|---|
trigger | isOpen, triggerProps | Trigger content. |
content | close | Preview content. |
Events
| Event | Payload | Description |
|---|---|---|
open-change | (open, details) | Fired before open state changes. |
Keyboard
| Key | Behavior |
|---|---|
Tab / focus | Opens on trigger focus and remains open while focus is in trigger or content. |
Escape | Closes the card and returns focus to trigger. |