Skip to main content
type ToolbarItemPlacement =
    // Semantic placements
    | "automatic"
    | "principal"
    | "navigation"
    | "primaryAction"
    | "secondaryAction"
    | "status"
    | "confirmationAction"
    | "cancellationAction"
    | "destructiveAction"
    // Positional placements
    | "bottomBar"
    | "topBarLeading"
    | "topBarTrailing"
    | "navigationBarLeading"
    | "navigationBarTrailing"
    | "bottomOrnament"
    | "keyboard"
    | "largeSubtitle"
    | "subtitle"
    | "title";
​
automatic
string
Automatically determines placement based on semantic role and platform conventions.
​
principal
string
The principal item, typically placed in the center of the toolbar.
​
navigation
string
Navigation-related items, usually in the leading area.
​
primaryAction
string
The primary action for the current context. Typically trailing edge.
​
secondaryAction
string
Secondary actions, placed in less prominent positions.
​
status
string
Status information displays.
​
confirmationAction
string
Confirmation actions like “Save” or “Done”. Typically trailing edge.
​
cancellationAction
string
Cancellation actions like “Cancel”. Typically leading edge.
​
destructiveAction
string
Destructive actions like “Delete”. Placed to prevent accidental activation.
​
bottomBar
string
Places the item in the bottom bar.
​
topBarLeading
string
The leading side of the top bar.
​
topBarTrailing
string
The trailing side of the top bar.
​
navigationBarLeading
string
The leading side of the navigation bar.
​
navigationBarTrailing
string
The trailing side of the navigation bar.
​
bottomOrnament
string
A bottom ornament, typically for visionOS.
​
keyboard
string
An accessory bar above the on-screen keyboard.
​
largeSubtitle
string
A large subtitle in the navigation bar.
​
subtitle
string
A subtitle in the navigation bar.
​
title
string
The title area of the navigation bar.