Components Overlays

Dropdown menu

Choose a sort order from a compact menu of mutually exclusive options.

Live previewGo + JavaScript

Usage

Supply Label and Value on each item; mark one Selected to set the initial choice. Enter, Space, or Down opens the menu. Arrow keys, Home, End, and first letters navigate. Listen for mono:choose and use detail.value.

Register dropdown-menu with Head and pass its properties to Render. Go setup guide

Go usage
Go usage
err := mono.UI.Render(w, "dropdown-menu", mono.Props{
	"Items": []any{
		map[string]any{
			"Label":    "Newest first",
			"Selected": true,
			"Value":    "newest",
		},
		map[string]any{
			"Label": "Oldest first",
			"Value": "oldest",
		},
		map[string]any{
			"Label": "Title A–Z",
			"Value": "title",
		},
	},
	"Label":   "Issue sort order",
	"Trigger": "Sort issues",
})
Rendered HTML
Rendered HTML
<div id="demo-dropdown-menu" data-mono="dropdown-menu" class="mu-stack">
  
  <button type="button" class="mu-btn" data-open aria-haspopup="menu" aria-expanded="false" aria-controls="demo-dropdown-menu-menu" popovertarget="demo-dropdown-menu-menu">Sort issues</button>
  <div id="demo-dropdown-menu-menu" role="menu" aria-label="Issue sort order" popover class="mu-panel">
    <button type="button" class="mu-item mu-choice" tabindex="-1" role="menuitemradio" aria-checked="true" data-value="newest">Newest first</button><button type="button" class="mu-item mu-choice" tabindex="-1" role="menuitemradio" aria-checked="false" data-value="oldest">Oldest first</button><button type="button" class="mu-item mu-choice" tabindex="-1" role="menuitemradio" aria-checked="false" data-value="title">Title A–Z</button>
  </div>
  <p data-result class="mu-small" role="status"></p>
</div>
Go template
Go template
<div id="{{.ID}}" data-mono="dropdown-menu" class="mu-stack">
  
  <button type="button" class="mu-btn" data-open aria-haspopup="menu" aria-expanded="false" aria-controls="{{.ID}}-menu" popovertarget="{{.ID}}-menu">{{.Trigger}}</button>
  <div id="{{.ID}}-menu" role="menu" aria-label="{{.Label}}" popover class="mu-panel">
    {{range .Items}}<button type="button" class="mu-item mu-choice" tabindex="-1" role="menuitemradio" aria-checked="{{if .Selected}}true{{else}}false{{end}}" data-value="{{.Value}}"{{if .Disabled}} disabled{{end}}>{{.Label}}</button>{{end}}
  </div>
  <p data-result class="mu-small" role="status"></p>
