NEW BOOK! Swift Gems: 100+ tips to take your Swift code to the next level. Learn more ...NEW BOOK! Swift Gems:100+ advanced Swift tips. Lear more...
Quick Tip Icon
Quick Tip

Adjust List row separator insets

Starting from iOS 16 list row separators in SwiftUI are aligned by default to the leading text in the row, if text is present. It's different from the iOS 15 behavior, where the insets of the separator don't adjust to the content of the row.

Screenshots of list row separators in iOS 16 and iOS 15 showing that in iOS 16 the insets are aligned to the leading text

We also have some new SwiftUI APIs for customizing the insets of the separator.

Swift Gems by Natalia Panferova book coverSwift Gems by Natalia Panferova book cover

Check out our new book!

Swift Gems

100+ tips to take your Swift code to the next level

Swift Gems

100+ tips to take your Swift code to the next level

  • Advanced Swift techniques for experienced developers bypassing basic tutorials
  • Curated, actionable tips ready for immediate integration into any Swift project
  • Strategies to improve code quality, structure, and performance across all platforms
  • Practical Swift insights from years of development, applicable from iOS to server-side Swift

Using listRowSeparatorLeading horizontal alignment guide, we can align the leading end of the row separator with any other horizontal guide of a view.

List(events) { event in
    HStack {
        DateLabel(date: event.date)
        EventNameLabel(name: event.name)
            .alignmentGuide(
                .listRowSeparatorLeading
            ) { dimensions in
                dimensions[.leading]
            }
    }
}

If we need to adjust the trailing inset of the separator, we can use listRowSeparatorTrailing alignment guide.

List(events) { event in
    HStack {
        EventNameLabel(name: event.name)
        Spacer()
            .alignmentGuide(
                .listRowSeparatorTrailing
            ) { dimensions in
                dimensions[.trailing]
            }
        DateLabel(date: event.date)
    }
}