---
title: ToggleStyle
framework: swiftui
role: symbol
role_heading: Protocol
path: swiftui/togglestyle
---

# ToggleStyle

The appearance and behavior of a toggle.

## Declaration

```swift
@MainActor @preconcurrency protocol ToggleStyle
```

## Overview

Overview To configure the style for a single Toggle or for all toggle instances in a view hierarchy, use the toggleStyle(_:) modifier. You can specify one of the built-in toggle styles, like switch or button: Toggle(isOn: $isFlagged) {     Label("Flag", systemImage: "flag.fill") } .toggleStyle(.button) Alternatively, you can create and apply a custom style. Custom styles To create a custom style, declare a type that conforms to the ToggleStyle protocol and implement the required makeBody(configuration:) method. For example, you can define a checklist toggle style: struct ChecklistToggleStyle: ToggleStyle {     func makeBody(configuration: Configuration) -> some View {         // Return a view that has checklist appearance and behavior.     } } Inside the method, use the configuration parameter, which is an instance of the ToggleStyleConfiguration structure, to get the label and a binding to the toggle state. To see examples of how to use these items to construct a view that has the appearance and behavior of a toggle, see makeBody(configuration:). To provide easy access to the new style, declare a corresponding static variable in an extension to ToggleStyle: extension ToggleStyle where Self == ChecklistToggleStyle {     static var checklist: ChecklistToggleStyle { .init() } } You can then use your custom style: Toggle(activity.name, isOn: $activity.isComplete)     .toggleStyle(.checklist) A type conforming to this protocol inherits @preconcurrency @MainActor isolation from the protocol if the conformance is included in the type’s base declaration: struct MyCustomType: Transition {     // `@preconcurrency @MainActor` isolation by default } Isolation to the main actor is the default, but it’s not required. Declare the conformance in an extension to opt out of main actor isolation: extension MyCustomType: Transition {     // `nonisolated` by default }

## Topics

### Getting built-in toggle styles

- [automatic](swiftui/togglestyle/automatic.md)
- [button](swiftui/togglestyle/button.md)
- [checkbox](swiftui/togglestyle/checkbox.md)
- [switch](swiftui/togglestyle/switch.md)

### Creating custom toggle styles

- [makeBody(configuration:)](swiftui/togglestyle/makebody(configuration:).md)
- [ToggleStyleConfiguration](swiftui/togglestyleconfiguration.md)
- [ToggleStyle.Configuration](swiftui/togglestyle/configuration.md)
- [Body](swiftui/togglestyle/body.md)

### Supporting types

- [DefaultToggleStyle](swiftui/defaulttogglestyle.md)
- [ButtonToggleStyle](swiftui/buttontogglestyle.md)
- [CheckboxToggleStyle](swiftui/checkboxtogglestyle.md)
- [SwitchToggleStyle](swiftui/switchtogglestyle.md)

## Relationships

### Conforming Types

- [ButtonToggleStyle](swiftui/buttontogglestyle.md)
- [CheckboxToggleStyle](swiftui/checkboxtogglestyle.md)
- [DefaultToggleStyle](swiftui/defaulttogglestyle.md)
- [SwitchToggleStyle](swiftui/switchtogglestyle.md)

## See Also

### Styling toggles

- [toggleStyle(_:)](swiftui/view/togglestyle(_:).md)
- [ToggleStyleConfiguration](swiftui/togglestyleconfiguration.md)