Skip to content

DropdownMenu

Desktop-style popup menu with click trigger and context menu support.

Basic Usage

Wrap the trigger element with ADropdownMenu and define menu items with AMenuItem.

vue
<ADropdownMenu>
  <template #trigger>
    <ABtn>Actions</ABtn>
  </template>
  <AMenuItem label="New File" />
  <AMenuItem label="Open File" />
  <AMenuDivider />
  <AMenuItem label="Save" accelerator="⌘S" />
  <AMenuItem label="Save As" disabled />
</ADropdownMenu>

Danger Action

Set danger to mark a dangerous action.

vue
<ADropdownMenu>
  <template #trigger>
    <ABtn>More</ABtn>
  </template>
  <AMenuItem label="Edit" />
  <AMenuDivider />
  <AMenuItem label="Delete" danger />
</ADropdownMenu>

Context Menu

Set trigger="contextmenu" for right-click menu.

Right-click here
vue
<ADropdownMenu trigger="contextmenu">
  <template #trigger>
    <div>Right-click here</div>
  </template>
  <AMenuItem label="Copy" />
  <AMenuItem label="Paste" />
  <AMenuDivider />
  <AMenuItem label="Select All" />
</ADropdownMenu>

Groups

Use AMenuGroup to group menu items.

vue
<ADropdownMenu>
  <template #trigger>
    <ABtn>Group Menu</ABtn>
  </template>
  <AMenuGroup label="Edit">
    <AMenuItem label="Undo" />
    <AMenuItem label="Redo" />
  </AMenuGroup>
  <AMenuDivider />
  <AMenuGroup label="View">
    <AMenuItem label="Zoom" />
    <AMenuItem label="Fullscreen" />
  </AMenuGroup>
</ADropdownMenu>

API

NameTypeDefaultDescription
modelValuebooleanfalseVisibility
trigger'click' | 'contextmenu' | 'hover''click'Trigger method
placement'bottom-start' | 'bottom' | 'bottom-end' | 'top-start' | 'top' | 'top-end''bottom-start'Popup position
disabledbooleanfalseDisabled
autoClosebooleantrueAuto-close on item click
NameDescription
update:modelValueVisibility changed
openOpened
closeClosed
NameTypeDefaultDescription
labelstringMenu item text
disabledbooleanfalseDisabled
dangerbooleanfalseDanger mode
iconstringIcon class name (RemixIcon)
acceleratorstringKeyboard shortcut text

Interaction

  • Auto-close on outside click
  • Auto-close on item select (autoClose)
  • Disabled state prevents interaction
  • Danger operations highlighted in red
  • Context menu positions at mouse location
  • Fade + translate open animation

MIT License