Dropdown

Raised floating menus that open on click and close on outside click or Escape.

This component requires softui.js for interactive behavior.

Default

<div class="sui-dropdown">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Options</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Profile</button>
    <button class="sui-dropdown-item" role="menuitem">Settings</button>
    <button class="sui-dropdown-item" role="menuitem">Notifications</button>
  </div>
</div>

Button Colors

<div class="sui-dropdown">
  <button class="sui-btn sui-btn-primary sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Primary</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
  </div>
</div>

<div class="sui-dropdown">
  <button class="sui-btn sui-btn-success sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Success</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
  </div>
</div>

<div class="sui-dropdown">
  <button class="sui-btn sui-btn-danger sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Danger</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
  </div>
</div>

<div class="sui-dropdown">
  <button class="sui-btn sui-btn-outline sui-btn-primary sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Outline</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
  </div>
</div>

Split Button

<div class="sui-dropdown-split">
  <button class="sui-btn sui-btn-primary">Save</button>
  <button class="sui-btn sui-btn-primary sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true" aria-label="More save options"></button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Save as draft</button>
    <button class="sui-dropdown-item" role="menuitem">Save and publish</button>
    <button class="sui-dropdown-item" role="menuitem">Save as template</button>
  </div>
</div>

<div class="sui-dropdown-split">
  <button class="sui-btn sui-btn-danger">Delete</button>
  <button class="sui-btn sui-btn-danger sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true" aria-label="More delete options"></button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Move to trash</button>
    <button class="sui-dropdown-item" role="menuitem" style="color:var(--sui-danger-text);">Delete permanently</button>
  </div>
</div>

With Links

<div class="sui-dropdown">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Navigate</button>
  <div class="sui-dropdown-menu" role="menu">
    <a href="#" class="sui-dropdown-item" role="menuitem">Documentation</a>
    <a href="#" class="sui-dropdown-item" role="menuitem">API Reference</a>
    <a href="#" class="sui-dropdown-item" role="menuitem">Examples</a>
  </div>
</div>

Headers & Dividers

<div class="sui-dropdown">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">More Actions</button>
  <div class="sui-dropdown-menu" role="menu">
    <span class="sui-dropdown-header">File</span>
    <button class="sui-dropdown-item" role="menuitem">New</button>
    <button class="sui-dropdown-item" role="menuitem">Open</button>
    <button class="sui-dropdown-item" role="menuitem">Save</button>
    <div class="sui-dropdown-divider"></div>
    <span class="sui-dropdown-header">Edit</span>
    <button class="sui-dropdown-item" role="menuitem">Cut</button>
    <button class="sui-dropdown-item" role="menuitem">Copy</button>
    <button class="sui-dropdown-item" role="menuitem">Paste</button>
    <div class="sui-dropdown-divider"></div>
    <button class="sui-dropdown-item" role="menuitem" style="color:var(--sui-danger-text);">Delete</button>
  </div>
</div>

Disabled Items

<div class="sui-dropdown">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">User Menu</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item active" role="menuitem">Dashboard</button>
    <button class="sui-dropdown-item" role="menuitem">Settings</button>
    <button class="sui-dropdown-item disabled" role="menuitem">Admin Panel</button>
    <div class="sui-dropdown-divider"></div>
    <button class="sui-dropdown-item" role="menuitem">Log Out</button>
  </div>
</div>

Directions

<!-- Down (default) -->
<div class="sui-dropdown">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Dropdown</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
  </div>
</div>

<!-- Up -->
<div class="sui-dropdown sui-dropup">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Dropup</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
  </div>
</div>

<!-- Right -->
<div class="sui-dropdown sui-dropend">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Dropend</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
  </div>
</div>

<!-- Left -->
<div class="sui-dropdown sui-dropstart">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Dropstart</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
  </div>
</div>

Menu Alignment

Add sui-dropdown-menu-end to align the menu to the button's end edge.

<!-- Start-aligned (default) -->
<div class="sui-dropdown">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Start-aligned</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Menu left edge matches</button>
    <button class="sui-dropdown-item" role="menuitem">button left edge</button>
  </div>
</div>

<!-- End-aligned -->
<div class="sui-dropdown">
  <button class="sui-btn sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">End-aligned</button>
  <div class="sui-dropdown-menu sui-dropdown-menu-end" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Menu right edge matches</button>
    <button class="sui-dropdown-item" role="menuitem">button right edge</button>
  </div>
</div>

Sizing

sui-dropdown-sm and sui-dropdown-lg resize the menu items.

<!-- Small -->
<div class="sui-dropdown sui-dropdown-sm">
  <button class="sui-btn sui-btn-sm sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Small</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
    <button class="sui-dropdown-item" role="menuitem">Action Three</button>
  </div>
</div>

<!-- Large -->
<div class="sui-dropdown sui-dropdown-lg">
  <button class="sui-btn sui-btn-lg sui-dropdown-toggle" data-sui-dropdown aria-expanded="false" aria-haspopup="true">Large</button>
  <div class="sui-dropdown-menu" role="menu">
    <button class="sui-dropdown-item" role="menuitem">Action One</button>
    <button class="sui-dropdown-item" role="menuitem">Action Two</button>
    <button class="sui-dropdown-item" role="menuitem">Action Three</button>
  </div>
</div>

Reference

Class / Attribute / KeyDescription
data-sui-dropdownMarks the toggle that opens and closes its menu; an outside click closes it.
sui-dropup / sui-dropend / sui-dropstartOpens the menu above, to the end side or to the start side.
sui-dropdown-menu-endAligns the menu to the toggle's end edge.
sui-dropdown-sm / sui-dropdown-lgSmaller or larger menu items.
sui-dropdown-no-arrowHides the toggle's caret (on .sui-dropdown or the toggle).
sui-dropdown-headerSmall uppercase group label inside the menu.
sui-dropdown-dividerLine between item groups.
sui-dropdown-textMuted plain text inside the menu.
active / disabledMarks the current item, or dims an item and skips it in keyboard navigation.
↑ / ↓Move focus through the open menu's items (wraps).
EscClose the menu; focus returns to the toggle.

Delete this item?

This action cannot be undone. This will permanently delete the item and remove all associated data.