Popover

A floating element that opens from a trigger. Plays open and close sounds.

A floating element that opens from a trigger. The sensory-ui Popover plays sounds when opening and closing, confirming the floating panel interaction.

Pattern: Open / close

Demo

Live demoSwitch sound packs to compare

Installation

npx shadcn@latest add SatyamVyas04/sensory-ui/sensory-ui-popover

Import

import {
  Popover,
  PopoverContent,
  PopoverTrigger,
} from "@/components/ui/sensory-ui/popover";

Sound Props

PropTypeDefaultDescription
soundSoundRole | false"overlay.open"Sound played when the popover opens.
closeSoundSoundRole | false"overlay.close"Sound played when the popover closes.
volumenumber1Per-component volume multiplier (0–1).

Default Sound Role

overlay.open on open, overlay.close on close.

Usage

<Popover>
  <PopoverTrigger>Open</PopoverTrigger>
  <PopoverContent>Place content for the popover here.</PopoverContent>
</Popover>

Custom sounds

<Popover sound="interaction.tap" closeSound="interaction.subtle">
  {/* ... */}
</Popover>

Disable sounds

<Popover sound={false} closeSound={false}>
  {/* ... */}
</Popover>

Customizations

Color picker

<Popover sound="overlay.open" closeSound="overlay.close">
  <PopoverTrigger>
    <Button variant="outline">Pick color</Button>
  </PopoverTrigger>
  <PopoverContent>
    <ColorPicker />
  </PopoverContent>
</Popover>

Date picker

<Popover sound="overlay.open" closeSound="overlay.close">
  <PopoverTrigger>
    <Button variant="outline">Select date</Button>
  </PopoverTrigger>
  <PopoverContent>
    <Calendar />
  </PopoverContent>
</Popover>

Default Props

PropValue
sound"overlay.open"
closeSound"overlay.close"
volume1

Tasteful Sound Choices

SituationRecommended SoundWhy
Color pickeroverlay.open / overlay.closeDefault: panel cue
Date pickeroverlay.open / overlay.closeConsistent overlay
Settings popoverinteraction.tap / interaction.subtleLighter utility
Tooltip-likefalseFor hover-triggered popovers

When to Use

  • Color pickers: Color selection panels
  • Date pickers: Calendar selection
  • Settings: Quick setting adjustments
  • Filters: Inline filter panels

Avoid sound on

  • Hover-triggered popovers (sounds would be premature)
  • Popovers that appear as tooltips

Event Triggers

EventDefault Sound
Popover opensoverlay.open
Popover closesoverlay.close

shadcn/ui Reference

View the original Popover documentation.