Contents

visibilityPriority(_:)

Defines the visibility priority for a toolbar item.

Declaration

@MainActor @preconcurrency func visibilityPriority(_ priority: ToolbarItemVisibilityPriority) -> some ToolbarContent

Parameters

  • priority:

    The visibility priority for this toolbar item.

Discussion

When toolbar space is limited, items with a lower priority move into the overflow menu before items with a higher priority. The default is automatic.

For example, an important control can appear at the trailing edge of the toolbar, but still be shown as the window is made smaller:

struct RootView: View {
    var body: some View {
        ContentView()
            .toolbar {
                ToolbarItem {
                    SecondaryControl()
                }
                ToolbarItem {
                    PrimaryControl()
                }
                .visibilityPriority(.high)
            }
    }
}

See Also

Controlling item visibility