Actions

Menu

A list of actions that drops down from a label.

iOSSwiftUI MenuAndroidCompose DropdownMenuRenders in a Screen or an Island
iOSSwiftUI Menu
AndroidCompose DropdownMenu

Import

ts
import {Menu, type MenuAction} from '@hzblj/kara-ui'

Props

A text button that opens a list of actions: a SwiftUI Menu on iOS, a Material dropdown anchored to it on Android. A native atom — it renders inside <Screen> or <Island>.

PropTypeDescription
actions*MenuAction[]

The menu's actions, top to bottom.

label*string

The trigger's text. Android draws it in the accent colour, with a chevron.

actions*
MenuAction[]

The menu's actions, top to bottom.

label*
string

The trigger's text. Android draws it in the accent colour, with a chevron.

MenuAction

One action of a Menu, an ActionSheet, a ContextMenu or a FabMenu.

PropTypeDescription
label*string

The action's text. Rows are keyed by it, so keep labels unique within one list.

onPress*() => void

Called when the action is chosen; the menu closes by itself.

destructiveboolean

Draws the action in the destructive colour — the system's destructive role on iOS. FabMenu ignores it on Android.

iconIconName

One of the app's icons, before the label. ContextMenu and FabMenu show it on both platforms, Menu and ActionSheet on Android only.

label*
string

The action's text. Rows are keyed by it, so keep labels unique within one list.

onPress*
() => void

Called when the action is chosen; the menu closes by itself.

destructive
boolean

Draws the action in the destructive colour — the system's destructive role on iOS. FabMenu ignores it on Android.

icon
IconName

One of the app's icons, before the label. ContextMenu and FabMenu show it on both platforms, Menu and ActionSheet on Android only.

Platform notes

  • iOS does not draw an action’s icon in the menu; Android does.