customizationBehavior(_:)

Declaration

nonisolated func customizationBehavior(_ behavior: ToolbarCustomizationBehavior) -> some CustomizableToolbarContent

Parameters

• behavior:

  The customization behavior of the customizable toolbar content.

Discussion

Customizable toolbar items support different kinds of customization:

• A user can add an item that is not in the toolbar.

• A user can remove an item that is in the toolbar.

• A user can move an item within the toolbar.

Based on the customization behavior of the toolbar items, different edits will be supported.

Use this modifier to the customization behavior a user can perform on your toolbar items. In the following example, the customizable toolbar item supports all of the different kinds of toolbar customizations and starts in the toolbar.

ContentView()
    .toolbar(id: "main") {
        ToolbarItem(id: "new") {
            // new button here
        }
    }

You can create an item that can not be removed from the toolbar or moved within the toolbar by passing a value of disabled to this modifier.

ContentView()
    .toolbar(id: "main") {
        ToolbarItem(id: "new") {
            // new button here
        }
        .customizationBehavior(.disabled)
    }

You can create an item that can not be removed from the toolbar, but can be moved by passing a value of reorderable.

ContentView()
    .toolbar(id: "main") {
        ToolbarItem(id: "new") {
            // new button here
        }
        .customizationBehavior(.reorderable)
    }