https://github.com/davidask/headlesstabview

TabView alternative, no tab bar included
https://github.com/davidask/headlesstabview

Last synced: 26 days ago
JSON representation

TabView alternative, no tab bar included

• Host: GitHub
• URL: https://github.com/davidask/headlesstabview
• Owner: davidask
• License: mit
• Created: 2022-08-23T20:32:13.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2022-09-02T07:17:07.000Z (about 3 years ago)
• Last Synced: 2025-09-29T18:47:36.547Z (about 1 month ago)
• Language: Swift
• Homepage:
• Size: 8.79 KB
• Stars: 2
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# HeadlessTabView

Minimal SwiftUI library providing a simple `TabView` alternative without the compulsory tab bar, or the subtle headaches of using conditional rendering.

## Overview

This project was sprung from the need to conditionally switch between views meeting the following criteria:

1. Preserve internal state of conditional views to enable "multitasking" within applications

2. Cleanly detach conditional views from the view hierarchy, triggering appearance notifications like `.onAppear` and `.onDisappear`

3. Allow for a custom (or hidden) method of switching tabs

| Solution                               | Persists state | Appearance notifications | No extras |

| -------------------------------------- | -------------- | ------------------------ | --------- |

| Use `TabView`                          | ✅             | ✅                       | ❌        |

| Use conditional rendering              | ❌             | ✅                       | ✅        |

| Use `ZStack` with `.opacity` modifiers | ✅             | ❌                       | ✅        |

| Use `HeadlessTabView`                  | ✅             | ✅                       | ✅        |

**In summary, this library allows you to create truly unique tab bar experiences without hacks or compromising performance.**

## Requirements

- iOS 13.0+

- tvOS 13.0+

## Usage

```swift

import HeadlessTabView

// Declare a `Hashable & CaseIterable` type

enum Selection: String, Hashable, CaseIterable {

    case first

    case second

}

struct Content: View {

    @State var selection: Selection = .first

    var body: some View {

        HeadlessTabView($selection) { selection in

          // NOTE: This @ViewBuilder block is returned in its

          // entirety, meaning that if each view needs e.g. a `NavigationView`,

          // it's workable to wrap the entire switch statement in one.

          switch(selection) {

              case .first:

                // First view

              case .second:

                // Second view

            }

        }

    }

}

```

## Contribute

Please feel welcome contributing to **HeadlessTabView**, check the `LICENSE` file for more info.

## Credits

David Ask