├── .github ├── FUNDING.yml └── workflows │ └── swift.yml ├── .gitignore ├── .swiftlint.yml ├── LICENSE.txt ├── Package.swift ├── README.md └── Sources └── Tabify ├── Enumerations └── Visibility.swift ├── Extensions ├── TabifyExtension.swift └── ViewExtension.swift ├── Models └── TabifyItem.swift ├── Modifiers └── ItemViewModifier.swift ├── Styles ├── BarStyle │ ├── BarStyle.swift │ ├── DefaultBarStyle.swift │ └── GenericBarStyle.swift └── ItemStyle │ ├── DefaultItemStyle.swift │ ├── GenericItemStyle.swift │ └── ItemStyle.swift ├── Tabify.swift └── Util ├── CustomPreferenceKey.swift └── SelectionManager.swift /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | # These are supported funding model platforms 2 | 3 | github: bgeisb 4 | custom: "https://www.buymeacoffee.com/bgeisb" 5 | -------------------------------------------------------------------------------- /.github/workflows/swift.yml: -------------------------------------------------------------------------------- 1 | # This workflow will build a Swift project 2 | # For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-swift 3 | 4 | name: Swift 5 | 6 | on: 7 | push: 8 | branches: [ "master" ] 9 | pull_request: 10 | branches: [ "master" ] 11 | 12 | jobs: 13 | 14 | SwiftLint: 15 | 16 | runs-on: ubuntu-latest 17 | 18 | steps: 19 | - uses: actions/checkout@v3 20 | 21 | - name: GitHub Action for SwiftLint 22 | uses: norio-nomura/action-swiftlint@3.2.1 23 | 24 | Build: 25 | 26 | runs-on: macOS-12 27 | 28 | steps: 29 | - uses: actions/checkout@v3 30 | 31 | - name: Build  iOS 32 | run: xcodebuild -scheme Tabify -destination 'generic/platform=iOS' 33 | 34 | - name: Build  macOS 35 | run: xcodebuild -scheme Tabify -destination 'generic/platform=macOS' 36 | 37 | - name: Build  mac Catalyst 38 | run: xcodebuild -scheme Tabify -destination 'generic/platform=macOS,variant=Mac Catalyst' 39 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store 2 | .swiftpm 3 | xcuserdata/ 4 | Package.resolved 5 | -------------------------------------------------------------------------------- /.swiftlint.yml: -------------------------------------------------------------------------------- 1 | disabled_rules: # rule identifiers to exclude from running 2 | - variable_name 3 | - nesting 4 | - function_parameter_count 5 | - trailing_whitespace 6 | opt_in_rules: # some rules are only opt-in 7 | - control_statement 8 | - empty_count 9 | - trailing_newline 10 | - colon 11 | - comma 12 | excluded: # paths to ignore during linting. Takes precedence over `included`. 13 | - Pods 14 | 15 | force_cast: warning # implicitly. Give warning only for force casting 16 | 17 | force_try: 18 | severity: warning # explicitly. Give warning only for force try 19 | 20 | type_body_length: 21 | - 300 # warning 22 | - 400 # error 23 | 24 | file_length: 25 | warning: 500 26 | error: 800 27 | 28 | large_tuple: # warn user when using 3 values in tuple, give error if there are 4 29 | - 3 30 | - 4 31 | 32 | # naming rules can set warnings/errors for min_length and max_length 33 | # additionally they can set excluded names 34 | type_name: 35 | min_length: 4 # only warning 36 | max_length: # warning and error 37 | warning: 30 38 | error: 35 39 | excluded: iPhone # excluded via string 40 | reporter: "xcode" 41 | -------------------------------------------------------------------------------- /LICENSE.txt: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2023 Benedikt Geisberger 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /Package.swift: -------------------------------------------------------------------------------- 1 | // swift-tools-version: 5.7 2 | // The swift-tools-version declares the minimum version of Swift required to build this package. 3 | 4 | import PackageDescription 5 | 6 | let package = Package( 7 | name: "Tabify", 8 | platforms: [ 9 | .iOS(.v13), 10 | .macOS(.v11) 11 | ], 12 | products: [ 13 | // Products define the executables and libraries a package produces, and make them visible to other packages. 14 | .library( 15 | name: "Tabify", 16 | targets: ["Tabify"]), 17 | ], 18 | targets: [ 19 | .target( 20 | name: "Tabify", 21 | dependencies: [] 22 | ), 23 | ] 24 | ) 25 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 11 | [![Contributors][contributors-shield]][contributors-url] 12 | [![Forks][forks-shield]][forks-url] 13 | [![Stargazers][stars-shield]][stars-url] 14 | [![Issues][issues-shield]][issues-url] 15 | [![MIT License][license-shield]][license-url] 16 | [![LinkedIn][linkedin-shield]][linkedin-url] 17 | 18 | 19 | 20 | ![tabify_banner](https://user-images.githubusercontent.com/36701166/211655185-1ac9fd7c-40f7-4cf4-9eba-07933b053b1b.png) 21 | 22 | 23 | 24 | ## Table of contents 25 | 26 | * [Description](#description) 27 | * [Requirements](#requirements) 28 | * [Installation](#installation) 29 | * [Swift Package Manager](#swift-package-manager) 30 | * [CocoaPods](#cocoapods) 31 | * [Usage](#usage) 32 | * [1. Create TabifyItems Enum](#1-create-tabifyitems-enum) 33 | * [2. Add Tabify View](#2-add-tabify-view) 34 | * [Contributing](#contributing) 35 | * [License](#license) 36 | 37 | 38 | 39 | ## Description 40 | `Tabify` is a SwiftUI view that elegantly utilizes interactive user interface elements to dynamically switch between multiple child views. 41 | It is highly customizable and, due to its similarity to the native `TabView` SwiftUI component, very user-friendly and easy to use. 42 | 43 | 44 | 45 | ## Requirements 46 | 47 | - SwiftUI 48 | - iOS 13.0 or above 49 | 50 |

