---
title: "Value Tab View | Explore SwiftUI"
description: "Creates a tab view that uses a builder to create and specify selection values for its tabs"
canonical_url: "https://exploreswiftui.com/library/tabview/value-tab-view"
meta:
  author: "Explore SwiftUI"
  "og:description": "Creates a tab view that uses a builder to create and specify selection values for its tabs"
  "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Value%2BTab%2BView%2Cdescription_Creates%2Ba%2Btab%2Bview%2Bthat%2Buses%2Ba%2Bbuilder%2Bto%2Bcreate%2Band%2Bspecify%2Bselection%2Bvalues%2Bfor%2Bits%2Btabs.%2Ccategory_TabView%2Cimage_~L2FwaS9pbWFnZXMvMTY1L3ZhcmlhbnRzLzYxNj92PTE3OTAwNzM0Nzg4NDImcj0yJnc9MTI4MCZxPTg1JmY9anBlZw%2CimageMode_crop%2CimagePosition_bottom%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiAwOyBib3JkZXItYm90dG9tOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbS1sZWZ0LXJhZGl1czogNzRweDs%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L3RhYnZpZXcvdmFsdWUtdGFiLXZpZXci%2Cs_hvRhI5mWmxIIWkHz.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "Value Tab View | Explore SwiftUI"
  "twitter:description": "Creates a tab view that uses a builder to create and specify selection values for its tabs"
  "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Value%2BTab%2BView%2Cdescription_Creates%2Ba%2Btab%2Bview%2Bthat%2Buses%2Ba%2Bbuilder%2Bto%2Bcreate%2Band%2Bspecify%2Bselection%2Bvalues%2Bfor%2Bits%2Btabs.%2Ccategory_TabView%2Cimage_~L2FwaS9pbWFnZXMvMTY1L3ZhcmlhbnRzLzYxNj92PTE3OTAwNzM0Nzg4NDImcj0yJnc9MTI4MCZxPTg1JmY9anBlZw%2CimageMode_crop%2CimagePosition_bottom%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiAwOyBib3JkZXItYm90dG9tOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbS1sZWZ0LXJhZGl1czogNzRweDs%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L3RhYnZpZXcvdmFsdWUtdGFiLXZpZXci%2Cs_hvRhI5mWmxIIWkHz.png"
  "twitter:title": "Value Tab View | Explore SwiftUI"
---

> Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt)

