Button Roles

A value that describes the purpose of a button.

Button Roles - iOS Light Mode Preview

Platform Compatibility

iOS 15.0+ iPadOS 15.0+ macOS 12.0+ watchOS 8.0+ tvOS 15.0+ visionOS 1.0+

Tags

SwiftUI Code

Docs 
VStack {
  HStack {
    Button("Tap Me", role: .cancel, action: action)
      .buttonStyle(.plain)
    Button("Tap Me", role: .cancel, action: action)
      .buttonStyle(.borderless)
    Button("Tap Me", role: .cancel, action: action)
      .buttonStyle(.bordered)
    Button("Tap Me", role: .cancel, action: action)
      .buttonStyle(.borderedProminent)
  }
  HStack {
    Button("Tap Me", role: .destructive, action: action)
      .buttonStyle(.plain)
    Button("Tap Me", role: .destructive, action: action)
      .buttonStyle(.borderless)
    Button("Tap Me", role: .destructive, action: action)
      .buttonStyle(.bordered)
    Button("Tap Me", role: .destructive, action: action)
      .buttonStyle(.borderedProminent)
  }
}

Found an issue or have a suggestion?

Created: May 30, 2025Updated: May 30, 2025