<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 8.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/View/swipeActions(edge:allowsFullSwipe:content:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI4ViewPAAE12swipeActions4edge15allowsFullSwipe7contentQrAA14HorizontalEdgeO_Sbqd__yXEtAaBRd__lF"
  },
  "title" : "swipeActions(edge:allowsFullSwipe:content:)"
}
-->

# swipeActions(edge:allowsFullSwipe:content:)

Adds custom swipe actions to a row in a list.

```
nonisolated func swipeActions<T>(edge: HorizontalEdge = .trailing, allowsFullSwipe: Bool = true, @ContentBuilder content: () -> T) -> some View where T : View
```

## Parameters

`edge`

The edge of the view to associate the swipe actions with.
The default is [`HorizontalEdge.trailing`](/documentation/SwiftUI/HorizontalEdge/trailing).

`allowsFullSwipe`

A Boolean value that indicates whether a full swipe
automatically performs the first action. The default is `true`.

`content`

The content of the swipe actions.

## Discussion

Use this method to add swipe actions to a view that acts as a row in a
list. Indicate the [`HorizontalEdge`](/documentation/SwiftUI/HorizontalEdge) where the swipe action
originates, and define individual actions with [`Button`](/documentation/SwiftUI/Button) instances.
For example, if you have a list of messages,
you can add an action to toggle a message as unread
on a swipe from the leading edge,
and actions to delete or flag messages on a trailing edge swipe:

```
List {
    ForEach(store.messages) { message in
        MessageCell(message: message)
            .swipeActions(edge: .leading) {
                Button { store.toggleUnread(message) } label: {
                    if message.isUnread {
                        Label("Read", systemImage: "envelope.open")
                    } else {
                        Label("Unread", systemImage: "envelope.badge")
                    }
                }
            }
            .swipeActions(edge: .trailing) {
                Button(role: .destructive) {
                    store.delete(message)
                } label: {
                    Label("Delete", systemImage: "trash")
                }
                Button { store.flag(message) } label: {
                    Label("Flag", systemImage: "flag")
                }
            }
        }
    }
}
```

Actions appear in the order you list them, starting from the swipe’s
originating edge. In the example above, the Delete action appears
closest to the screen’s trailing edge:

![A screenshot of a list of messages, where one of the messages has been](images/com.apple.SwiftUI/View-swipeActions-1@2x.png)

For labels or images that appear in swipe actions, SwiftUI automatically
applies the [`fill`](/documentation/SwiftUI/SymbolVariants/fill-swift.type.property) symbol variant,
as shown above.

By default, the user can perform the first action for a given swipe
direction with a full swipe. For the example above, the user can perform
both the toggle unread and delete actions with full swipes.
You can opt out of this behavior for an edge by setting
the `allowsFullSwipe` parameter to `false`. For example, you can
disable the full swipe on the leading edge:

```
.swipeActions(edge: .leading, allowsFullSwipe: false) {
    Button { store.toggleUnread(message) } label: {
        if message.isUnread {
            Label("Read", systemImage: "envelope.open")
        } else {
            Label("Unread", systemImage: "envelope.badge")
        }
    }
}
```

When you set a role for a button using one of the values from the
[`ButtonRole`](/documentation/SwiftUI/ButtonRole) enumeration, SwiftUI styles the button according to
its role. In the example above, the delete action appears in
[`red`](/documentation/SwiftUI/ShapeStyle/red) because it has the [`destructive`](/documentation/SwiftUI/ButtonRole/destructive) role.
If you want to set a different color — for example, to match the
overall theme of your app’s UI — add the [`tint(_:)`](/documentation/SwiftUI/View/tint(_:))
modifier to the button:

```
MessageCell(message: message)
    .swipeActions(edge: .leading) {
        Button { store.toggleUnread(message) } label: {
            if message.isUnread {
                Label("Read", systemImage: "envelope.open")
            } else {
                Label("Unread", systemImage: "envelope.badge")
            }
        }
        .tint(.blue)
    }
    .swipeActions(edge: .trailing) {
        Button(role: .destructive) { store.delete(message) } label: {
            Label("Delete", systemImage: "trash")
        }
        Button { store.flag(message) } label: {
            Label("Flag", systemImage: "flag")
        }
        .tint(.orange)
    }
```

The modifications in the code above make the toggle unread action
[`blue`](/documentation/SwiftUI/ShapeStyle/blue) and the flag action [`orange`](/documentation/SwiftUI/ShapeStyle/orange):

![A screenshot of a row that the user swiped from the leading edge](images/com.apple.SwiftUI/View-swipeActions-2@2x.png)

When you add swipe actions, SwiftUI no longer synthesizes the Delete
actions that otherwise appear when using the
`ForEach/onDelete(perform:)` method on a [`ForEach`](/documentation/SwiftUI/ForEach) instance.
You become responsible for creating a Delete
action, if appropriate, among your swipe actions.

Actions accumulate for a given edge if you call the modifier multiple
times on the same list row view.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)