Documentation
OverlaysGlass surface
HoverCard
Shows extra context on hover and focus.
01
See it in context
Preview
02
Copy a working example
Usage
---
import {
Button,
HoverCard
} from '@santi020k/lumen-astro'
---
<HoverCard>
<Button variant="outline" data-ui-trigger>Preview maintainer</Button>
<div>
<strong>Santiago Molina</strong>
<p>Maintainer of Lumen UI.</p>
</div>
</HoverCard>---
import {
Button,
HoverCard
} from '@santi020k/lumen-astro'
---
<HoverCard>
<Button variant="outline" data-ui-trigger>Preview maintainer</Button>
<div>
<strong>Santiago Molina</strong>
<p>Maintainer of Lumen UI.</p>
</div>
</HoverCard>import { Button, HoverCard } from '@santi020k/lumen-react'
export const Example = () => (
<>
<HoverCard>
<Button variant="outline" data-ui-trigger>Preview maintainer</Button>
<div>
<strong>Santiago Molina</strong>
<p>Maintainer of Lumen UI.</p>
</div>
</HoverCard>
</>
)import { Button, HoverCard } from '@santi020k/lumen-react'
export const Example = () => (
<>
<HoverCard>
<Button variant="outline" data-ui-trigger>Preview maintainer</Button>
<div>
<strong>Santiago Molina</strong>
<p>Maintainer of Lumen UI.</p>
</div>
</HoverCard>
</>
)<script type="module">
import { defineLumenElements } from '@santi020k/lumen-elements/define'
defineLumenElements()
</script>
<lumen-hover-card>
<lumen-button variant="outline" data-ui-trigger>Preview maintainer</lumen-button>
<div>
<strong>Santiago Molina</strong>
<p>Maintainer of Lumen UI.</p>
</div>
</lumen-hover-card><script type="module">
import { defineLumenElements } from '@santi020k/lumen-elements/define'
defineLumenElements()
</script>
<lumen-hover-card>
<lumen-button variant="outline" data-ui-trigger>Preview maintainer</lumen-button>
<div>
<strong>Santiago Molina</strong>
<p>Maintainer of Lumen UI.</p>
</div>
</lumen-hover-card>03
Choose your target
Add this component
Choose the package for your runtime. All adapters share the Lumen stylesheet. Use the matching registry command when you want a local wrapper for that framework.
pnpm add @santi020k/lumen-astropnpm add @santi020k/lumen-astrolumen add HoverCardlumen add HoverCardpnpm add @santi020k/lumen-reactpnpm add @santi020k/lumen-reactlumen add HoverCard --target reactlumen add HoverCard --target reactpnpm add @santi020k/lumen-elementspnpm add @santi020k/lumen-elementslumen add HoverCard --target elementslumen add HoverCard --target elementsGlass
Add the glass prop to apply the shared blur, saturation, border, and highlight tokens. Glass reads best over vivid content, so place the surface above imagery or color.
---
import { HoverCard } from '@santi020k/lumen-astro'
---
<div class="docs-glass-demo docs-glass-demo--float">
<HoverCard glass>
<a href="/docs" data-ui-trigger>@santi020k</a>
<div>
<strong>Santiago Molina</strong>
<p>The glass hover card floats as a frosted lens over the artwork behind it.</p>
</div>
</HoverCard>
</div>---
import { HoverCard } from '@santi020k/lumen-astro'
---
<div class="docs-glass-demo docs-glass-demo--float">
<HoverCard glass>
<a href="/docs" data-ui-trigger>@santi020k</a>
<div>
<strong>Santiago Molina</strong>
<p>The glass hover card floats as a frosted lens over the artwork behind it.</p>
</div>
</HoverCard>
</div>import { HoverCard } from '@santi020k/lumen-react'
export const Example = () => (
<>
<div className="docs-glass-demo docs-glass-demo--float">
<HoverCard glass>
<a href="/docs" data-ui-trigger>@santi020k</a>
<div>
<strong>Santiago Molina</strong>
<p>The glass hover card floats as a frosted lens over the artwork behind it.</p>
</div>
</HoverCard>
</div>
</>
)import { HoverCard } from '@santi020k/lumen-react'
export const Example = () => (
<>
<div className="docs-glass-demo docs-glass-demo--float">
<HoverCard glass>
<a href="/docs" data-ui-trigger>@santi020k</a>
<div>
<strong>Santiago Molina</strong>
<p>The glass hover card floats as a frosted lens over the artwork behind it.</p>
</div>
</HoverCard>
</div>
</>
)<script type="module">
import { defineLumenElements } from '@santi020k/lumen-elements/define'
defineLumenElements()
</script>
<div class="docs-glass-demo docs-glass-demo--float">
<lumen-hover-card glass>
<a href="/docs" data-ui-trigger>@santi020k</a>
<div>
<strong>Santiago Molina</strong>
<p>The glass hover card floats as a frosted lens over the artwork behind it.</p>
</div>
</lumen-hover-card>
</div><script type="module">
import { defineLumenElements } from '@santi020k/lumen-elements/define'
defineLumenElements()
</script>
<div class="docs-glass-demo docs-glass-demo--float">
<lumen-hover-card glass>
<a href="/docs" data-ui-trigger>@santi020k</a>
<div>
<strong>Santiago Molina</strong>
<p>The glass hover card floats as a frosted lens over the artwork behind it.</p>
</div>
</lumen-hover-card>
</div>API reference
Lumen-specific props and runtime attributes for the Astro primitive. React props follow the same names; Elements use equivalent kebab-case attributes where custom elements expose them.
| Attribute | Values | Default | Description |
|---|---|---|---|
| glass | boolean | "subtle" | "strong" | false | Applies the tokenized liquid-glass surface treatment with backdrop-filter fallbacks; "subtle" and "strong" adjust the fill intensity. |
| surface | "default" | "glass" | "default" | Deprecated alias for glass; surface="glass" maps to glass={true}. |
| data-ui-trigger | boolean attribute | - | Marks the child trigger that opens and closes the adjacent disclosure panel. |
| class, className | string | "" | Merges custom classes with the generated ui-* root classes. |
| ...native attributes | HTML attributes | - | Forwards standard attributes to the root element unless the component consumes them. |