(back to top)

51 | 52 | 53 | 54 | ## Installation 55 | 56 | ### Swift Package Manager 57 | 58 | The preferred way of installing `Tabify` is via the [Swift Package Manager](https://swift.org/package-manager/). 59 | 60 | 1. In Xcode, open your project and navigate to **File** → **Add Packages** 61 | 2. Paste the repository URL (`https://github.com/bgeisb/Tabify.git`) and click **Next**. 62 | 3. For **Rules**, select **Up to Next Major Version**. 63 | 4. Click **Add Package**. 64 | 65 | ### CocoaPods 66 | 67 | ⏳ Coming soon... 68 | 69 |

(back to top)

70 | 71 | 72 | ## Usage 73 | 74 | ### 1. Create TabifyItems Enum 75 | 76 | > Make sure your enum implements the `TabifyItem` protocol. 77 | 78 | ```swift 79 | enum TabifyItems: Int, TabifyItem { 80 | case home = 0 81 | case search 82 | case profile 83 | 84 | var icon: String { 85 | switch self { 86 | case .home: return "house" 87 | case .search: return "magnifyingglass" 88 | case .profile: return "person" 89 | } 90 | } 91 | 92 | var title: String { 93 | switch self { 94 | case .home: return "Home" 95 | case .search: return "Search" 96 | case .profile: return "Profile" 97 | } 98 | } 99 | } 100 | ``` 101 | 102 | ### 2. Add Tabify View 103 | 104 | ```swift 105 | Tabify(selectedItem: $tabBarSelection) { 106 | Text("Home") 107 | .tabItem(for: TabifyItems.first) 108 | 109 | Text("Search") 110 | .tabItem(for: TabifyItems.second) 111 | 112 | Text("Profile") 113 | .tabItem(for: TabifyItems.third) 114 | } 115 | /* This following modifiers are optional. You can use them to inject your custom bar and item styling. */ 116 | .barStyle(style: CustomTabifyBarStyle()) 117 | .itemStyle(style: CustomTabifyItemStyle()) 118 | ``` 119 | 120 |

