Skip to content
WebJs
Menu

Dropdown Menu

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

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';

export default function DropdownMenuDemo() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Open</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content class="w-40" align="start">
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>My Account</ui-dropdown-menu-label>
          <ui-dropdown-menu-item>
            Profile
            <ui-dropdown-menu-shortcut>⇧⌘P</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            Billing
            <ui-dropdown-menu-shortcut>⌘B</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            Settings
            <ui-dropdown-menu-shortcut>⌘S</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item>Team</ui-dropdown-menu-item>
          <ui-dropdown-menu-sub>
            <ui-dropdown-menu-sub-trigger>Invite users</ui-dropdown-menu-sub-trigger>
            <ui-dropdown-menu-sub-content>
              <ui-dropdown-menu-item>Email</ui-dropdown-menu-item>
              <ui-dropdown-menu-item>Message</ui-dropdown-menu-item>
              <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
              <ui-dropdown-menu-item>More...</ui-dropdown-menu-item>
            </ui-dropdown-menu-sub-content>
          </ui-dropdown-menu-sub>
          <ui-dropdown-menu-item>
            New Team
            <ui-dropdown-menu-shortcut>⌘+T</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item>GitHub</ui-dropdown-menu-item>
          <ui-dropdown-menu-item>Support</ui-dropdown-menu-item>
          <ui-dropdown-menu-item data-disabled>API</ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item>
            Log out
            <ui-dropdown-menu-shortcut>⇧⌘Q</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Installation

pnpm dlx @webjsdev/ui add dropdown-menu

Usage

import { buttonClass } from '#components/ui/button.ts';
import '#components/ui/dropdown-menu.ts';
<ui-dropdown-menu>
  <ui-dropdown-menu-trigger>
    <button class=${buttonClass({ variant: 'outline' })}>Open</button>
  </ui-dropdown-menu-trigger>
  <ui-dropdown-menu-content>
    <ui-dropdown-menu-group>
      <ui-dropdown-menu-label>My Account</ui-dropdown-menu-label>
      <ui-dropdown-menu-item>Profile</ui-dropdown-menu-item>
      <ui-dropdown-menu-item>Billing</ui-dropdown-menu-item>
    </ui-dropdown-menu-group>
    <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
    <ui-dropdown-menu-group>
      <ui-dropdown-menu-item>Team</ui-dropdown-menu-item>
      <ui-dropdown-menu-item>Subscription</ui-dropdown-menu-item>
    </ui-dropdown-menu-group>
  </ui-dropdown-menu-content>
</ui-dropdown-menu>

Composition

Use the following composition to build a dropdown menu:

ui-dropdown-menu
├── ui-dropdown-menu-trigger
└── ui-dropdown-menu-content
    ├── ui-dropdown-menu-group
    │   ├── ui-dropdown-menu-label
    │   ├── ui-dropdown-menu-item
    │   └── ui-dropdown-menu-item
    ├── ui-dropdown-menu-separator
    ├── ui-dropdown-menu-group
    │   ├── ui-dropdown-menu-label
    │   ├── ui-dropdown-menu-item type="checkbox"
    │   └── ui-dropdown-menu-item type="checkbox"
    ├── ui-dropdown-menu-separator
    ├── ui-dropdown-menu-group
    │   ├── ui-dropdown-menu-label
    │   └── ui-dropdown-menu-group aria-label
    │       ├── ui-dropdown-menu-item type="radio"
    │       └── ui-dropdown-menu-item type="radio"
    └── ui-dropdown-menu-sub
        ├── ui-dropdown-menu-sub-trigger
        └── ui-dropdown-menu-sub-content
            └── ui-dropdown-menu-group
                ├── ui-dropdown-menu-label
                ├── ui-dropdown-menu-item
                └── ui-dropdown-menu-item

Basic

A basic dropdown menu with labels and separators.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';

