Skip to main content

How to create scrolling pages of content using tabViewStyle()

About 2 minSwiftSwiftUIArticle(s)bloghackingwithswift.comcrashcourseswiftswiftuixcodeappstore

How to create scrolling pages of content using tabViewStyle() 관련

SwiftUI by Example

Back to Home

How to create scrolling pages of content using tabViewStyle() | SwiftUI by Example

How to create scrolling pages of content using tabViewStyle()

Updated for Xcode 15

Updated in iOS 15

SwiftUI's TabView doubles up as the equivalent to a UIPageViewController, letting us swipe through multiple screens of content, with paging dots at the bottom to show users where they are.

To activate the page view style, attach the .tabViewStyle() modifier to your TabView, passing in .page.

For example, you could add this to your @main Swift file:

TabView {
    Text("First")
    Text("Second")
    Text("Third")
    Text("Fourth")
}
.tabViewStyle(.page)

Download this as an Xcode projectopen in new window

Important

If you're using Xcode 12 you need to use PageTabViewStyle() rather than .page.

When that runs on iOS, tvOS, and watchOS, you'll find you can swipe through a list of pages. On macOS .page is not supported.

Warning

The paging dots are white and translucent white, so if your view background is also white you won't see them.

To solve this, you can ask SwiftUI to place a background behind by placing extra modifier after tabViewStyle():

TabView {
    Text("First")
    Text("Second")
    Text("Third")
    Text("Fourth")
}
.tabViewStyle(.page)

Download this as an Xcode projectopen in new window

.indexViewStyle(.page(backgroundDisplayMode: .always))

Important

If you're using Xcode 12 you need to use PageIndexViewStyle(backgroundDisplayMode: .always) rather than .page(backgroundDisplayMode: .always).

You can control the way paging dots are shown by adding an extra parameter to the .page method. For example, if you never wanted the paging dots to be shown, you would use this:

TabView {
    Text("First")
    Text("Second")
    Text("Third")
    Text("Fourth")
}
.tabViewStyle(.page(indexDisplayMode: .never))

Download this as an Xcode projectopen in new window

Similar solutions…
How to enable vertical page scrolling | SwiftUI by Example

How to enable vertical page scrolling
How to add horizontal and vertical scrolling using ScrollView | SwiftUI by Example

How to add horizontal and vertical scrolling using ScrollView
How to render Markdown content in text | SwiftUI by Example

How to render Markdown content in text
How to mark content as a placeholder using redacted() | SwiftUI by Example

How to mark content as a placeholder using redacted()
How to mark content as private using privacySensitive() | SwiftUI by Example

How to mark content as private using privacySensitive()

이찬희 (MarkiiimarK)
Never Stop Learning.