DropdownMenu

Organism

Accessible dropdown using role="menu" + role="menuitem". Closes on Escape and outside click. Supports left/right alignment, icons, separators, danger and disabled items, and arrow-key navigation. Items take an optional id, href, group, order, hidden and disabledReason so other modules can contribute entries; portal escapes clipping parents.

Default (left aligned)

Preview
Code
<%- include('modules/ui/DropdownMenu', {
  id: 'actions-menu',
  trigger: '<button>Actions</button>',
  items: [
    { label: 'View', icon: '<i class="fa-solid fa-eye"></i>' },
    { label: 'Edit', icon: '<i class="fa-solid fa-pen"></i>' },
    { label: 'Duplicate', icon: '<i class="fa-solid fa-copy"></i>' }
  ]
}) %>

With separator & danger

Preview
Code
<%- include('modules/ui/DropdownMenu', {
  id: 'row-menu',
  align: 'right',
  trigger: '<button aria-label="More options"><i class="fa-solid fa-ellipsis-vertical"></i></button>',
  items: [
    { label: 'Open', icon: '...' },
    { label: 'Rename', icon: '...' },
    { label: 'Archive', icon: '...', disabled: true },
    { type: 'separator' },
    { label: 'Delete', icon: '...', danger: true }
  ]
}) %>

With header

Preview
Code
<%- include('modules/ui/DropdownMenu', {
  id: 'account-menu',
  trigger: '<button>Account</button>',
  header: '<div class="px-3 py-2">...</div>',
  items: [
    { label: 'Profile', icon: '...' },
    { label: 'Settings', icon: '...' },
    { type: 'separator' },
    { label: 'Sign out', icon: '...', danger: true }
  ]
}) %>

Contributed items: group, order, hidden, href, disabledReason

Preview
Code
<%# Items sort by group (ranked by their lowest order) and order; a separator splits groups. %>
<%- include('modules/ui/DropdownMenu', {
  trigger: '<button type="button" class="…">Contact</button>',
  items: [
    { id: 'edit', label: 'Edit', group: 'record', order: 10 },
    { id: 'call', label: 'Call', group: 'contact', order: 20, href: '/calls/new' },
    { id: 'sign', label: 'Send for signature', group: 'contact', order: 30, disabled: true, disabledReason: 'Add an email address first' },
    { id: 'campaign', label: 'Add to campaign', group: 'contact', order: 40, hidden: !canMarket },
    { id: 'delete', label: 'Delete', group: 'danger', order: 1000, danger: true },
  ]
}) %>
Source modules/ui/DropdownMenu.ejs