Interactive previews iPhone Duo

Axis Behavior

The bar axis behavior of the toolbar item.

Platform Compatibility

iOS 27.1+ iPadOS 27.1+

SwiftUI Code

 NavigationStack {
            Text("FooBar")
                .toolbar {
                    ToolbarItem {
                        Button(role: .confirm, action: action)
                    }
                    ToolbarItem {
                        Button(role: .cancel, action: action)
                    }
                    .axisBehavior(.horizontalOnly)
                    ToolbarItem {
                        Button("Foo", action: action)
                    }
                    ToolbarItem {
                        Button("Bar", action: action)
                    }
                    .axisBehavior(.verticalPreferred)
                }
}

Found an issue or have a suggestion?

Created: September 24, 2026Updated: September 28, 2026

More Toolbars Components

View all

modifier

Prefer Vertical Toolbar Items

A compression behavior that prioritizes keeping toolbar items visible over other elements, such as tabs. By default, tabs are prioritized.

modifier

Toolbar Item Visibility Priority

Defines the visibility priority for a toolbar item.

initializer

Toolbar Overflow Menu

The overflow menu of a toolbar. An overflow menu represents actions that are always placed in the toolbar’s overflow menu, regardless of the toolbar mode, platform, or customizability.

initializer

Pinned Toolbar Item Placement

A placement that pins the item to the trailing edge of the toolbar.

modifier

Remove Toolbar Item Margin

Configures whether the content margins are removed.

initializers

Title Toolbar Item Placement

Places content in the title area

modifier

ToolbarItem Shared Background Visibility

Controls the visibility of the glass background effect on items in the toolbar. In certain contexts, such as the navigation bar on iOS and the window toolbar on macOS, toolbar items will be given a glass background effect that is shared with other items in the same logical grouping