Components

Dropdown Menu

Displays a menu to the user — such as a set of actions or functions — triggered by a button.

PreviewSource
Example requirements

Also uses: Button.

Installation

Complete the project setup first. The init command configures TypeScript, Vite, Tailwind CSS v4, and Preact compatibility.

CLI

Run init once using the installation guide, then add this component. The CLI copies the required source files and installs their exact dependencies with Bun.

bunx --bun github:LiasCode/shadcn-preact#main add dropdown-menu button

Add --dry-run to review the changes. Existing modified files are protected; use --overwrite only when you want to replace them.

Manual installation / degit (optional)

1. Install dependencies

bun add --exact @floating-ui/react-dom@2.1.9 cn@0.4.0 lucide-preact@1.55.0 preact@11.0.1 tw-animate-css@1.4.0

The usage example also needs Button. Follow their installation guides as well.

2. Copy the component with degit

Run this from your project root. It selects dropdown-menu.tsx, its local dependencies, and both licenses directly from the repository, then copies them into src/components/ui.

bunx degit@3.10.0 https://github.com/LiasCode/shadcn-preact#main ./.cache/shadcn-preact/dropdown-menu --files LICENSE.md,registry/ui/dropdown-menu.tsx,registry/ui/lib/utils.ts,registry/ui/primitives/LICENSE,registry/ui/primitives/direction-provider/index.tsx,registry/ui/primitives/internals/FloatingFocusManager.tsx,registry/ui/primitives/internals/FloatingPortal.tsx,registry/ui/primitives/internals/FloatingTree.tsx,registry/ui/primitives/internals/FloatingTreeStore.ts,registry/ui/primitives/internals/FocusGuard.tsx,registry/ui/primitives/internals/arrow.ts,registry/ui/primitives/internals/composite/root/CompositeRootContext.ts,registry/ui/primitives/internals/createBaseUIEventDetails.ts,registry/ui/primitives/internals/direction-context.ts,registry/ui/primitives/internals/empty.ts,registry/ui/primitives/internals/getReactElementRef.ts,registry/ui/primitives/internals/getStateAttributesProps.ts,registry/ui/primitives/internals/markOthers.ts,registry/ui/primitives/internals/mergeObjects.ts,registry/ui/primitives/internals/owner.ts,registry/ui/primitives/internals/popups/OverlayContext.ts,registry/ui/primitives/internals/popups/OverlayParts.tsx,registry/ui/primitives/internals/popups/OverlayRoot.tsx,registry/ui/primitives/internals/popups/OverlayTrigger.tsx,registry/ui/primitives/internals/popups/PopupHandle.ts,registry/ui/primitives/internals/popups/TooltipProvider.tsx,registry/ui/primitives/internals/popups/getElementProps.ts,registry/ui/primitives/internals/resolveClassName.ts,registry/ui/primitives/internals/resolveRef.ts,registry/ui/primitives/internals/resolveStyle.ts,registry/ui/primitives/internals/stateAttributesMapping.ts,registry/ui/primitives/internals/tabbable.ts,registry/ui/primitives/internals/types.ts,registry/ui/primitives/internals/useAnchorPositioning.ts,registry/ui/primitives/internals/useAnimationFrame.ts,registry/ui/primitives/internals/useAnimationsFinished.ts,registry/ui/primitives/internals/useButton.ts,registry/ui/primitives/internals/useControlled.ts,registry/ui/primitives/internals/useDismiss.ts,registry/ui/primitives/internals/useFloatingRootContext.ts,registry/ui/primitives/internals/useFocusableWhenDisabled.ts,registry/ui/primitives/internals/useHoverFloatingInteraction.ts,registry/ui/primitives/internals/useId.ts,registry/ui/primitives/internals/useIsoLayoutEffect.ts,registry/ui/primitives/internals/useListNavigation.ts,registry/ui/primitives/internals/useMergedRefs.ts,registry/ui/primitives/internals/useOnMount.ts,registry/ui/primitives/internals/useOpenChangeComplete.ts,registry/ui/primitives/internals/usePopupTabExit.ts,registry/ui/primitives/internals/useRefWithInit.ts,registry/ui/primitives/internals/useRenderElement.ts,registry/ui/primitives/internals/useScrollLock.ts,registry/ui/primitives/internals/useStableCallback.ts,registry/ui/primitives/internals/useTransitionStatus.ts,registry/ui/primitives/internals/visuallyHidden.ts,registry/ui/primitives/menu/index.ts,registry/ui/primitives/menu/parts.tsx,registry/ui/primitives/menubar/MenubarContext.ts,registry/ui/primitives/merge-props/index.ts,registry/ui/primitives/separator/Separator.tsx,registry/ui/primitives/separator/index.ts --force
mkdir -p ./src/components/ui
cp -R ./.cache/shadcn-preact/dropdown-menu/registry/ui/. ./src/components/ui/
cp ./.cache/shadcn-preact/dropdown-menu/LICENSE.md ./src/components/ui/LICENSE.md