export default function DropdownMenuBasic() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Open</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>My Account</ui-dropdown-menu-label>
          <ui-dropdown-menu-item>Profile</ui-dropdown-menu-item>
          <ui-dropdown-menu-item>Billing</ui-dropdown-menu-item>
          <ui-dropdown-menu-item>Settings</ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-item>GitHub</ui-dropdown-menu-item>
        <ui-dropdown-menu-item>Support</ui-dropdown-menu-item>
        <ui-dropdown-menu-item data-disabled>API</ui-dropdown-menu-item>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Use <ui-dropdown-menu-sub> to nest secondary actions.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';

export default function DropdownMenuSubmenu() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Open</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item>Team</ui-dropdown-menu-item>
          <ui-dropdown-menu-sub>
            <ui-dropdown-menu-sub-trigger>Invite users</ui-dropdown-menu-sub-trigger>
            <ui-dropdown-menu-sub-content>
              <ui-dropdown-menu-item>Email</ui-dropdown-menu-item>
              <ui-dropdown-menu-item>Message</ui-dropdown-menu-item>
              <ui-dropdown-menu-sub>
                <ui-dropdown-menu-sub-trigger>More options</ui-dropdown-menu-sub-trigger>
                <ui-dropdown-menu-sub-content>
                  <ui-dropdown-menu-item>Calendly</ui-dropdown-menu-item>
                  <ui-dropdown-menu-item>Slack</ui-dropdown-menu-item>
                  <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
                  <ui-dropdown-menu-item>Webhook</ui-dropdown-menu-item>
                </ui-dropdown-menu-sub-content>
              </ui-dropdown-menu-sub>
              <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
              <ui-dropdown-menu-item>Advanced...</ui-dropdown-menu-item>
            </ui-dropdown-menu-sub-content>
          </ui-dropdown-menu-sub>
          <ui-dropdown-menu-item>
            New Team
            <ui-dropdown-menu-shortcut>⌘+T</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Shortcuts

Add <ui-dropdown-menu-shortcut> to show keyboard hints.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';

export default function DropdownMenuShortcuts() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Open</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>My Account</ui-dropdown-menu-label>
          <ui-dropdown-menu-item>
            Profile
            <ui-dropdown-menu-shortcut>⇧⌘P</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            Billing
            <ui-dropdown-menu-shortcut>⌘B</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            Settings
            <ui-dropdown-menu-shortcut>⌘S</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-item>
          Log out
          <ui-dropdown-menu-shortcut>⇧⌘Q</ui-dropdown-menu-shortcut>
        </ui-dropdown-menu-item>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Icons

Combine icons with labels for quick scanning.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import { CreditCardIcon, LogOutIcon, SettingsIcon, UserIcon } from '#lib/ui/lucide.ts';

export default function DropdownMenuIcons() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Open</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content>
        <ui-dropdown-menu-item>
          ${UserIcon()}
          Profile
        </ui-dropdown-menu-item>
        <ui-dropdown-menu-item>
          ${CreditCardIcon()}
          Billing
        </ui-dropdown-menu-item>
        <ui-dropdown-menu-item>
          ${SettingsIcon()}
          Settings
        </ui-dropdown-menu-item>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-item variant="destructive">
          ${LogOutIcon()}
          Log out
        </ui-dropdown-menu-item>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Checkboxes

Use type="checkbox" on an item for toggles. The item flips its own checked attribute when selected, so the markup only sets the initial state.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';

// Each checkbox item keeps its own checked state and flips it on select,
// so the demo writes the initial state and nothing else.
export default function DropdownMenuCheckboxes() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Open</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content class="w-40">
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>Appearance</ui-dropdown-menu-label>
          <ui-dropdown-menu-item type="checkbox" value="status-bar" checked>
            Status Bar
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item type="checkbox" value="activity-bar" data-disabled>
            Activity Bar
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item type="checkbox" value="panel">
            Panel
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Checkboxes Icons

Add icons to checkbox items.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import { BellIcon, MailIcon, MessageSquareIcon } from '#lib/ui/lucide.ts';

export default function DropdownMenuCheckboxesIcons() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Notifications</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content class="w-48">
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>Notification Preferences</ui-dropdown-menu-label>
          <ui-dropdown-menu-item type="checkbox" value="email" checked>
            ${MailIcon()}
            Email notifications
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item type="checkbox" value="sms">
            ${MessageSquareIcon()}
            SMS notifications
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item type="checkbox" value="push" checked>
            ${BellIcon()}
            Push notifications
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Radio Group

