Components Overlays
Dropdown menu
Choose a sort order from a compact menu of mutually exclusive options.
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
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
<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
<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
[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
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
<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.
go run ./cmd/mono-ui add -out ./components dropdown-menuExample properties (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"
}