init(_:action:actionLabel:)

Creates a button template for a control.

Declaration

@MainActor @preconcurrency init(_ titleResource: LocalizedStringResource, action: Action, @ViewBuilder actionLabel: @escaping (Bool) -> ActionLabel) where Action : AppIntent

Parameters

titleResource:
The localized string resource to display as the title of the button.
action:
The action your button performs when pressed.
actionLabel:
A view that is rendered when the button’s action is performed.

Discussion

Use the action label to additionally customize the appearance of this control button while its action is performed

ControlWidgetButton(
    "Open Trunk",
    action: OpenTrunkIntent()
) { isActive in
    Image(systemName: "car.side.rear.open.crop")
    if isActive {
        Text("Opening...")
    }
}

The example above produces a control button that in control center will display “Open Trunk” as its title and the provided SF symbol. While the control is performing its action it will show the “Opening…” subtitle.