Use type="radio" items inside a <ui-dropdown-menu-group> for exclusive choices. The group keeps one item checked, and its aria-label names the set.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';

// The radio set is the nearest <ui-dropdown-menu-group>, which keeps one
// item checked and names the set with its aria-label.
export default function DropdownMenuRadioGroup() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Open</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content class="w-32">
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>Panel Position</ui-dropdown-menu-label>
          <ui-dropdown-menu-group aria-label="Panel Position">
            <ui-dropdown-menu-item type="radio" value="top">Top</ui-dropdown-menu-item>
            <ui-dropdown-menu-item type="radio" value="bottom" checked>Bottom</ui-dropdown-menu-item>
            <ui-dropdown-menu-item type="radio" value="right">Right</ui-dropdown-menu-item>
          </ui-dropdown-menu-group>
        </ui-dropdown-menu-group>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Radio Icons

Show radio options with icons.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import { Building2Icon, CreditCardIcon, WalletIcon } from '#lib/ui/lucide.ts';

export default function DropdownMenuRadioIcons() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Payment Method</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content class="min-w-56">
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>Select Payment Method</ui-dropdown-menu-label>
          <ui-dropdown-menu-group aria-label="Select Payment Method">
            <ui-dropdown-menu-item type="radio" value="card" checked>
              ${CreditCardIcon()}
              Credit Card
            </ui-dropdown-menu-item>
            <ui-dropdown-menu-item type="radio" value="paypal">
              ${WalletIcon()}
              PayPal
            </ui-dropdown-menu-item>
            <ui-dropdown-menu-item type="radio" value="bank">
              ${Building2Icon()}
              Bank Transfer
            </ui-dropdown-menu-item>
          </ui-dropdown-menu-group>
        </ui-dropdown-menu-group>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Destructive

Use variant="destructive" for irreversible actions.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import { PencilIcon, ShareIcon, TrashIcon } from '#lib/ui/lucide.ts';

export default function DropdownMenuDestructive() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Actions</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item>
            ${PencilIcon()}
            Edit
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            ${ShareIcon()}
            Share
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item variant="destructive">
            ${TrashIcon()}
            Delete
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Avatar

An account switcher dropdown triggered by an avatar.

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { avatarClass, avatarImageClass, avatarFallbackClass } from '#components/ui/avatar.ts';
import { buttonClass } from '#components/ui/button.ts';
import { BadgeCheckIcon, BellIcon, CreditCardIcon, LogOutIcon } from '#lib/ui/lucide.ts';

export default function DropdownMenuAvatar() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="ghost" data-size="icon" aria-label="Account menu" class=${cn(buttonClass({ variant: 'ghost', size: 'icon' }), 'rounded-full')}>
          <span data-slot="avatar" data-size="default" class=${avatarClass()}>
            <img data-slot="avatar-image" src="/avatars/vivek.jpg" alt="vivek" class=${avatarImageClass()}>
            <span data-slot="avatar-fallback" class=${avatarFallbackClass()}>VK</span>
          </span>
        </button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content align="end">
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item>
            ${BadgeCheckIcon()}
            Account
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            ${CreditCardIcon()}
            Billing
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            ${BellIcon()}
            Notifications
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-item>
          ${LogOutIcon()}
          Sign Out
        </ui-dropdown-menu-item>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

Complex

A richer example combining groups, icons, and submenus.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import {
  BellIcon, CreditCardIcon, DownloadIcon, EyeIcon, FileCodeIcon, FileIcon,
  FileTextIcon, FolderIcon, FolderOpenIcon, FolderSearchIcon, HelpCircleIcon,
  KeyboardIcon, LanguagesIcon, LayoutIcon, LogOutIcon, MailIcon, MonitorIcon,
  MoonIcon, MoreHorizontalIcon, PaletteIcon, SaveIcon, SettingsIcon, ShieldIcon,
  SunIcon, UserIcon,
} from '#lib/ui/lucide.ts';

