components/dropdown
Navigation · 38 / 64

DropdownMenu

ui.widgets.DropdownMenu

A set of commands opened from a button.

BEHAVIOR CONTRACT

Item kinds, shortcuts, selection callbacks, positioning and dismissal are managed together.

RECORDED INTERACTION

The harness opens the File menu: New / Open / Save.

examples/storybook/stories.zig:2354
// ── DropdownMenu(同 Menu:trigger+popover)──
pub fn buildDropdownMenu(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
    const a = cx.allocator;
    const c = try col(cx, 8);
    try c.appendChild(a, try label(cx, "Click the trigger to open the dropdown"));
    const items = [_]W.DropdownItem{
        .{ .id = "new", .label_text = "New File" },
        .{ .id = "open", .label_text = "Open…" },
        .{ .id = "sep", .kind = .separator },
        .{ .id = "save", .label_text = "Save" },
    };
    const dm = try W.DropdownMenu(.{ .items = &items }).mount(scope, cx);
    try dm.trigger.appendChild(a, try W.Button(.{ .label = "File ▾", .variant = .secondary }).mount(scope, cx));
    dm.wrapper.meta.ownership.meta.test_id = "story.dropdown.trigger";
    try c.appendChild(a, dm.wrapper);
    return c;
}
View source on GitHubexamples/storybook/stories.zig:2354

The story's verbatim source from the Storybook (zenit 4c50245 2026-10-01). W is ui.widgets; col / row / label are small Storybook layout helpers.

zenit · Dual-licensedFree for open-source projects under GPL-3.0-only; closed-source or commercial products need a commercial license.Contact the author: zongyi.xzy#gmail.com (replace # with @)zenit 4c50245 2026-10-01