BbDropdownButton

Icon to be added on the right of the text.

Displays the component as full width.

The extra width goes to the main button; the toggle keeps its own. Useful in a narrow column, not as a way to make the two halves match.

Disables the automatic loading state that tracks async actions (enabled by default). Only affects the main action button: the split toggle half still mirrors the dropdown's internal async-action loading state.

Opts the main button out of tracking its own async onClick; the toggle keeps reflecting menu-action state either way. Replaces v2 autoLoading with the polarity inverted, so a leftover :auto-loading="false" does nothing and nothing warns.

Disables the component

Freezes both halves at once. v2 disabledWhileLoading is gone: a busy half is always disabled now, which is what stops a second click racing the pending action.

Prevents rendering content before it's made visible.

The identifier of the component.

Array used to render each dropdown button. They can act as button, as a, or as router-link as they are based on the functionality provided by BbBaseButton. Pass a flat array for a single group, nest arrays for divider-separated groups, or pass {@link InternalGroup} objects for titled / selectable sections. An item may carry its own items to open a submenu. The shapes can be mixed.

BbDropdown’s item model, with one rule of its own: items[0] is promoted into the main button, so keep it a plain leaf item. A leading group or nested array contributes only its first leaf and loses its remaining rows, silently.

Triggers a loading indicator.

Drives the main button by hand, for work the component cannot see. It does not touch the toggle.

Space the floating container will maintain from the activator.

Minimum empty space to keep from the edge of the page

Position of the dropdown relative to the activator. Use 'cursor' to anchor at the mouse/touch coordinates. (No arrow is drawn either way — arrows are tooltip-only in v3.)

Resolved against the whole split control, not the toggle that opened the menu — so the default bottom centres the panel under the pair. trigger is not exposed: the toggle always opens on click.

Icon to be added on the left of the text.

Dresses the main button, because items[0]’s own icons are ignored. This is where the primary action’s glyph belongs.

Passthrough, object form: the same keys as the pt:* attributes without the prefix. See the pt:<part> row.

Replaces the chevron shown inside the right-side dropdown toggle button. A constrained alternative to a slot: only the toggle's icon changes, so the button keeps its semantics. Named for consistency with prepend:icon / append:icon.

Swaps the toggle’s chevron and nothing else — an overflow "…" for a dense row. Deliberately a prop rather than a slot: there is no activator slot, because the toggle is part of the contract.

Sets the size of the button. When the value is a string, it will be applied to all screen sizes. Otherwise, it will be applied to the screen size specified by the object.

Shared by both halves, and takes the responsive map form ({ sm: "sm", lg: "md" }). Setting it on items[0] does nothing.

How long the transition has to last in milliseconds. Menus use the fast transition rather than the medium one the other popovers default to.

Visual variant shared by both buttons of the split control.

Shared by both halves, from BbButton’s ladder — a name registered through buttonVariants works here too. Replaces v2 theme. The primary item’s own variant is ignored, so the pair can never disagree.

Width of the dropdown in pixels, percentage, or 'auto' to fit content.

A percentage resolves against the split control’s width, still floored at the menu’s 128px minimum. anchor is not exposed here because it is hard-wired to that control.

That group's title line (the group is passed as item, groupTitle is true).

The trailing region of that group's title line.

The content of every row of that group, and no other; a row's own #<key> still wins.

The trailing region of every row of that group; replaces their append:icon. The check takes its place on the selected row.

The leading region of every row of that group — e.g. an avatar per record, drawn from item.meta, while other rows keep their prepend:icon.

The leading region of that group's title line.

One row's content (text and description), by its key; in a fetched group, by its resolved itemValue.

One row's trailing region; replaces its append:icon and its submenu chevron. The check takes its place on the selected row.

One row's leading region; replaces its prepend:icon.

Companion content forwarded into the dropdown (e.g. <BbDropdownGroup>).

Content pinned to the bottom of the dropdown panel, outside the scroll area.

Content pinned to the top of the dropdown panel, outside the scroll area.

Forwarded into the inner dropdown unchanged, along with footer, the edge slots and per-key slots. A per-key slot for items[0] renders nothing — that item never becomes a menu row.

The trailing region of every menu row, replacing its append:icon; the submenu chevron and the check on a selected row take its place (BbDropdown's rules).

The leading region of every menu row, replacing its prepend:icon (BbDropdown's rules).

Replaces every menu row’s prepend:icon; per-group and per-key slots beat it, as on BbDropdown. items[0] never sees it — dress the main button with prepend:icon.

Replaces the default loading placeholder row shown in a pipeline group while its async items load. Rendered once per loading group. Forwarded to the underlying BbDropdown.

Replaces the default "no data" placeholder row shown in a pipeline group that resolved to no items. Rendered once per empty group. Forwarded to the underlying BbDropdown.