export default function DropdownMenuComplex() {
  return html`
    <ui-dropdown-menu>
      <ui-dropdown-menu-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Complex Menu</button>
      </ui-dropdown-menu-trigger>
      <ui-dropdown-menu-content class="w-44">
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>File</ui-dropdown-menu-label>
          <ui-dropdown-menu-item>
            ${FileIcon()}
            New File
            <ui-dropdown-menu-shortcut>⌘N</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            ${FolderIcon()}
            New Folder
            <ui-dropdown-menu-shortcut>⇧⌘N</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-sub>
            <ui-dropdown-menu-sub-trigger>
              ${FolderOpenIcon()}
              Open Recent
            </ui-dropdown-menu-sub-trigger>
            <ui-dropdown-menu-sub-content>
              <ui-dropdown-menu-group>
                <ui-dropdown-menu-label>Recent Projects</ui-dropdown-menu-label>
                <ui-dropdown-menu-item>
                  ${FileCodeIcon()}
                  Project Alpha
                </ui-dropdown-menu-item>
                <ui-dropdown-menu-item>
                  ${FileCodeIcon()}
                  Project Beta
                </ui-dropdown-menu-item>
                <ui-dropdown-menu-sub>
                  <ui-dropdown-menu-sub-trigger>
                    ${MoreHorizontalIcon()}
                    More Projects
                  </ui-dropdown-menu-sub-trigger>
                  <ui-dropdown-menu-sub-content>
                    <ui-dropdown-menu-item>
                      ${FileCodeIcon()}
                      Project Gamma
                    </ui-dropdown-menu-item>
                    <ui-dropdown-menu-item>
                      ${FileCodeIcon()}
                      Project Delta
                    </ui-dropdown-menu-item>
                  </ui-dropdown-menu-sub-content>
                </ui-dropdown-menu-sub>
              </ui-dropdown-menu-group>
              <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
              <ui-dropdown-menu-group>
                <ui-dropdown-menu-item>
                  ${FolderSearchIcon()}
                  Browse...
                </ui-dropdown-menu-item>
              </ui-dropdown-menu-group>
            </ui-dropdown-menu-sub-content>
          </ui-dropdown-menu-sub>
          <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
          <ui-dropdown-menu-item>
            ${SaveIcon()}
            Save
            <ui-dropdown-menu-shortcut>⌘S</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            ${DownloadIcon()}
            Export
            <ui-dropdown-menu-shortcut>⇧⌘E</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>View</ui-dropdown-menu-label>
          <ui-dropdown-menu-item type="checkbox" value="sidebar" checked>
            ${EyeIcon()}
            Show Sidebar
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item type="checkbox" value="status-bar">
            ${LayoutIcon()}
            Show Status Bar
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-sub>
            <ui-dropdown-menu-sub-trigger>
              ${PaletteIcon()}
              Theme
            </ui-dropdown-menu-sub-trigger>
            <ui-dropdown-menu-sub-content>
              <ui-dropdown-menu-group>
                <ui-dropdown-menu-label>Appearance</ui-dropdown-menu-label>
                <ui-dropdown-menu-group aria-label="Appearance">
                  <ui-dropdown-menu-item type="radio" value="light" checked>
                    ${SunIcon()}
                    Light
                  </ui-dropdown-menu-item>
                  <ui-dropdown-menu-item type="radio" value="dark">
                    ${MoonIcon()}
                    Dark
                  </ui-dropdown-menu-item>
                  <ui-dropdown-menu-item type="radio" value="system">
                    ${MonitorIcon()}
                    System
                  </ui-dropdown-menu-item>
                </ui-dropdown-menu-group>
              </ui-dropdown-menu-group>
            </ui-dropdown-menu-sub-content>
          </ui-dropdown-menu-sub>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-label>Account</ui-dropdown-menu-label>
          <ui-dropdown-menu-item>
            ${UserIcon()}
            Profile
            <ui-dropdown-menu-shortcut>⇧⌘P</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            ${CreditCardIcon()}
            Billing
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-sub>
            <ui-dropdown-menu-sub-trigger>
              ${SettingsIcon()}
              Settings
            </ui-dropdown-menu-sub-trigger>
            <ui-dropdown-menu-sub-content>
              <ui-dropdown-menu-group>
                <ui-dropdown-menu-label>Preferences</ui-dropdown-menu-label>
                <ui-dropdown-menu-item>
                  ${KeyboardIcon()}
                  Keyboard Shortcuts
                </ui-dropdown-menu-item>
                <ui-dropdown-menu-item>
                  ${LanguagesIcon()}
                  Language
                </ui-dropdown-menu-item>
                <ui-dropdown-menu-sub>
                  <ui-dropdown-menu-sub-trigger>
                    ${BellIcon()}
                    Notifications
                  </ui-dropdown-menu-sub-trigger>
                  <ui-dropdown-menu-sub-content>
                    <ui-dropdown-menu-group>
                      <ui-dropdown-menu-label>Notification Types</ui-dropdown-menu-label>
                      <ui-dropdown-menu-item type="checkbox" value="push" checked>
                        ${BellIcon()}
                        Push Notifications
                      </ui-dropdown-menu-item>
                      <ui-dropdown-menu-item type="checkbox" value="email" checked>
                        ${MailIcon()}
                        Email Notifications
                      </ui-dropdown-menu-item>
                    </ui-dropdown-menu-group>
                  </ui-dropdown-menu-sub-content>
                </ui-dropdown-menu-sub>
              </ui-dropdown-menu-group>
              <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
              <ui-dropdown-menu-group>
                <ui-dropdown-menu-item>
                  ${ShieldIcon()}
                  Privacy &amp; Security
                </ui-dropdown-menu-item>
              </ui-dropdown-menu-group>
            </ui-dropdown-menu-sub-content>
          </ui-dropdown-menu-sub>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item>
            ${HelpCircleIcon()}
            Help &amp; Support
          </ui-dropdown-menu-item>
          <ui-dropdown-menu-item>
            ${FileTextIcon()}
            Documentation
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
        <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
        <ui-dropdown-menu-group>
          <ui-dropdown-menu-item variant="destructive">
            ${LogOutIcon()}
            Sign Out
            <ui-dropdown-menu-shortcut>⇧⌘Q</ui-dropdown-menu-shortcut>
          </ui-dropdown-menu-item>
        </ui-dropdown-menu-group>
      </ui-dropdown-menu-content>
    </ui-dropdown-menu>
  `;
}
View Code

