ToolbarItemPlacement

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";

string

Automatically determines placement based on semantic role and platform conventions.

string

The principal item, typically placed in the center of the toolbar.

Navigation-related items, usually in the leading area.

string

The primary action for the current context. Typically trailing edge.

string

Secondary actions, placed in less prominent positions.

string

Status information displays.

string

Confirmation actions like “Save” or “Done”. Typically trailing edge.

string

Cancellation actions like “Cancel”. Typically leading edge.

string

Destructive actions like “Delete”. Placed to prevent accidental activation.

string

Places the item in the bottom bar.

string

The leading side of the top bar.

string

The trailing side of the top bar.

The leading side of the navigation bar.

The trailing side of the navigation bar.

string

A bottom ornament, typically for visionOS.

string

An accessory bar above the on-screen keyboard.

string

A large subtitle in the navigation bar.

string

A subtitle in the navigation bar.

string

The title area of the navigation bar.

Introduction

Authoring

Components

Components — iOS Extensions

Components — Web Extensions

Modifiers

Modifiers — iOS Extensions

Hooks and Globals

Styles

Types

ToolbarItemPlacement