(back to top)

121 | 122 | 123 | ## Contributing 124 | 125 | Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**. 126 | 127 | If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply [open an issue](https://github.com/bgeisb/Tabify/issues/new) with the tag "enhancement". 128 | Don't forget to give the project a star! Thanks again! 129 | 130 | 1. Fork the Project 131 | 2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) 132 | 3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) 133 | 4. Push to the Branch (`git push origin feature/AmazingFeature`) 134 | 5. Open a Pull Request 135 | 136 |

(back to top)

137 | 138 | 139 | 140 | ## License 141 | 142 | Distributed under the MIT License. See `LICENSE.txt` for more information. 143 | 144 |

(back to top)

145 | 146 | 147 | 148 | 149 | [contributors-shield]: https://img.shields.io/github/contributors/bgeisb/Tabify.svg?style=for-the-badge 150 | [contributors-url]: https://github.com/bgeisb/Tabify/graphs/contributors 151 | [forks-shield]: https://img.shields.io/github/forks/bgeisb/Tabify.svg?style=for-the-badge 152 | [forks-url]: https://github.com/bgeisb/Tabify/network/members 153 | [stars-shield]: https://img.shields.io/github/stars/bgeisb/Tabify.svg?style=for-the-badge 154 | [stars-url]: https://github.com/bgeisb/Tabify/stargazers 155 | [issues-shield]: https://img.shields.io/github/issues/bgeisb/Tabify.svg?style=for-the-badge 156 | [issues-url]: https://github.com/bgeisb/Tabify/issues 157 | [license-shield]: https://img.shields.io/github/license/bgeisb/Tabify.svg?style=for-the-badge 158 | [license-url]: https://github.com/bgeisb/Tabify/blob/master/LICENSE.txt 159 | [linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555 160 | [linkedin-url]: https://linkedin.com/in/bgeisberger 161 | [product-screenshot]: images/screenshot.png 162 | -------------------------------------------------------------------------------- /Sources/Tabify/Enumerations/Visibility.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Visibility.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import Foundation 9 | 10 | public enum Visibility: CaseIterable { 11 | case visible 12 | case invisible 13 | 14 | public mutating func toggle() { 15 | switch self { 16 | case .visible: 17 | self = .invisible 18 | case .invisible: 19 | self = .visible 20 | } 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /Sources/Tabify/Extensions/TabifyExtension.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Tabify.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | extension Tabify { 11 | public func itemStyle(style: ItemStyleType) -> Self { 12 | var _self = self 13 | _self.itemStyle = .init(itemStyle: style) 14 | return _self 15 | } 16 | 17 | public func barStyle(style: BarStyleType) -> Self { 18 | var _self = self 19 | _self.barStyle = .init(barStyle: style) 20 | return _self 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /Sources/Tabify/Extensions/ViewExtension.swift: -------------------------------------------------------------------------------- 1 | // 2 | // View.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | extension View { 11 | @ViewBuilder func visibility(_ visibility: Visibility) -> some View { 12 | switch visibility { 13 | case .visible: 14 | self.transition( 15 | .move(edge: .bottom) 16 | ) 17 | case .invisible: 18 | hidden().transition( 19 | .move(edge: .bottom) 20 | ) 21 | } 22 | } 23 | 24 | public func tabItem(for item: Item) -> some View { 25 | return self.modifier(ItemViewModifier(item: item)) 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /Sources/Tabify/Models/TabifyItem.swift: -------------------------------------------------------------------------------- 1 | // 2 | // TabifyItem.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import Foundation 9 | 10 | public protocol TabifyItem: Hashable { 11 | var title: String { get } 12 | var icon: String { get } 13 | } 14 | -------------------------------------------------------------------------------- /Sources/Tabify/Modifiers/ItemViewModifier.swift: -------------------------------------------------------------------------------- 1 | // 2 | // ItemViewModifier.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | struct ItemViewModifier: ViewModifier { 11 | @EnvironmentObject private var selectionObject: SelectionManager 12 | 13 | let item: Item 14 | 15 | func body(content: Content) -> some View { 16 | Group { 17 | if self.item == self.selectionObject.selection { 18 | content 19 | } else { 20 | Color.clear 21 | } 22 | } 23 | .preference(key: CustomPreferenceKey.self, value: [self.item]) 24 | } 25 | } 26 | -------------------------------------------------------------------------------- /Sources/Tabify/Styles/BarStyle/BarStyle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // BarStyle.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | import SwiftUI 11 | 12 | public protocol BarStyle { 13 | associatedtype Content: View 14 | 15 | func bar(with geometry: GeometryProxy, itemsContainer: @escaping () -> AnyView) -> Content 16 | } 17 | 18 | extension BarStyle { 19 | func genericBar(with geometry: GeometryProxy, itemsContainer: @escaping () -> AnyView) -> AnyView { 20 | return .init(self.bar(with: geometry, itemsContainer: itemsContainer)) 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /Sources/Tabify/Styles/BarStyle/DefaultBarStyle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // DefaultBarStyle.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | public struct DefaultBarStyle: BarStyle { 11 | 12 | public func bar(with geometry: GeometryProxy, itemsContainer: @escaping () -> AnyView) -> some View { 13 | VStack(spacing: 0.0) { 14 | Divider() 15 | 16 | VStack { 17 | itemsContainer() 18 | .frame(height: 50.0) 19 | .padding(.bottom, geometry.safeAreaInsets.bottom) 20 | } 21 | .background( 22 | Color( 23 | red: 249 / 255, 24 | green: 249 / 255, 25 | blue: 249 / 255, 26 | opacity: 0.94 27 | ) 28 | ) 29 | .frame(height: 50.0 + geometry.safeAreaInsets.bottom) 30 | } 31 | } 32 | 33 | } 34 | -------------------------------------------------------------------------------- /Sources/Tabify/Styles/BarStyle/GenericBarStyle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // GenericBarStyle.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | public struct GenericBarStyle: BarStyle { 11 | private let _erasedBar: (GeometryProxy, @escaping () -> AnyView) -> AnyView 12 | 13 | public init(barStyle: BarStyleType) { 14 | self._erasedBar = barStyle.genericBar 15 | } 16 | 17 | public func bar(with geometry: GeometryProxy, itemsContainer: @escaping () -> AnyView) -> some View { 18 | return self._erasedBar(geometry, itemsContainer) 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /Sources/Tabify/Styles/ItemStyle/DefaultItemStyle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // DefaultItemStyle.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | public struct DefaultItemStyle: ItemStyle { 11 | 12 | @ViewBuilder 13 | public func item(icon: String, title: String, isSelected: Bool) -> some View { 14 | let color: Color = isSelected ? .accentColor : .gray 15 | 16 | VStack(spacing: 5.0) { 17 | Image(systemName: icon) 18 | .renderingMode(.template) 19 | 20 | Text(title) 21 | .font(.system(size: 10.0, weight: .medium)) 22 | } 23 | .foregroundColor(color) 24 | } 25 | 26 | } 27 | -------------------------------------------------------------------------------- /Sources/Tabify/Styles/ItemStyle/GenericItemStyle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // GenericItemStyle.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | public struct GenericItemStyle: ItemStyle { 11 | private let _erasedItem: (String, String, Bool) -> AnyView 12 | 13 | public init(itemStyle: ItemStyleType) { 14 | self._erasedItem = itemStyle.genericItem(icon:title:isSelected:) 15 | } 16 | 17 | public func item(icon: String, title: String, isSelected: Bool) -> some View { 18 | return self._erasedItem(icon, title, isSelected) 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /Sources/Tabify/Styles/ItemStyle/ItemStyle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // ItemStyle.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | public protocol ItemStyle { 11 | associatedtype Content : View 12 | 13 | func item(icon: String, title: String, isSelected: Bool) -> Content 14 | } 15 | 16 | extension ItemStyle { 17 | func genericItem(icon: String, title: String, isSelected: Bool) -> AnyView { 18 | return .init(self.item(icon: icon, title: title, isSelected: isSelected)) 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /Sources/Tabify/Tabify.swift: -------------------------------------------------------------------------------- 1 | import SwiftUI 2 | 3 | public struct Tabify: View { 4 | 5 | @Binding private var visibility: Visibility 6 | 7 | @State private var items: [Item] 8 | 9 | private let content: Content 10 | private let selectedItem: SelectionManager 11 | 12 | var itemStyle: GenericItemStyle 13 | var barStyle: GenericBarStyle 14 | 15 | public init( 16 | selectedItem: Binding, 17 | visibility: Binding = .constant(.visible), 18 | @ViewBuilder content: () -> Content 19 | ) { 20 | self.itemStyle = .init(itemStyle: DefaultItemStyle()) 21 | self.barStyle = .init(barStyle: DefaultBarStyle()) 22 | 23 | self.selectedItem = .init(selection: selectedItem) 24 | self.content = content() 25 | 26 | self._items = .init(initialValue: .init()) 27 | self._visibility = visibility 28 | } 29 | 30 | private var tabItems: some View { 31 | HStack { 32 | ForEach(self.items, id: \.self) { item in 33 | self.itemStyle.item(icon: item.icon, title: item.title, isSelected: self.selectedItem.selection == item) 34 | .onTapGesture { [item] in 35 | self.selectedItem.selection = item 36 | self.selectedItem.objectWillChange.send() 37 | } 38 | } 39 | .frame(maxWidth: .infinity) 40 | } 41 | } 42 | 43 | public var body: some View { 44 | ZStack { 45 | self.content 46 | .frame(maxWidth: .infinity, maxHeight: .infinity) 47 | .environmentObject(self.selectedItem) 48 | 49 | GeometryReader { geometry in 50 | VStack { 51 | Spacer() 52 | 53 | self.barStyle.bar(with: geometry) { 54 | .init(self.tabItems) 55 | } 56 | } 57 | .edgesIgnoringSafeArea(.bottom) 58 | .visibility(self.visibility) 59 | } 60 | } 61 | .onPreferenceChange(CustomPreferenceKey.self) { value in 62 | self.items = value 63 | } 64 | } 65 | } 66 | -------------------------------------------------------------------------------- /Sources/Tabify/Util/CustomPreferenceKey.swift: -------------------------------------------------------------------------------- 1 | // 2 | // CustomPreferenceKey.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | struct CustomPreferenceKey: PreferenceKey { 11 | static var defaultValue: [Item] { 12 | return .init() 13 | } 14 | 15 | static func reduce(value: inout [Item], nextValue: () -> [Item]) { 16 | value.append(contentsOf: nextValue()) 17 | } 18 | } 19 | -------------------------------------------------------------------------------- /Sources/Tabify/Util/SelectionManager.swift: -------------------------------------------------------------------------------- 1 | // 2 | // SelectionManager.swift 3 | // 4 | // 5 | // Created by Benedikt Geisberger on 29.12.22. 6 | // 7 | 8 | import SwiftUI 9 | 10 | class SelectionManager: ObservableObject { 11 | @Binding var selection: Item 12 | 13 | init(selection: Binding) { 14 | self._selection = selection 15 | } 16 | } 17 | --------------------------------------------------------------------------------