**Interactive previews**[ iPhone](https://exploreswiftui.com/iphone?element=165)

# **Value Tab View**

Creates a tab view that uses a builder to create and specify selection values for its tabs.

![Value Tab View - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/165/variants/616?v=1790073478842&r=2&w=800&q=80&f=webp)

### **Platform Compatibility**

iOS 18.0+ iPadOS 18.0+ macOS 15.0+ watchOS 11.0+ tvOS 18.0+ visionOS 2.0+

### **Tags**

### **SwiftUI Code**

[ Docs](<https://developer.apple.com/documentation/swiftui/tabview/init(selection:content:)>)

```
@State var selection = "1"

var body: some View {
    let displayedSelection = Text("Selected: \(selection)")

    TabView(selection: $selection) {
        Tab(value: "0") {
            displayedSelection
        }
        Tab("1", systemImage: "1.circle", value: "1") {
            displayedSelection
        }

        Tab("2", image: "cats24x24", value: "2") {
            displayedSelection
        }
        Tab(value: "3") {
            displayedSelection
        } label: {
            Label("3", systemImage: "3.circle")
        }
    }
}
```

### **Found an issue or have a suggestion?**

Created: April 11, 2026Updated: April 11, 2026

### **More TabView Components **

[**View all **](https://exploreswiftui.com/library/tabview)

![Collapse Sidebar Sections by Default - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/259/variants/2039?v=1792566366133&r=2&w=412&q=75&f=webp)

### **Collapse Sidebar Sections by Default**

Collapses the section in the sidebar by default.

![Default Tab Bar Placement - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/239/variants/2069?v=1792681374978&r=2&w=412&q=75&f=webp)

### **Default Tab Bar Placement**

Specifies the preferred placement for the tabs of a TabView in the sidebarAdaptable style on platforms where the tab bar cannot adapt between different representations, and only one representation can be shown. For example, on iOS, it can enforce the sidebar on large-screen devices like the Pro Max, and iPhone Duo. This modifier has no effect on iPadOS.

![Default Collapsed Tab Section - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/234/variants/341?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Default Collapsed Tab Section**

Sets the default expansion state for the section containing this tab to collapsed when displayed in the sidebar.

![Tab View Customization Behavior - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/166/variants/669?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Tab View Customization Behavior**

Configures the customization behavior of customizable tab view content.

![Tab View Customization - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/164/variants/671?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Tab View Customization**

Specifies the customizations to apply to the sidebar representation of the tab view.

![Tab View Side Bar Footer - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/168/variants/735?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Tab View Side Bar Footer**

Adds a custom footer to the sidebar of a tab view.

![Tab View Side Bar Bottom Bar - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/169/variants/707?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Tab View Side Bar Bottom Bar**

Adds a custom bottom bar to the sidebar of a tab view.

![Default Adaptable Tab Bar Placement - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/170/variants/673?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Default Adaptable Tab Bar Placement**

Specifies the default placement for the tabs in a tab view using the adaptable sidebar style.

### **Explore Other Components **

[**Browse all **](https://exploreswiftui.com/)

![UIKit Fill Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/11/variants/43?v=1790073478842&r=2&w=412&q=75&f=webp)

### **UIKit Fill Colors**

![LinearCapacityGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/43/variants/267?v=1790073478842&r=2&w=412&q=75&f=webp)

### **LinearCapacityGaugeStyle**

A gauge style that displays a bar that fills from leading to trailing edges as the gauge’s current value increases

![RenameButton - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/37/variants/213?v=1790073478842&r=2&w=412&q=75&f=webp)

### **RenameButton**

A button that triggers a standard rename action

![ToolbarItem Shared Background Visibility - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/92/variants/295?v=1794864606112&r=2&w=412&q=75&f=webp)

### **ToolbarItem Shared Background Visibility**

Controls the visibility of the glass background effect on items in the toolbar. In certain contexts, such as the navigation bar on iOS and the window toolbar on macOS, toolbar items will be given a glass background effect that is shared with other items in the same logical grouping

![NavigationLinkPickerStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/181/variants/560?v=1790073478842&r=2&w=412&q=75&f=webp)

### **NavigationLinkPickerStyle**

A picker style represented by a navigation link that presents the options by pushing a List-style picker view.

![Custom Slider Ticks - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/86/variants/375?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Custom Slider Ticks**

Creates a slider to select a value from a given range, subject to a step increment, which displays the provided labels and customizable ticks.

![Custom Value Label Picker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/176/variants/548?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Custom Value Label Picker**

Creates a picker that generates its label from a localized string key and accepts a custom current value label.

![Picker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/174/variants/609?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Picker**

Creates a pickers with title, image, systemImage, and custom label.

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://exploreswiftui.com/#website","@type":"WebSite","description":"A visual library for SwiftUI APIs, components, and modifiers","inLanguage":"en-US","name":"Explore SwiftUI","url":"https://exploreswiftui.com/","publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#webpage","@type":"WebPage","dateModified":"2026-04-11T13:00:49.058Z","datePublished":"2026-04-11T08:58:16.898Z","description":"Creates a tab view that uses a builder to create and specify selection values for its tabs","name":"Value Tab View","url":"https://exploreswiftui.com/library/tabview/value-tab-view","breadcrumb":{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"mainEntity":{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#article"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/tabview/value-tab-view"]}],"primaryImageOfPage":{"@id":"https://exploreswiftui.com/#logo"}},{"@id":"https://exploreswiftui.com/#identity","@type":"Organization","description":"A visual library for SwiftUI APIs, components, and modifiers","name":"Explore SwiftUI","url":"https://exploreswiftui.com","logo":{"@id":"https://exploreswiftui.com/#logo"},"sameAs":["https://x.com/Typ0genius","https://mastodon.social/@Typ0genius"]},{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#article","citation":"https://developer.apple.com/documentation/swiftui/tabview/init(selection:content:)","dateModified":"2026-04-11T13:00:49.058Z","datePublished":"2026-04-11T08:58:16.898Z","description":"Creates a tab view that uses a builder to create and specify selection values for its tabs","headline":"Value Tab View","inLanguage":"en-US","name":"Value Tab View","thumbnailUrl":"https://exploreswiftui.com/api/images/165/variants/616?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/tabview/value-tab-view","@type":["Article","TechArticle"],"about":{"@type":"Thing","name":"SwiftUI"},"author":{"@id":"https://exploreswiftui.com/#identity"},"hasPart":{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#source-code"},"image":{"@id":"https://exploreswiftui.com/#/schema/image/1"},"isPartOf":{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#webpage"},"mainEntityOfPage":{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#source-code","@type":"SoftwareSourceCode","codeSampleType":"full example","description":"Creates a tab view that uses a builder to create and specify selection values for its tabs","name":"Value Tab View SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"@State var selection = \"1\"\n\nvar body: some View {\n    let displayedSelection = Text(\"Selected: \\(selection)\")\n\n    TabView(selection: $selection) {\n        Tab(value: \"0\") {\n            displayedSelection\n        }\n        Tab(\"1\", systemImage: \"1.circle\", value: \"1\") {\n            displayedSelection\n        }\n\n        Tab(\"2\", image: \"cats24x24\", value: \"2\") {\n            displayedSelection\n        }\n        Tab(value: \"3\") {\n            displayedSelection\n        } label: {\n            Label(\"3\", systemImage: \"3.circle\")\n        }\n    }\n}","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"TabView"},{"@type":"Thing","name":"Value Tab View"}]},{"@id":"https://exploreswiftui.com/library/tabview/value-tab-view#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"TabView","item":"https://exploreswiftui.com/library/tabview","position":2},{"@type":"ListItem","name":"Value Tab View","item":"https://exploreswiftui.com/library/tabview/value-tab-view","position":3}]},{"@id":"https://exploreswiftui.com/#logo","@type":"ImageObject","caption":"Explore SwiftUI","contentUrl":"https://exploreswiftui.com/apple-touch-icon.png","inLanguage":"en","url":"https://exploreswiftui.com/apple-touch-icon.png"},{"@id":"https://exploreswiftui.com/#/schema/image/1","@type":"ImageObject","contentUrl":"https://exploreswiftui.com/api/images/165/variants/616?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/165/variants/616?v=1790073478842&r=2"}]}
```