RTL

To enable RTL support, see the RTL configuration guide.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import { CreditCardIcon, SettingsIcon, UserIcon } from '#lib/ui/lucide.ts';

const translations = {
  en: {
    dir: 'ltr',
    values: {
      open: 'Open',
      account: 'Account',
      profile: 'Profile',
      billing: 'Billing',
      settings: 'Settings',
      logout: 'Log out',
      team: 'Team',
      inviteUsers: 'Invite users',
      email: 'Email',
      message: 'Message',
      more: 'More',
      calendar: 'Calendar',
      chat: 'Chat',
      webhook: 'Webhook',
      advanced: 'Advanced...',
      newTeam: 'New Team',
      view: 'View',
      statusBar: 'Status Bar',
      activityBar: 'Activity Bar',
      panel: 'Panel',
      position: 'Position',
      top: 'Top',
      bottom: 'Bottom',
      right: 'Right',
      left: 'Left',
    },
  },
  ar: {
    dir: 'rtl',
    values: {
      open: 'افتح القائمة',
      account: 'الحساب',
      profile: 'الملف الشخصي',
      billing: 'الفوترة',
      settings: 'الإعدادات',
      logout: 'تسجيل الخروج',
      team: 'الفريق',
      inviteUsers: 'دعوة المستخدمين',
      email: 'البريد الإلكتروني',
      message: 'رسالة',
      more: 'المزيد',
      calendar: 'تقويم',
      chat: 'دردشة',
      webhook: 'خطاف ويب',
      advanced: 'متقدم...',
      newTeam: 'فريق جديد',
      view: 'عرض',
      statusBar: 'شريط الحالة',
      activityBar: 'شريط النشاط',
      panel: 'اللوحة',
      position: 'الموضع',
      top: 'أعلى',
      bottom: 'أسفل',
      right: 'يمين',
      left: 'يسار',
    },
  },
  he: {
    dir: 'rtl',
    values: {
      open: 'פתח תפריט',
      account: 'חשבון',
      profile: 'פרופיל',
      billing: 'חיוב',
      settings: 'הגדרות',
      logout: 'התנתק',
      team: 'הצוות',
      inviteUsers: 'הזמן משתמשים',
      email: 'אימייל',
      message: 'הודעה',
      more: 'עוד',
      calendar: 'יומן',
      chat: "צ'אט",
      webhook: 'Webhook',
      advanced: 'מתקדם...',
      newTeam: 'צוות חדש',
      view: 'תצוגה',
      statusBar: 'שורת סטטוס',
      activityBar: 'שורת פעילות',
      panel: 'לוח',
      position: 'מיקום',
      top: 'למעלה',
      bottom: 'למטה',
      right: 'ימין',
      left: 'שמאל',
    },
  },
};