</div>
Component CSS
Component CSS
[data-mono="dropdown-menu"] [role="menu"] { inset: auto; position: fixed; margin: 0; padding: .3rem; min-width: 11rem; max-width: calc(100vw - 1rem); max-height: calc(100dvh - 1rem); overflow: auto; background: white; color: #171717; border: 1px solid #c5c5c5; border-radius: .45rem; box-shadow: 0 .55rem 1.75rem #0002; }
[data-mono="dropdown-menu"] [role="menu"] button { display: flex; width: 100%; padding: .5rem .65rem; text-align: start; border-radius: .22rem; background: transparent; color: inherit; }
[data-mono="dropdown-menu"] [role="menu"] button:focus { background: #eee; outline: 1px solid #777; outline-offset: -1px; }
[data-mono="dropdown-menu"] > button { align-self: flex-start; justify-self: start; }
[data-mono="dropdown-menu"] [data-result]:empty { display: none; }
JavaScript module
JavaScript module
export function mount(root) {
  const trigger = root.querySelector('[data-open]');
  const menu = root.querySelector('[role="menu"]');
  const items = [...menu.querySelectorAll('button:not(:disabled)')];
  let opener = trigger;

  function position(x, y) {
    const width = menu.offsetWidth;
    const height = menu.offsetHeight;
    menu.style.left = Math.max(8, Math.min(x, document.documentElement.clientWidth - width - 8)) + 'px';
    menu.style.top = Math.max(8, Math.min(y, document.documentElement.clientHeight - height - 8)) + 'px';
  }

  function open(origin, coords, last = false) {
    if (!items.length) return;
    opener = origin;
    menu.showPopover();
    position(...coords);
    trigger.setAttribute('aria-expanded', 'true');
    const current = menu.querySelector('[aria-checked="true"]:not(:disabled)');
    (last ? items.at(-1) : current || items[0]).focus();
  }
  function fromTrigger(last) {
    const rect = trigger.getBoundingClientRect();
    open(trigger, [rect.left, rect.bottom + 4], last);
  }
  function close(restore) {
    menu.hidePopover();
    if (restore) opener.focus();
  }
  trigger.addEventListener('click', event => {
    event.preventDefault();
    if (menu.matches(':popover-open')) close(true);
    else fromTrigger(false);
  });
  trigger.addEventListener('keydown', event => {
    if (!['ArrowDown', 'ArrowUp'].includes(event.key)) return;
    event.preventDefault();
    fromTrigger(event.key === 'ArrowUp');
  });
  function whileMoving() {
    const rect = trigger.getBoundingClientRect();
    position(rect.left, rect.bottom + 4);
  }
  menu.addEventListener('toggle', () => {
    const visible = menu.matches(':popover-open');
    trigger.setAttribute('aria-expanded', String(visible));
    if (visible) {
      window.addEventListener('resize', whileMoving);
      document.addEventListener('scroll', whileMoving, true);
    } else {
      window.removeEventListener('resize', whileMoving);
      document.removeEventListener('scroll', whileMoving, true);
    }
  });
  menu.addEventListener('keydown', event => {
    const index = items.indexOf(document.activeElement);
    let next;
    if (event.key === 'Escape') {
      event.preventDefault();
      close(true);
      return;
    }
    if (event.key === 'Tab') {
      close(true);
      return;
    }
    if (event.key === 'ArrowDown') next = (index + 1) % items.length;
    else if (event.key === 'ArrowUp') next = (index - 1 + items.length) % items.length;
    else if (event.key === 'Home') next = 0;
    else if (event.key === 'End') next = items.length - 1;
    else if (event.key.length === 1 && event.key !== ' ' && !event.ctrlKey && !event.metaKey && !event.altKey) {
      const key = event.key.toLowerCase();
      const sequence = [...items.slice(index + 1), ...items.slice(0, index + 1)];
      const match = sequence.find(item => item.textContent.trim().toLowerCase().startsWith(key));
      if (match) next = items.indexOf(match);
    }
    if (next !== undefined) {
      event.preventDefault();
      items[next].focus();
    }
  });
  menu.addEventListener('click', event => {
    const item = event.target.closest('button:not(:disabled)');
    if (!item || !menu.contains(item)) return;
    for (const option of items) option.setAttribute('aria-checked', String(option === item));
    root.querySelector('[data-result]').textContent = item.textContent;
    root.dispatchEvent(new CustomEvent('mono:choose', { bubbles: true, detail: { value: item.dataset.value } }));
    close(true);
  });
}
Use the HTML in a static site

Copy the rendered HTML above. Download these assets into the same folder as your page, then add the tags below to its head.

Shared CSS Component CSS Ready-to-use module

HTML head
<link rel="stylesheet" href="./base.css">
<link rel="stylesheet" href="./dropdown-menu.css">
<script type="module" src="./dropdown-menu.js"></script>

Copy into your project

Run this command from the Mono checkout. Set -out to the component directory in your application.

Terminal
go run ./cmd/mono-ui add -out ./components dropdown-menu
Example properties (JSON)
example.json
{
  "Items": [
    {
      "Label": "Newest first",
      "Selected": true,
      "Value": "newest"
    },
    {
      "Label": "Oldest first",
      "Value": "oldest"
    },
    {
      "Label": "Title A–Z",
      "Value": "title"
    }
  ],
  "Label": "Issue sort order",
  "Trigger": "Sort issues"
}