HeadlessTabView

master

TabView alternative, no tab bar included
davidask/HeadlessTabView

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

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

Description

  • Swift Tools 5.6.0
View More Packages from this Author

Dependencies

  • None
Last updated: Tue Dec 10 2024 10:14:43 GMT-1000 (Hawaii-Aleutian Standard Time)