export default function DropdownMenuRtl() {
  const lang = 'ar';
  const { dir, values: t } = translations[lang];

  return html`
    <div dir=${dir} lang=${lang}>
      <ui-dropdown-menu>
        <ui-dropdown-menu-trigger>
          <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>${t.open}</button>
        </ui-dropdown-menu-trigger>
        <ui-dropdown-menu-content class="w-36" data-lang=${lang}>
          <ui-dropdown-menu-group>
            <ui-dropdown-menu-sub>
              <ui-dropdown-menu-sub-trigger>${t.account}</ui-dropdown-menu-sub-trigger>
              <ui-dropdown-menu-sub-content data-lang=${lang}>
                <ui-dropdown-menu-group>
                  <ui-dropdown-menu-item>
                    ${UserIcon()}
                    ${t.profile}
                  </ui-dropdown-menu-item>
                  <ui-dropdown-menu-item>
                    ${CreditCardIcon()}
                    ${t.billing}
                  </ui-dropdown-menu-item>
                  <ui-dropdown-menu-item>
                    ${SettingsIcon()}
                    ${t.settings}
                  </ui-dropdown-menu-item>
                </ui-dropdown-menu-group>
              </ui-dropdown-menu-sub-content>
            </ui-dropdown-menu-sub>
          </ui-dropdown-menu-group>
          <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
          <ui-dropdown-menu-group>
            <ui-dropdown-menu-label>${t.team}</ui-dropdown-menu-label>
            <ui-dropdown-menu-item>${t.team}</ui-dropdown-menu-item>
            <ui-dropdown-menu-sub>
              <ui-dropdown-menu-sub-trigger>${t.inviteUsers}</ui-dropdown-menu-sub-trigger>
              <ui-dropdown-menu-sub-content data-lang=${lang}>
                <ui-dropdown-menu-item>${t.email}</ui-dropdown-menu-item>
                <ui-dropdown-menu-item>${t.message}</ui-dropdown-menu-item>
                <ui-dropdown-menu-sub>
                  <ui-dropdown-menu-sub-trigger>${t.more}</ui-dropdown-menu-sub-trigger>
                  <ui-dropdown-menu-sub-content data-lang=${lang}>
                    <ui-dropdown-menu-item>${t.calendar}</ui-dropdown-menu-item>
                    <ui-dropdown-menu-item>${t.chat}</ui-dropdown-menu-item>
                    <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
                    <ui-dropdown-menu-item>${t.webhook}</ui-dropdown-menu-item>
                  </ui-dropdown-menu-sub-content>
                </ui-dropdown-menu-sub>
                <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
                <ui-dropdown-menu-item>${t.advanced}</ui-dropdown-menu-item>
              </ui-dropdown-menu-sub-content>
            </ui-dropdown-menu-sub>
            <ui-dropdown-menu-item>
              ${t.newTeam}
              <ui-dropdown-menu-shortcut>⌘+T</ui-dropdown-menu-shortcut>
            </ui-dropdown-menu-item>
          </ui-dropdown-menu-group>
          <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
          <ui-dropdown-menu-group>
            <ui-dropdown-menu-label>${t.view}</ui-dropdown-menu-label>
            <ui-dropdown-menu-item type="checkbox" value="status-bar" checked>${t.statusBar}</ui-dropdown-menu-item>
            <ui-dropdown-menu-item type="checkbox" value="activity-bar">${t.activityBar}</ui-dropdown-menu-item>
            <ui-dropdown-menu-item type="checkbox" value="panel">${t.panel}</ui-dropdown-menu-item>
          </ui-dropdown-menu-group>
          <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
          <ui-dropdown-menu-group>
            <ui-dropdown-menu-label>${t.position}</ui-dropdown-menu-label>
            <ui-dropdown-menu-group aria-label=${t.position}>
              <ui-dropdown-menu-item type="radio" value="top">${t.top}</ui-dropdown-menu-item>
              <ui-dropdown-menu-item type="radio" value="bottom" checked>${t.bottom}</ui-dropdown-menu-item>
              <ui-dropdown-menu-item type="radio" value="right">${t.right}</ui-dropdown-menu-item>
              <ui-dropdown-menu-item type="radio" value="left">${t.left}</ui-dropdown-menu-item>
            </ui-dropdown-menu-group>
          </ui-dropdown-menu-group>
          <ui-dropdown-menu-separator></ui-dropdown-menu-separator>
          <ui-dropdown-menu-group>
            <ui-dropdown-menu-item variant="destructive">${t.logout}</ui-dropdown-menu-item>
          </ui-dropdown-menu-group>
        </ui-dropdown-menu-content>
      </ui-dropdown-menu>
    </div>
  `;
}
View Code

