A list of actions or options, made of orb-mi items.
Usage
A menu is a list of actions. Put <orb-mi> items in an <orb-menu>, and set the menu’s for to the id of the button that opens it. The button and the menu must be in the same document or shadow root. Choosing an item emits orbSelect with the item’s value, then closes the menu.
Set mode to single or multi to make the menu a list of options instead. See Single and Multiple Selection below. Set search to add a search field. See Search below.
Menus scroll inside ::part(list), so style padding and scrolling there rather than on the host.
Choose an item.
<orb-button id="file-button">File</orb-button>
<orb-menu id="file-menu" for="file-button">
<orb-mi value="new">New</orb-mi>
<orb-mi value="open">Open…</orb-mi>
<orb-mi value="save">Save</orb-mi>
<orb-divider></orb-divider>
<orb-mi value="close">Close</orb-mi>
</orb-menu>
<p id="file-output" role="status" style="margin-top: 1rem;">Choose an item.</p>
const output = document.querySelector("#file-output");
document.querySelector("#file-menu").addEventListener("orbSelect", (event) => {
output.textContent = `Chose ${event.detail.value}`;
});
Menus opened from the keyboard move focus to an item, and return it to the button when they close. Menus opened with the mouse leave focus alone, and items highlight as the pointer moves over them. The menu sets aria-haspopup="menu" and aria-expanded on its button, and takes its name from the button unless you set label.
Manual test:
- Click File. The menu opens below it, with no item highlighted. Hovering highlights items.
- Click Save. The status reads
Chose saveand the menu closes, with no focus ring left on File. - Click File, then press Down. New is focused, and the arrow keys work from there.
- Click File, then press Escape. The menu closes.
- Click File, then click it again. The menu closes.
- Tab to File and press Enter. The menu opens with New focused. Press Escape. The menu closes and focus returns to File.
- With File focused, press Down to open the menu on the first item, or Up to open it on the last.
Examples
Placement
Menus open below their button, lined up with its start. Set placement to open elsewhere, such as bottom-end for a button at the end of a toolbar. Menus flip to the other side when there isn’t room.
<div style="display: flex; justify-content: flex-end;">
<orb-button id="account-button" fill="outline">Account</orb-button>
<orb-menu for="account-button" placement="bottom-end">
<orb-mi value="profile">Profile</orb-mi>
<orb-mi value="settings">Settings</orb-mi>
<orb-mi value="sign-out">Sign out</orb-mi>
</orb-menu>
</div>
Manual test:
- Click Account. The menu’s end edge lines up with the button’s end edge.
- Scroll so Account is near the bottom of the window, then open it. The menu opens above the button.
Context Menu
Set show-on="context-menu" to open the menu where its for element is right-clicked. The context menu key and Shift+F10 open it too, at the element. Right-clicking somewhere else in the element while the menu is open moves it there.
<div id="context-area" tabindex="0" style="display: grid; place-items: center; height: 10rem; border: 1px dashed currentColor; border-radius: 0.5rem;">
Right-click here
</div>
<orb-menu for="context-area" show-on="context-menu" label="Window">
<orb-mi>
<iconify-icon icon="mdi:minimize" slot="icon"></iconify-icon>
Minimize
<span slot="details">⌘M</span>
</orb-mi>
<orb-mi>
<iconify-icon icon="mdi:zoom-in" slot="icon"></iconify-icon>
Zoom
</orb-mi>
<orb-mi>
<iconify-icon icon="mdi:fullscreen" slot="icon"></iconify-icon>
Fill
</orb-mi>
<orb-mi>
<iconify-icon icon="mdi:image-filter-center-focus" slot="icon"></iconify-icon>
Center
</orb-mi>
</orb-menu>
Manual test:
- Right-click inside the box. The menu opens at the pointer, with no item highlighted.
- With the menu open, right-click another spot in the box. The menu moves there without closing.
- Right-clicking outside the box shows the browser’s own menu, and closes this one.
- Tab to the box and press Shift+F10. The menu opens at the box with Minimize focused.
Icons and Details
Put an icon in an item’s icon slot, and extra text such as a keyboard shortcut in its details slot. Details are lined up at the end of the item.
<orb-button id="edit-button">Edit</orb-button>
<orb-menu for="edit-button">
<orb-mi>
<iconify-icon icon="mdi:undo" slot="icon"></iconify-icon>
Undo
<kbd slot="details">⌘Z</kbd>
</orb-mi>
<orb-mi>
<iconify-icon icon="mdi:redo" slot="icon"></iconify-icon>
Redo
<kbd slot="details">⇧⌘Z</kbd>
</orb-mi>
<orb-divider></orb-divider>
<orb-mi>
<iconify-icon icon="mdi:content-cut" slot="icon"></iconify-icon>
Cut
<kbd slot="details">⌘X</kbd>
</orb-mi>
<orb-mi>
<iconify-icon icon="mdi:content-copy" slot="icon"></iconify-icon>
Copy
<kbd slot="details">⌘C</kbd>
</orb-mi>
<orb-mi>
<iconify-icon icon="mdi:content-paste" slot="icon"></iconify-icon>
Paste
<kbd slot="details">⌘V</kbd>
</orb-mi>
</orb-menu>
Manual test:
- Icons line up in one column and the shortcuts line up at the end.
- Shortcuts are a muted color but still readable.
Checkbox and Radio Items
Set type="checkbox" for an item that toggles. It stays open after it’s chosen so several can be changed at once. Set type="radio" for a set of options where only one can be checked. Radio items are grouped by their parent element, so wrap each set in an element, such as a div, when a menu has more than one. orbSelect reports the item’s new checked state.
Ruler on, grid off, medium.
<orb-button id="view-button">View</orb-button>
<orb-menu id="view-menu" for="view-button">
<orb-mi type="checkbox" value="ruler" checked>Ruler</orb-mi>
<orb-mi type="checkbox" value="grid">Grid</orb-mi>
<orb-divider></orb-divider>
<div>
<orb-mi type="radio" value="small">Small</orb-mi>
<orb-mi type="radio" value="medium" checked>Medium</orb-mi>
<orb-mi type="radio" value="large">Large</orb-mi>
</div>
</orb-menu>
<p id="view-output" role="status" style="margin-top: 1rem;">Ruler on, grid off, medium.</p>
const menu = document.querySelector("#view-menu");
const output = document.querySelector("#view-output");
menu.addEventListener("orbSelect", () => {
const on = (value) => menu.querySelector(`[value="${value}"]`).checked;
const size = [...menu.querySelectorAll('[type="radio"]')].find((item) => item.checked).value;
output.textContent = `Ruler ${on("ruler") ? "on" : "off"}, grid ${on("grid") ? "on" : "off"}, ${size}.`;
});
Manual test:
- Ruler and Medium show checkmarks. All labels line up, whether or not they’re checked.
- Click Grid. It gets a checkmark, the menu stays open, and the status updates.
- Click Large. Medium loses its checkmark, the menu closes, and the status updates.
- Screen readers announce checkbox items as “checked” or “not checked”, and radio items as one of a set.
Single and Multiple Selection
Set mode="single" for a list where one option is selected, such as a sort order. Choosing an option selects it and closes the menu. Set mode="multi" for a list where several options can be selected, such as filters. Choosing an option toggles it, and the menu stays open.
Both modes make the menu a listbox, and every item acts as a radio or checkbox item, so type is ignored. Set checked on the options that start selected. Set label when the button shows the selected value, so the menu keeps its name as the selection changes. Opening the menu from the keyboard focuses the selected option.
Submenus, menubars, and show-on="context-menu" don’t work with single or multi. The menu logs a warning to the console if you use them.
Sorted by Name. Showing Images, Video.
<orb-button id="sort-button">Sort: Name</orb-button>
<orb-menu id="sort-menu" for="sort-button" mode="single" label="Sort by">
<orb-mi value="name" checked>Name</orb-mi>
<orb-mi value="date">Date</orb-mi>
<orb-mi value="size">Size</orb-mi>
</orb-menu>
<orb-button id="filter-button">Filter</orb-button>
<orb-menu id="filter-menu" for="filter-button" mode="multi" label="Filter by">
<orb-mi value="images" checked>Images</orb-mi>
<orb-mi value="video" checked>Video</orb-mi>
<orb-mi value="audio">Audio</orb-mi>
</orb-menu>
<p id="list-output" role="status" style="margin-top: 1rem;">Sorted by Name. Showing Images, Video.</p>
const output = document.querySelector("#list-output");
const sortButton = document.querySelector("#sort-button");
const sortMenu = document.querySelector("#sort-menu");
const filterMenu = document.querySelector("#filter-menu");
const chosen = (menu) => [...menu.querySelectorAll("orb-mi")]
.filter((item) => item.checked)
.map((item) => item.textContent.trim())
.join(", ");
const update = () => {
sortButton.textContent = `Sort: ${chosen(sortMenu)}`;
output.textContent = `Sorted by ${chosen(sortMenu)}. Showing ${chosen(filterMenu)}.`;
};
sortMenu.addEventListener("orbSelect", update);
filterMenu.addEventListener("orbSelect", update);
Manual test:
- Click Sort: Name, then Date. The menu closes, the button reads
Sort: Date, and the status updates. Only one option in the menu is checked. - Tab to the Sort button and press Down. Date is focused, since it’s selected.
- Click Filter, then click Audio. It gets a checkmark, the menu stays open, and the status updates.
- Click Images. It loses its checkmark, and the menu stays open.
- Screen readers announce the Sort menu as a list with one option selected, and the Filter menu as a list where several options can be selected.
Search
Set search to add a search field above the items. Typing filters them by label, and the first match is highlighted, so Enter chooses it. Arrow keys move the highlight through the matches, and focus stays in the search field. Set search-label to name the field. search works in every mode. In actions mode it makes a command palette.
Put controls at the end of the search field in the search-end slot, such as a filter menu. Put content below the items in the footer slot, such as a button. Items with the hidden attribute are removed from the list, and the keyboard skips them.
On a small touch screen, a menu with search fills the screen, with the search field above the items. The search field doesn’t take focus when the menu opens, so the keyboard stays closed until someone taps it and people can tap the items directly. Items are larger on small touch screens. Menus without search stay anchored to their button.
Model: Haiku 5.5
<orb-button id="model-button">Haiku 5.5</orb-button>
<orb-menu id="model-menu" for="model-button" mode="single" search search-label="Search a model" label="Model">
<button id="filter-button" slot="search-end" type="button">All ▾</button>
<orb-menu id="filter-menu" slot="search-end" for="filter-button" mode="single" label="Provider">
<orb-mi value="all" checked>All</orb-mi>
<orb-mi value="anthropic">Anthropic</orb-mi>
<orb-mi value="other">Other</orb-mi>
</orb-menu>
<orb-mi value="haiku" data-provider="anthropic" checked>Haiku 5.5</orb-mi>
<orb-mi value="sonnet" data-provider="anthropic">Sonnet 5.5</orb-mi>
<orb-mi value="opus" data-provider="anthropic">Opus 5.5</orb-mi>
<orb-mi value="mistral" data-provider="other">Mistral Small</orb-mi>
<orb-mi value="kimi" data-provider="other">Kimi K3</orb-mi>
<button slot="footer" type="button" id="default-button">Set as default</button>
</orb-menu>
<p id="model-output" role="status" style="margin-top: 1rem;">Model: Haiku 5.5</p>
const model = document.querySelector("#model-menu");
const modelButton = document.querySelector("#model-button");
const filterButton = document.querySelector("#filter-button");
const output = document.querySelector("#model-output");
model.addEventListener("orbSelect", (event) => {
// Choices in the filter menu bubble up here too, so ignore them.
if (event.target !== model) return;
const name = event.detail.item.textContent.trim();
modelButton.textContent = name;
output.textContent = `Model: ${name}`;
});
document.querySelector("#filter-menu").addEventListener("orbSelect", (event) => {
const provider = event.detail.value;
filterButton.textContent = `${event.detail.item.textContent.trim()} ▾`;
model.querySelectorAll(":scope > orb-mi").forEach((item) => {
item.hidden = provider !== "all" && item.dataset.provider !== provider;
});
});
document.querySelector("#default-button").addEventListener("click", () => {
const name = model.querySelector("orb-mi[checked]").textContent.trim();
output.textContent = `Default set to ${name}`;
});
Manual test:
- Click Haiku 5.5. The search field is focused, and Haiku 5.5 is highlighted.
- Type
son. Only Sonnet 5.5 shows, and it’s highlighted. Press Enter. The menu closes and the button reads Sonnet 5.5. - Open the menu and press Down. The highlight moves through the visible models only.
- Hover over a model. It’s highlighted, and typing still goes to the search field.
- Click All ▾ and choose Anthropic. The filter menu closes, the main menu stays open, and only the Anthropic models show.
- Open All ▾, then press Escape. Only the filter closes.
- Click Set as default. The status reads
Default set tothe selected model. - Press Tab from the search field. In Chrome, focus moves to All ▾, then to Set as default. In Safari, Tab leaves the menu instead, so Safari users can’t reach the controls in
search-endorfooterwith the keyboard. - On a phone-sized touch screen, the menu fills the screen with the search field above the items. The search field isn’t focused, and the keyboard is closed. Tapping an item chooses it. The items are easy to tap. The close button closes the menu.
Custom Filtering
The built-in filter matches the item’s label. To filter some other way, such as by prefix or by a server response, call preventDefault() on orbSearch and set hidden on the items yourself. orbSearch also fires with an empty query when the menu closes, so reset your filter there.
<orb-button id="fruit-button">Fruit</orb-button>
<orb-menu id="fruit-menu" for="fruit-button" search search-label="Search fruit">
<orb-mi value="apple">Apple</orb-mi>
<orb-mi value="apricot">Apricot</orb-mi>
<orb-mi value="banana">Banana</orb-mi>
<orb-mi value="cherry">Cherry</orb-mi>
</orb-menu>
const menu = document.querySelector("#fruit-menu");
menu.addEventListener("orbSearch", (event) => {
event.preventDefault();
const query = event.detail.query.trim().toLowerCase();
menu.querySelectorAll(":scope > orb-mi").forEach((item) => {
item.hidden = !item.textContent.trim().toLowerCase().startsWith(query);
});
});
Manual test:
- Type
ap. Only Apple and Apricot show. - Type
zz. No items show. - Close the menu and open it again. All four items show.
Disabled and Danger Items
disabled items can still be focused with the arrow keys, so screen reader users know they exist, but they can’t be chosen. variant="danger" marks destructive actions.
<orb-button id="actions-button">Actions</orb-button>
<orb-menu for="actions-button">
<orb-mi>Rename</orb-mi>
<orb-mi disabled>Move <span slot="details">No folders</span></orb-mi>
<orb-mi>Duplicate</orb-mi>
<orb-divider></orb-divider>
<orb-mi variant="danger">
<iconify-icon icon="mdi:delete" slot="icon"></iconify-icon>
Delete
</orb-mi>
</orb-menu>
Manual test:
- Move is dimmed. Clicking it does nothing and the menu stays open.
- Arrow onto Move. It takes focus, and Enter does nothing.
- Delete is red, including its icon.
Submenus
For a submenu, give an item an id and point another <orb-menu> at it with for. Put the submenu inside the menu it opens from, so orbSelect from the submenu bubbles up to a listener on the top menu. The item gets an arrow, and the submenu opens beside it.
Submenus open when the pointer rests on their item, or with Right, Enter, or Space. Opening a submenu keeps its parent open, and choosing an item in it closes them all.
<orb-button id="share-button">Share</orb-button>
<orb-menu id="share-menu" for="share-button">
<orb-mi value="link">Copy link</orb-mi>
<orb-mi id="send-to-item">Send to</orb-mi>
<orb-menu for="send-to-item">
<orb-mi value="email">Email</orb-mi>
<orb-mi value="messages">Messages</orb-mi>
<orb-mi id="social-item">Social</orb-mi>
<orb-menu for="social-item">
<orb-mi value="mastodon">Mastodon</orb-mi>
<orb-mi value="bluesky">Bluesky</orb-mi>
</orb-menu>
</orb-menu>
<orb-mi value="embed">Embed</orb-mi>
</orb-menu>
<p id="share-output" role="status" style="margin-top: 1rem;">Choose an item.</p>
const output = document.querySelector("#share-output");
document.querySelector("#share-menu").addEventListener("orbSelect", (event) => {
output.textContent = `Shared with ${event.detail.value}`;
});
Manual test:
- Open Share and hover Send to. The submenu opens beside it, and the Share menu stays open. Resting on Copy link closes the submenu.
- Hover Send to, then move diagonally down into the submenu, crossing Embed on the way. The submenu stays open.
- Hover Social and click Bluesky. Every menu closes and the status reads
Shared with bluesky. - With the keyboard, arrow to Send to and press Right. The submenu opens on Email. Press Left. It closes and focus returns to Send to.
- Press Escape in a submenu. Only that submenu closes.
- Click outside. Every menu closes.
Keeping the Menu Open
Call preventDefault() on orbSelect to keep the menu open after an item is chosen, for example while an action runs.
Count: 0
<orb-button id="counter-button">Counter</orb-button>
<orb-menu id="counter-menu" for="counter-button">
<orb-mi value="add">Add one</orb-mi>
<orb-mi value="done">Done</orb-mi>
</orb-menu>
<p id="counter-output" role="status" style="margin-top: 1rem;">Count: 0</p>
let count = 0;
const output = document.querySelector("#counter-output");
document.querySelector("#counter-menu").addEventListener("orbSelect", (event) => {
if (event.detail.value === "add") {
event.preventDefault();
output.textContent = `Count: ${++count}`;
}
});
Manual test:
- Click Add one a few times. The count goes up and the menu stays open.
- Click Done. The menu closes.
Inline Menus
Without for, the menu shows in the page instead of opening from a button, such as in a sidebar or a dialog.
<orb-menu label="Sort by" style="max-width: 14rem;">
<orb-mi type="radio" value="name" checked>Name</orb-mi>
<orb-mi type="radio" value="date">Date</orb-mi>
<orb-mi type="radio" value="size">Size</orb-mi>
</orb-menu>
Manual test:
- The menu shows in the page, with no box or shadow.
- Tab to it. One item takes focus, and Up and Down move between items.
Driven by an Input
Call attachInput() with an input to let it drive the menu while focus stays in the input. Up and Down highlight an item, Enter chooses the highlighted item, and Escape closes the menu. The input gets aria-activedescendant, aria-expanded, and aria-controls for the menu, and the items act as options until you call attachInput(null).
show() takes the same anchors as orb-popover: a pointer event, or an object with getBoundingClientRect, such as a Range at a caret. Set contextElement on that object to the scrolling element that contains it. The menu needs a for trigger to open, since an inline menu isn’t a popup.
const menu = document.querySelector("#command-menu");
menu.attachInput(document.querySelector("#command-input"));
// Opens the menu at the caret, and follows the editor when it scrolls
menu.show({
getBoundingClientRect: () => range.getBoundingClientRect(),
contextElement: editor,
});
Accessibility
Keyboard
| Key | Action |
|---|---|
| Enter / Space / Down | On the button, opens the menu on its first item. In single and multi menus, on the selected option |
| Up | On the button, opens the menu on its last item. In single and multi menus, on the selected option |
| Down / Up | Next or previous item, wrapping |
| Home / End | First or last item |
| Enter / Space | Chooses the item, or opens its submenu. In single menus, selects the option and closes the menu. In multi menus, toggles the option and keeps the menu open |
| Right | Opens the item’s submenu. In a menubar’s menu, moves to the next menu |
| Left | Closes a submenu. In a menubar’s menu, moves to the previous menu |
| Escape | Closes the innermost menu and returns focus to the item or button that opened it |
| Letters | Moves to the next item starting with the typed text |
| Typing | In a menu with search, filters the items and highlights the first match |
| Down / Up | In a menu with search, highlights the next or previous match, wrapping |
| Enter | In a menu with search, chooses the highlighted item |
| Tab | Moves through the controls in a menu with search and its footer, then leaves the menu. Closes every menu that focus leaves |
Right and Left are swapped in right-to-left pages.
Manual test checklist
- [ ] The list has the
menurole inactionsmode, and thelistboxrole insingle,multi, orsearchmenus, witharia-orientation="vertical".multilists havearia-multiselectable="true". The list is named bylabel, or by its button. - [ ] Items in
actionsmode have themenuitem,menuitemcheckbox, ormenuitemradiorole, and checkable items havearia-checked. Items insingle,multi, orsearchmenus have theoptionrole. Items insingleandmultimenus havearia-selected, and noaria-checked. - [ ] A menu with
searchor a footer is adialog, named bylabelor by its button. Its search field is asearchbox, andaria-activedescendantfollows the highlighted item. A menu withsearchin full screen hasaria-modal="true". - [ ] Dividers in listbox menus are hidden from screen readers, since listboxes can’t contain separators.
- [ ] Disabled items have
aria-disabled="true"and stay reachable with the arrow keys. - [ ] A button that opens a menu has
aria-haspopupmatching the popup:menu,listboxinsingleandmultimodes, ordialogwithsearchor a footer. Itsaria-expandedfollows the menu’s state. The button has noaria-controls. - [ ] Items that open submenus have
aria-haspopup="menu"and anaria-expandedthat follows the submenu’s state. - [ ] Opening a menu from the keyboard moves focus to its first item, and closing it from the keyboard returns focus to the button that opened it. With the mouse, focus doesn’t move.
- [ ] Opening a menu with
searchfocuses the search field. Opening asingleormultimenu from the keyboard focuses its selected option, or the first item if none is selected. - [ ] Clicking items with the mouse never leaves a focus highlight behind.
- [ ] Only one item in each menu is in the Tab order.
- [ ] Focused items show a visible focus ring when using the keyboard.
- [ ] Icons, checkmarks, and submenu arrows aren’t announced.
- [ ] In forced colors mode, the menu’s border, the focused item, and checkmarks are still visible.
Properties
for
| Description | Id of the element that opens the menu, in the same document or shadow root. Without it, the menu shows inline. |
|---|---|
| Attribute | for |
| Type | string |
| Default | undefined |
label
| Description | Accessible name for the menu. Defaults to the trigger’s name. |
|---|---|
| Attribute | label |
| Type | string |
| Default | undefined |
mode
| Description | - actions: A menu of commands. Items use their type to be checkable. - single: A listbox where one option is selected. Choosing an option selects it and closes the menu. - multi: A listbox where any number of options are selected. Choosing an option toggles it and keeps the menu open. |
|---|---|
| Attribute | mode |
| Type | "actions" | "multi" | "single" |
| Default | "actions" |
placement
| Description | Where the menu opens. Defaults to below the trigger, or beside the item for a submenu. It flips to the other side when there isn’t room. |
|---|---|
| Attribute | placement |
| Type | "bottom" | "bottom-end" | "bottom-start" | "left" | "left-end" | "left-start" | "right" | "right-end" | "right-start" | "top" | "top-end" | "top-start" |
| Default | undefined |
search
| Description | Shows a search field above the items that filters them by label. Typing highlights the first match, and Enter chooses it. On small touch screens the menu fills the screen. |
|---|---|
| Attribute | search |
| Type | boolean |
| Default | false |
searchLabel
| Description | The search field’s accessible name and placeholder |
|---|---|
| Attribute | search-label |
| Type | string |
| Default | "Search" |
showOn
| Description | - click: Opens when the trigger is clicked, or pressed with Enter, Space, or Down. - context-menu: Opens where the trigger is right-clicked, or with the context menu key or Shift+F10. |
|---|---|
| Attribute | show-on |
| Type | "click" | "context-menu" |
| Default | "click" |
Events
orbSearch
| Description | Emitted when the search text changes. The built-in filter hides items whose label doesn’t contain the text. Call preventDefault() to filter yourself, such as by setting hidden on items. |
|---|---|
| Type | CustomEvent<MenuSearchDetail> |
orbSelect
| Description | Emitted when an item is chosen, from this menu or a submenu. Checkbox and radio items have already toggled. Call preventDefault() to keep the menu open. |
|---|---|
| Type | CustomEvent<MenuSelectDetail> |
Methods
attachInput
| Description | Lets another element, such as a text input in a rich-text editor, drive the menu while focus stays in it. Up and Down highlight items, Enter chooses the highlighted one, and Escape closes the menu. Pass null to detach. |
|---|---|
| Signature | attachInput(el: HTMLElement | null) => Promise<void> |
| Parameters | el (HTMLElement) |
focusItem
| Description | Focuses the first or last item, or the selected option. In a menu with search, focuses the search field and highlights that item instead. |
|---|---|
| Signature | focusItem(which: "first" | "last") => Promise<void> |
| Parameters | which ("first" | "last") |
hide
| Description | Closes the menu and its submenus. |
|---|---|
| Signature | hide() => Promise<void> |
show
| Description | Opens the menu. Pass a pointer event, or anything with getBoundingClientRect, such as a Range, to open it there. Calling it again while open moves it to the new spot. |
|---|---|
| Signature | show(at?: Anchor) => Promise<void> |
| Parameters | at (Pick<MouseEvent, "clientX" | "clientY"> | { getBoundingClientRect(): DOMRect; contextElement?: Element; }) |
Slots
| Slot | Description |
|---|---|
orb-mi items, orb-dividers, and submenus |
|
"footer" |
Content below the items, such as a button |
"search-end" |
Controls at the end of the search field, such as a filter menu |
Shadow Parts
| Part | Description |
|---|---|
"close-button" |
The close button in the mobile bar |
"footer" |
The footer, shown when it has content |
"list" |
The scrolling items, which have the menu or listbox role |
"mobile-bar" |
The title and close button, shown when the menu fills the screen |
"search" |
The row with the search field |
"search-input" |
The search field |
CSS Custom Properties
| Name | Description |
|---|---|
--background |
Background of a menu that opens from a trigger |
--border |
Border of a menu that opens from a trigger |
--color |
Text color |