Popovers are richer than tooltips — they support a title area and interactive content.
Setup
<script lang="ts">
import { Button, Popover } from '.';
</script>
Default popover
<script lang="ts">
import { Button, Popover } from '.';
</script>
<Button id="popover-default">Hover me</Button>
<Popover triggeredBy="#popover-default" title="Popover title">
And here's some amazing content. It's very engaging. Right?
</Popover>
Placement
<script lang="ts">
import { Button, Popover } from '.';
</script>
<Button id="pop-top">Top</Button>
<Popover triggeredBy="#pop-top" placement="top" title="Top">Top content</Popover>
Click trigger
<script lang="ts">
import { Button, Popover } from '.';
</script>
<Button id="popover-click">Click me</Button>
<Popover triggeredBy="#popover-click" trigger="click" title="Click popover">
Opened on click.
</Popover>
Colored title
<script lang="ts">
import { Button, Popover } from '.';
</script>
<Button id="popover-green" color="green">Green</Button>
<Popover triggeredBy="#popover-green" color="green" title="Green popover">
Title uses the green color variant.
</Popover>
Colors
Title color tokens: default, primary, secondary, gray, red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rose.
Composition notes
- Like Tooltip, requires
triggeredBy pointing at a trigger id/selector. title may be a string or a snippet for custom headers. - Use
trigger="click" for richer interactive content inside the popover.
Props
PopoverProps (extends PopperProps)
| Prop | Type | Default | Description |
children | Snippet | — | Popover body |
title | string | Snippet | — | Optional header |
color | default | primary | secondary | gray | red | orange | amber | yellow | lime | green | emerald | teal | cyan | sky | blue | indigo | violet | purple | fuchsia | pink | rose | default | Title color |
triggeredBy | string | — | CSS selector for trigger |
trigger | hover | click | hover | Open behavior |
triggerDelay | number | — | Hover delay (ms) |
placement | Floating UI Placement | top | Position |
strategy | Floating UI Strategy | — | absolute / fixed |
offset | number | — | Distance from trigger |
arrow | boolean | true | Show arrow |
arrowClass | string | — | Arrow classes |
reference | string | — | Alternate reference selector |
middlewares | Middleware[] | — | Floating UI middleware |
yOnly | boolean | — | Constrain movement to Y |
isOpen | boolean | false | Bindable open state |
transition | TransitionFunc | — | Open/close transition |
transitionParams | ParamsType | — | Transition params |
classes | slot class map | — | Theme slot overrides |
onbeforetoggle | (ev) => void | — | Before open/close |
ontoggle | (ev) => void | — | After open/close |
class | ClassValue | — | Root classes |
Snippets
| Snippet | Description |
children | Body content |
title | Custom header (when not a string) |
Events
| Event | Description |
onbeforetoggle | Before visibility change (TriggeredToggleEvent) |
ontoggle | After visibility change |