API Reference

The menu is a set of custom elements with its own keyboard navigation, focus management and positioning, following the APG menu pattern. The trigger gets aria-haspopup, aria-expanded and aria-controls, and every close path returns focus somewhere sensible.

ui-dropdown-menu

The root. It holds the open state.

AttributeTypeDefault
openbooleanfalse
triggerstring-

trigger names the id of a button to use as the trigger in place of <ui-dropdown-menu-trigger>, for a trigger that must be a direct child of something else, such as a button group. The element also has .show(), .hide() and .toggle() methods.

EventDetail
ui-open-change{ open }, after a transition
ui-item-select{ value, item, type, checked }, bubbled from an item on activation

ui-item-select is cancelable. Calling preventDefault() keeps the menu open, which a multi-select checkbox menu wants.

ui-dropdown-menu-trigger

Wraps the button that opens the menu.

ui-dropdown-menu-content

The menu panel. Classes on it, such as a width, are merged with its own.

AttributeTypeDefault
side"top" | "right" | "bottom" | "left""bottom"
align"start" | "center" | "end""start"
side-offsetnumber4
align-offsetnumber0

ui-dropdown-menu-item

One action. With type="checkbox" or type="radio" it is a checkable item that shows its checked state, a checkbox item or one choice in a radio group.

AttributeTypeDefault
variant"default" | "destructive""default"
insetbooleanfalse
type"checkbox" | "radio"-
checkedbooleanfalse
valuestring""
data-disabledbooleanfalse
<ui-dropdown-menu-item type="checkbox" value="status" checked>
  Status bar
</ui-dropdown-menu-item>

ui-dropdown-menu-group

Groups items. It is also the radio set: the type="radio" items inside the nearest group are exclusive. Name a radio set with aria-label or aria-labelledby in the markup.

ui-dropdown-menu-label

AttributeTypeDefault
insetbooleanfalse

ui-dropdown-menu-separator

A divider between groups.

ui-dropdown-menu-shortcut

A keyboard hint, aligned to the end of the item. It documents a shortcut and does not bind one.

ui-dropdown-menu-sub

A nested menu: a <ui-dropdown-menu-sub-trigger> and a <ui-dropdown-menu-sub-content>. ArrowRight on the trigger opens it and ArrowLeft closes it. The sub-trigger takes inset and data-disabled, and the sub-content takes the same placement attributes as the content, opening to the right by default.