Action flyouts

AndroidKitActionFlyout is the shared anchored menu for standalone controls, toolbar and action-bar flyouts, header actions, cards, and navigation overflow. Place it in a Box with the control it should anchor to, inside AndroidKitTheme.

For touch-and-hold or right-click actions positioned at the pointer, use AndroidKitContextMenu, which shares this menu renderer.

var expanded by remember { mutableStateOf(false) }

Box {
    Button(onClick = { expanded = true }) {
        Text("More")
    }
    AndroidKitActionFlyout(
        expanded = expanded,
        onDismissRequest = { expanded = false },
    ) {
        item(label = "Edit", onClick = onEdit, icon = editIcon)
        item(label = "Share", onClick = onShare)
        separator()
        item(label = "Delete", onClick = onDelete, enabled = canDelete, destructive = true)
    }
}

Standard item entries request dismissal before invoking their action. Icons are optional, and disabled entries cannot invoke their action. Setting the flyout’s enabled to false closes it and requests dismissal if it was expanded. destructive = true uses the theme’s error color for the enabled label and icon; disabled entries retain Material’s disabled colors. This option also applies to toolbar flyout entries and AndroidKitAction header actions, including direct icon buttons. Hosts declare the action’s meaning; Kit owns its colors. The caller owns the expanded state; outside clicks and Back request dismissal through the popup’s default PopupProperties.

The content builder accepts only item, separator, and submenu declarations. It is not composable and does not expose ColumnScope or arbitrary UI slots. Resolve labels with stringResource and icons with composable resource loaders before entering the builder. Actions accept ImageVector or Painter icon data; Kit renders the icon, label, spacing, styling, and dismissal behavior. Content scrolls vertically within the shared flyout.

Use placement (Above or Below) and horizontalAlignment (Start or End) to choose the preferred anchor edge. The flyout respects RTL and falls back to another position when the preferred edge cannot fit within the window. It also accepts offset, scrollState, properties, and color-only colors. Container/item padding, shapes and typography are Kit-owned.

Submenus

The standalone content DSL supports nested menus:

submenu(label = "Share") {
    item(label = "Copy link", onClick = onCopyLink)
    submenu(label = "Export") {
        item(label = "Text", onClick = onExportText)
    }
}

Submenus inherit the parent surface colors, Kit padding and popup properties. They use Material’s end-relative positioning, including RTL and window-edge fallback. Back or an outside click dismisses the current submenu; selecting an action requests dismissal of every parent before invoking the action. Disabling or closing a parent closes its nested menus. The existing toolbar item DSL remains unchanged; submenu is available in the AndroidKitActionFlyoutScope content builder.

Migration from floating dropdown

The separate dropdown API has been removed. Consumers must update these names:

Replace custom Compose rows with item(...) declarations. Arbitrary children are no longer supported. Explicitly typed content lambdas now use the non-composable AndroidKitActionFlyoutScope.() -> Unit type. Use named arguments when migrating the old positional offset overload.

Toolbar and action-bar callers continue to use their existing flyout { ... } DSL. Their actions and separators now render through the same standalone flyout.

Appearance is configured through the supported color-only colors input. See themes.