The temporary copy lives in .cache/shadcn-preact/dropdown-menu. Existing components stay in place; shared source files are updated from main.

Selected source files (60)

Usage

import { Button } from "./components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuGroup,
  DropdownMenuItem,
  DropdownMenuLabel,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "./components/ui/dropdown-menu"
<DropdownMenu>
  <DropdownMenuTrigger render={<Button variant="outline" />}>
    Open
  </DropdownMenuTrigger>
  <DropdownMenuContent>
    <DropdownMenuGroup>
      <DropdownMenuLabel>My Account</DropdownMenuLabel>
      <DropdownMenuItem>Profile</DropdownMenuItem>
      <DropdownMenuItem>Billing</DropdownMenuItem>
    </DropdownMenuGroup>
    <DropdownMenuSeparator />
    <DropdownMenuGroup>
      <DropdownMenuItem>Team</DropdownMenuItem>
      <DropdownMenuItem>Subscription</DropdownMenuItem>
    </DropdownMenuGroup>
  </DropdownMenuContent>
</DropdownMenu>

Examples

Basic

A basic dropdown menu with labels and separators.

BasicSource
Example requirements

Also uses: Button.

Submenu

Use DropdownMenuSub to nest secondary actions.

SubmenuSource
Example requirements

Also uses: Button.

Shortcuts

Add DropdownMenuShortcut to show keyboard hints.

ShortcutsSource
Example requirements

Also uses: Button.

Icons

Combine icons with labels for quick scanning.

IconsSource
Example requirements

Also uses: Button.

bun add --exact lucide-preact@1.55.0

Checkboxes

Use DropdownMenuCheckboxItem for toggles.

CheckboxesSource
Example requirements

Also uses: Button.

Checkboxes Icons

Add icons to checkbox items.

Checkboxes IconsSource
Example requirements

Also uses: Button.

bun add --exact lucide-preact@1.55.0

Radio Group

Use DropdownMenuRadioGroup for exclusive choices.

Radio GroupSource
Example requirements

Also uses: Button.

Radio Icons

Show radio options with icons.

Radio IconsSource
Example requirements

Also uses: Button.

bun add --exact lucide-preact@1.55.0

Destructive

Use variant="destructive" for irreversible actions.

DestructiveSource
Example requirements

Also uses: Button.

bun add --exact lucide-preact@1.55.0

Avatar

An account switcher dropdown triggered by an avatar.

AvatarSource
Example requirements

Also uses: Avatar, Button.

bun add --exact lucide-preact@1.55.0

Complex

A richer example combining groups, icons, and submenus.

ComplexSource
Example requirements

Also uses: Button.

bun add --exact lucide-preact@1.55.0

Reference

See the official Dropdown Menu documentation for composition patterns and API details. This page uses the Preact port and examples from the pinned upstream revision.

Component source