├── Cartfile
├── Tabman.xcconfig
├── Docs
    ├── img
    │   ├── tm_logo.png
    │   ├── IMG_0159.jpg
    │   ├── IMG_0160.jpg
    │   ├── bar_styles.png
    │   ├── tm_header.png
    │   ├── autoinsetting.png
    │   ├── bar_breakdown.png
    │   ├── autoinsetting_constraints.png
    │   └── autoinsetting_constraints_detail.png
    ├── jazzy-theme
    │   ├── assets
    │   │   ├── img
    │   │   │   ├── gh.png
    │   │   │   ├── carat.png
    │   │   │   └── dash.png
    │   │   ├── js
    │   │   │   └── jazzy.js
    │   │   └── css
    │   │   │   └── highlight.css.scss
    │   └── templates
    │   │   ├── parameter.mustache
    │   │   ├── tasks.mustache
    │   │   ├── footer.mustache
    │   │   ├── nav.mustache
    │   │   ├── header.mustache
    │   │   ├── doc.mustache
    │   │   └── task.mustache
    ├── Example Projects.md
    ├── Sections
    │   ├── Indicator.md
    │   ├── Buttons.md
    │   ├── Layout.md
    │   ├── Bar.md
    │   ├── TMBadgeView.md
    │   └── TMHidingBar.md
    ├── Tabman 3 Migration Guide.md
    ├── Troubleshooting.md
    └── Adding a Bar.md
├── .artwork
    └── artwork.sketch
├── fastlane
    ├── Appfile
    └── Fastfile
├── Sources
    ├── iOS
    │   ├── Assets.xcassets
    │   │   ├── Contents.json
    │   │   ├── AppIcon.appiconset
    │   │   │   ├── Icon-20.png
    │   │   │   ├── Icon-29.png
    │   │   │   ├── Icon-40.png
    │   │   │   ├── Icon-76.png
    │   │   │   ├── Icon-1024.png
    │   │   │   ├── Icon-20@2x.png
    │   │   │   ├── Icon-20@3x.png
    │   │   │   ├── Icon-29@2x.png
    │   │   │   ├── Icon-29@3x.png
    │   │   │   ├── Icon-40@2x.png
    │   │   │   ├── Icon-40@3x.png
    │   │   │   ├── Icon-60@2x.png
    │   │   │   ├── Icon-60@3x.png
    │   │   │   ├── Icon-76@2x.png
    │   │   │   ├── Icon-83.5@2x.png
    │   │   │   └── Contents.json
    │   │   ├── bg_logo_launch.imageset
    │   │   │   ├── bg_logo_launch.png
    │   │   │   ├── bg_logo_launch@2x.png
    │   │   │   ├── bg_logo_launch@3x.png
    │   │   │   └── Contents.json
    │   │   └── AccentColor.colorset
    │   │   │   └── Contents.json
    │   ├── AppDelegate.swift
    │   ├── Extras
    │   │   ├── UIColor+Tabman.swift
    │   │   └── GradientBackgroundViewController.swift
    │   ├── ChildViewController.swift
    │   ├── Info.plist
    │   ├── ButtonBarExampleViewController.swift
    │   ├── TabItemBarExampleViewController.swift
    │   └── Base.lproj
    │   │   └── LaunchScreen.storyboard
    ├── Examples.xcodeproj
    │   ├── project.xcworkspace
    │   │   ├── contents.xcworkspacedata
    │   │   └── xcshareddata
    │   │   │   └── IDEWorkspaceChecks.plist
    │   └── xcshareddata
    │   │   └── xcschemes
    │   │       └── Example iOS.xcscheme
    ├── Tabman.xcodeproj
    │   ├── project.xcworkspace
    │   │   ├── contents.xcworkspacedata
    │   │   └── xcshareddata
    │   │   │   └── IDEWorkspaceChecks.plist
    │   └── xcshareddata
    │   │   └── xcschemes
    │   │       └── Tabman.xcscheme
    ├── .swiftlint.yml
    ├── Tabman
    │   ├── PrivacyInfo.xcprivacy
    │   ├── Bar
    │   │   ├── Utility
    │   │   │   ├── WeakContainer.swift
    │   │   │   └── BarMath.swift
    │   │   ├── BarButton
    │   │   │   ├── TMBarButtonController.swift
    │   │   │   ├── Types
    │   │   │   │   └── TMBarButton+None.swift
    │   │   │   ├── TMBarButtonInteractionController.swift
    │   │   │   ├── TMBarButtonStateController.swift
    │   │   │   └── TMBarButtonCollection.swift
    │   │   ├── Extensions
    │   │   │   ├── CGRect+Interpolation.swift
    │   │   │   └── UIColor+Interpolation.swift
    │   │   ├── BarLayout
    │   │   │   ├── TMBarLayoutInsetGuides.swift
    │   │   │   ├── TMBarLayoutParent.swift
    │   │   │   └── Types
    │   │   │   │   ├── TMBarLayout+None.swift
    │   │   │   │   ├── TMConstrainedHorizontalBarLayout.swift
    │   │   │   │   └── TMHorizontalBarLayout+Separator.swift
    │   │   ├── TMAnimation.swift
    │   │   ├── BarItem
    │   │   │   ├── UIKit+TMBarItemable.swift
    │   │   │   └── TMBarItem.swift
    │   │   ├── BarView
    │   │   │   ├── TMBarViewFocusProvider.swift
    │   │   │   ├── TMBarViewScrollHandler.swift
    │   │   │   ├── TMBarViewLayoutGrid.swift
    │   │   │   ├── TMBarViewContentInsetGuides.swift
    │   │   │   └── TMBarViewFocusRect.swift
    │   │   ├── TMTransition.swift
    │   │   ├── BarIndicator
    │   │   │   ├── TMBarIndicatorLayoutHandler.swift
    │   │   │   ├── Types
    │   │   │   │   ├── TMBarIndicator+None.swift
    │   │   │   │   ├── TMBlockBarIndicator.swift
    │   │   │   │   ├── TMLineBarIndicator.swift
    │   │   │   │   ├── TMDotBarIndicator.swift
    │   │   │   │   └── TMChevronBarIndicator.swift
    │   │   │   ├── TMBarIndicatorContainer.swift
    │   │   │   └── TMBarIndicator.swift
    │   │   ├── TMBar+Templates.swift
    │   │   ├── Generic
    │   │   │   ├── ViewTitleViewContainer.swift
    │   │   │   ├── EdgeFadedView.swift
    │   │   │   ├── GestureScrollView.swift
    │   │   │   └── AnimateableLabel.swift
    │   │   ├── BarExtensions
    │   │   │   └── AutoHidingBar
    │   │   │   │   └── TMHidingBar+Triggers.swift
    │   │   ├── BarBackgroundView
    │   │   │   └── TMBarBackgroundView.swift
    │   │   └── TMBar.swift
    │   ├── Tabman.h
    │   ├── AutoInsetter
    │   │   ├── InsetStore
    │   │   │   ├── InsetStore.swift
    │   │   │   └── DefaultInsetStore.swift
    │   │   ├── AutoInsetSpec.swift
    │   │   ├── InsetCalculator
    │   │   │   ├── InsetCalculations.swift
    │   │   │   ├── InsetCalculator.swift
    │   │   │   └── ScrollViewInsetCalculator.swift
    │   │   ├── InsetExecutor
    │   │   │   └── InsetExecutor.swift
    │   │   ├── Utilities
    │   │   │   └── UIViewController+ScrollViewDetection.swift
    │   │   └── AutoInsetter.swift
    │   ├── Extensions
    │   │   ├── PageboyViewController+RelativeCurrentPosition.swift
    │   │   ├── PageboyNavigationDirection+Tabman.swift
    │   │   ├── UIViewController+Tabman.swift
    │   │   └── UIView+LayoutGuide.swift
    │   ├── Info.plist
    │   └── TabmanViewController+Insets.swift
    └── TabmanTests
    │   ├── Bar
    │       ├── MockBarDataSource.swift
    │       └── MockBarView.swift
    │   ├── Info.plist
    │   ├── MockTabmanViewController.swift
    │   └── TabmanViewControllerTests.swift
├── Gemfile
├── .swiftpm
    └── xcode
    │   └── package.xcworkspace
    │       └── contents.xcworkspacedata
├── Tabman.xcworkspace
    ├── xcshareddata
    │   ├── IDEWorkspaceChecks.plist
    │   ├── WorkspaceSettings.xcsettings
    │   ├── swiftpm
    │   │   └── Package.resolved
    │   └── Tabman.xcscmblueprint
    └── contents.xcworkspacedata
├── Package.resolved
├── .scripts
    ├── doc-processor
    ├── generate-docs
    └── update-gh-pages
├── .github
    ├── ISSUE_TEMPLATE.md
    ├── workflows
    │   ├── docs.yml
    │   ├── build.yml
    │   └── publish.yml
    └── FUNDING.yml
├── Dangerfile
├── Tabman.podspec
├── Package.swift
├── LICENSE
├── .gitignore
├── .jazzy.yaml
├── CONTRIBUTING.md
└── CODE_OF_CONDUCT.md


/Cartfile:
--------------------------------------------------------------------------------
1 | github "uias/Pageboy" ~> 4.2.0


--------------------------------------------------------------------------------
/Tabman.xcconfig:
--------------------------------------------------------------------------------
1 | TM_VERSION=3.2.0
2 | TM_IOS_DEPLOYMENT_TARGET=12.0
3 | 


--------------------------------------------------------------------------------
/Docs/img/tm_logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/tm_logo.png


--------------------------------------------------------------------------------
/.artwork/artwork.sketch:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/.artwork/artwork.sketch


--------------------------------------------------------------------------------
/Docs/img/IMG_0159.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/IMG_0159.jpg


--------------------------------------------------------------------------------
/Docs/img/IMG_0160.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/IMG_0160.jpg


--------------------------------------------------------------------------------
/Docs/img/bar_styles.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/bar_styles.png


--------------------------------------------------------------------------------
/Docs/img/tm_header.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/tm_header.png


--------------------------------------------------------------------------------
/fastlane/Appfile:
--------------------------------------------------------------------------------
1 | app_identifier "com.uias.tabman" # The bundle identifier of your app
2 | 


--------------------------------------------------------------------------------
/Docs/img/autoinsetting.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/autoinsetting.png


--------------------------------------------------------------------------------
/Docs/img/bar_breakdown.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/bar_breakdown.png


--------------------------------------------------------------------------------
/Docs/jazzy-theme/assets/img/gh.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/jazzy-theme/assets/img/gh.png


--------------------------------------------------------------------------------
/Docs/img/autoinsetting_constraints.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/autoinsetting_constraints.png


--------------------------------------------------------------------------------
/Docs/jazzy-theme/assets/img/carat.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/jazzy-theme/assets/img/carat.png


--------------------------------------------------------------------------------
/Docs/jazzy-theme/assets/img/dash.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/jazzy-theme/assets/img/dash.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/Contents.json:
--------------------------------------------------------------------------------
1 | {
2 |   "info" : {
3 |     "author" : "xcode",
4 |     "version" : 1
5 |   }
6 | }
7 | 


--------------------------------------------------------------------------------
/Docs/Example Projects.md:
--------------------------------------------------------------------------------
1 | # Example Projects
2 | 
3 | - [Tinderbar](https://github.com/uias/Tinderbar) - Tinder hooks up with Tabman.
4 | 


--------------------------------------------------------------------------------
/Docs/img/autoinsetting_constraints_detail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Docs/img/autoinsetting_constraints_detail.png


--------------------------------------------------------------------------------
/Gemfile:
--------------------------------------------------------------------------------
1 | 
2 | source 'https://rubygems.org'
3 | 
4 | gem 'fastlane'
5 | gem 'cocoapods'
6 | gem 'danger'
7 | gem 'danger-swiftlint'
8 | gem 'jazzy'


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-20.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-20.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-29.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-29.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-40.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-40.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-76.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-76.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-1024.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-1024.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-20@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-20@2x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-20@3x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-20@3x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-29@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-29@2x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-29@3x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-29@3x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-40@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-40@2x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-40@3x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-40@3x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-60@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-60@2x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-60@3x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-60@3x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-76@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-76@2x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-83.5@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Icon-83.5@2x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/bg_logo_launch.imageset/bg_logo_launch.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/bg_logo_launch.imageset/bg_logo_launch.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/bg_logo_launch.imageset/bg_logo_launch@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/bg_logo_launch.imageset/bg_logo_launch@2x.png


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/bg_logo_launch.imageset/bg_logo_launch@3x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/uias/Tabman/HEAD/Sources/iOS/Assets.xcassets/bg_logo_launch.imageset/bg_logo_launch@3x.png


--------------------------------------------------------------------------------
/.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <Workspace
3 |    version = "1.0">
4 |    <FileRef
5 |       location = "self:">
6 |    </FileRef>
7 | </Workspace>
8 | 


--------------------------------------------------------------------------------
/Docs/jazzy-theme/templates/parameter.mustache:
--------------------------------------------------------------------------------
 1 | <tr>
 2 |   <td>
 3 |     <code>
 4 |     <em>{{name}}</em>
 5 |     </code>
 6 |   </td>
 7 |   <td>
 8 |     <div>
 9 |       {{{discussion}}}
10 |     </div>
11 |   </td>
12 | </tr>
13 | 


--------------------------------------------------------------------------------
/Sources/Examples.xcodeproj/project.xcworkspace/contents.xcworkspacedata:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <Workspace
3 |    version = "1.0">
4 |    <FileRef
5 |       location = "self:">
6 |    </FileRef>
7 | </Workspace>
8 | 


--------------------------------------------------------------------------------
/Docs/jazzy-theme/templates/tasks.mustache:
--------------------------------------------------------------------------------
 1 | {{#tasks.count}}
 2 | <section class='section'>
 3 |   <div class='section-content'>
 4 |     {{#tasks}}
 5 |     {{> task}}
 6 |     {{/tasks}}
 7 |   </div>
 8 | </section>
 9 | {{/tasks.count}}
10 | 


--------------------------------------------------------------------------------
/Sources/Tabman.xcodeproj/project.xcworkspace/contents.xcworkspacedata:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <Workspace
3 |    version = "1.0">
4 |    <FileRef
5 |       location = "self:Tabman.xcodeproj">
6 |    </FileRef>
7 | </Workspace>
8 | 


--------------------------------------------------------------------------------
/Tabman.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3 | <plist version="1.0">
4 | <dict>
5 | 	<key>IDEDidComputeMac32BitWarning</key>
6 | 	<true/>
7 | </dict>
8 | </plist>
9 | 


--------------------------------------------------------------------------------
/Docs/Sections/Indicator.md:
--------------------------------------------------------------------------------
1 | The `TMBarIndicator` indicator is purely responsible for displaying the current paging state, complementing the state displayed in the bar buttons.
2 | 
3 | `TMBarIndicator` also dictates where it needs to be displayed in the bar, via `displayMode` - a property that must be provided by any `TMBarIndicator` subclass.


--------------------------------------------------------------------------------
/Sources/Tabman.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3 | <plist version="1.0">
4 | <dict>
5 | 	<key>IDEDidComputeMac32BitWarning</key>
6 | 	<true/>
7 | </dict>
8 | </plist>
9 | 


--------------------------------------------------------------------------------
/Sources/Examples.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3 | <plist version="1.0">
4 | <dict>
5 | 	<key>IDEDidComputeMac32BitWarning</key>
6 | 	<true/>
7 | </dict>
8 | </plist>
9 | 


--------------------------------------------------------------------------------
/Tabman.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3 | <plist version="1.0">
4 | <dict>
5 | 	<key>IDEWorkspaceSharedSettings_AutocreateContextsIfNeeded</key>
6 | 	<true/>
7 | </dict>
8 | </plist>
9 | 


--------------------------------------------------------------------------------
/Package.resolved:
--------------------------------------------------------------------------------
 1 | {
 2 |   "pins" : [
 3 |     {
 4 |       "identity" : "pageboy",
 5 |       "kind" : "remoteSourceControl",
 6 |       "location" : "https://github.com/uias/Pageboy",
 7 |       "state" : {
 8 |         "revision" : "be0c1f6f1964cfb07f9d819b0863f2c3f255f612",
 9 |         "version" : "4.2.0"
10 |       }
11 |     }
12 |   ],
13 |   "version" : 2
14 | }
15 | 


--------------------------------------------------------------------------------
/Tabman.xcworkspace/contents.xcworkspacedata:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <Workspace
 3 |    version = "1.0">
 4 |    <FileRef
 5 |       location = "group:Sources/../Tabman.xcconfig">
 6 |    </FileRef>
 7 |    <FileRef
 8 |       location = "group:Sources/Examples.xcodeproj">
 9 |    </FileRef>
10 |    <FileRef
11 |       location = "group:Sources/Tabman.xcodeproj">
12 |    </FileRef>
13 | </Workspace>
14 | 


--------------------------------------------------------------------------------
/Docs/jazzy-theme/templates/footer.mustache:
--------------------------------------------------------------------------------
1 | <section class='footer'>
2 |   <p>© 2018 <a class="link" href="https://github.com/uias" target="_blank" rel="external">UI At Six</a>. All rights reserved.</p>
3 |   <p>Generated by <a class='link' href='https://github.com/realm/jazzy' target='_blank' rel='external'>jazzy ♪♫ v{{jazzy_version}}</a>, a <a class='link' href='http://realm.io' target='_blank' rel='external'>Realm</a> project.</p>
4 | </section>
5 | 


--------------------------------------------------------------------------------
/Docs/Sections/Buttons.md:
--------------------------------------------------------------------------------
1 | Buttons in a `TMBarView` are a provided in the form of a `TMBarButton` collection. The buttons have the primary responsibility of displaying paging, user interaction and visually providing the current paging state (if appropriate).
2 | 
3 | Interaction with the `TMBarButton` collection of a `TMBarView` is provided via `TMBarButtonCollection`. This collection provides raw access to all displayed bar buttons, as well as utilities for customization.


--------------------------------------------------------------------------------
/.scripts/doc-processor:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env ruby
 2 | 
 3 | def replaceOccurences(source, value, replacement)
 4 |     result = source.gsub value, replacement
 5 |     result
 6 | end
 7 | 
 8 | file_in = ARGV[0]
 9 | file_out = ARGV[1]
10 | 
11 | input = IO.read(file_in)
12 | 
13 | result = input
14 | 
15 | # Sanitize any image refs
16 | result = replaceOccurences(result, "Docs/img", "img")
17 | 
18 | # Finalize
19 | IO.write(file_out, result)
20 | puts("[Processed]: #{file_out}")


--------------------------------------------------------------------------------
/Sources/.swiftlint.yml:
--------------------------------------------------------------------------------
 1 | disabled_rules:
 2 | - trailing_whitespace
 3 | - vertical_whitespace
 4 | - line_length
 5 | - opening_brace
 6 | - large_tuple
 7 | 
 8 | opt_in_rules:
 9 | - closure_spacing
10 | - conditional_returns_on_newline
11 | #- empty_count
12 | - explicit_init
13 | #- force_unwrapping // THIS SHOULD BE USED
14 | #- missing_docs
15 | - overridden_super_call
16 | - private_outlet
17 | #- switch_case_on_newline
18 | 
19 | excluded:
20 | - Pods
21 | - Tests
22 | 


--------------------------------------------------------------------------------
/Sources/Tabman/PrivacyInfo.xcprivacy:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 3 | <plist version="1.0">
 4 | <dict>
 5 | 	<key>NSPrivacyTracking</key>
 6 | 	<false/>
 7 | 	<key>NSPrivacyAccessedAPITypes</key>
 8 | 	<array/>
 9 | 	<key>NSPrivacyCollectedDataTypes</key>
10 | 	<array/>
11 | 	<key>NSPrivacyTrackingDomains</key>
12 | 	<array/>
13 | </dict>
14 | </plist>
15 | 


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AccentColor.colorset/Contents.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "colors" : [
 3 |     {
 4 |       "color" : {
 5 |         "color-space" : "srgb",
 6 |         "components" : {
 7 |           "alpha" : "1.000",
 8 |           "blue" : "0.886",
 9 |           "green" : "0.176",
10 |           "red" : "0.557"
11 |         }
12 |       },
13 |       "idiom" : "universal"
14 |     }
15 |   ],
16 |   "info" : {
17 |     "author" : "xcode",
18 |     "version" : 1
19 |   }
20 | }
21 | 


--------------------------------------------------------------------------------
/Tabman.xcworkspace/xcshareddata/swiftpm/Package.resolved:
--------------------------------------------------------------------------------
 1 | {
 2 |   "originHash" : "a758ccf717fdfdb86f09136097e776d790bde8518689cbfe41619ea2215ecb20",
 3 |   "pins" : [
 4 |     {
 5 |       "identity" : "pageboy",
 6 |       "kind" : "remoteSourceControl",
 7 |       "location" : "https://github.com/uias/Pageboy",
 8 |       "state" : {
 9 |         "revision" : "be0c1f6f1964cfb07f9d819b0863f2c3f255f612",
10 |         "version" : "4.2.0"
11 |       }
12 |     }
13 |   ],
14 |   "version" : 3
15 | }
16 | 


--------------------------------------------------------------------------------
/Sources/TabmanTests/Bar/MockBarDataSource.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  MockBarDataSource.swift
 3 | //  TabmanTests
 4 | //
 5 | //  Created by Merrick Sapsford on 01/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Foundation
10 | import UIKit
11 | import Tabman
12 | 
13 | class MockBarDataSource: TMBarDataSource {
14 |     
15 |     func barItem(for bar: TMBar, at index: Int) -> TMBarItemable {
16 |         return TMBarItem(title: "Mock Page \(index)")
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/Utility/WeakContainer.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  WeakContainer.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 03/07/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Foundation
10 | 
11 | internal class WeakContainer<T: AnyObject> {
12 |     
13 |     // MARK: Properties
14 |     
15 |     private(set) weak var object: T?
16 |     
17 |     // MARK: Init
18 |     
19 |     init(for object: T) {
20 |         self.object = object
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/Docs/Sections/Layout.md:
--------------------------------------------------------------------------------
1 | The layout in a `TMBarView` is probably the most crucial part of the puzzle, it defines the overall look and feel of a bar.
2 | 
3 | `TMBarLayout` is responsible for inserting, removing and positioning `TMBarButton`s in the view hierarchy. It is also tasked with interpreting a raw page position and providing a frame for 'focus' - the frame in which the bar should indicate current page status.
4 | 
5 | You are expected to use a `TMBarLayout` subclass such as `TMBarHorizontalLayout` or roll with your own for a completely custom look.


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE.md:
--------------------------------------------------------------------------------
 1 | ### New Issue Checklist
 2 | 
 3 | - [ ] Updated Tabman to the latest version
 4 | - [ ] I took a look at the [Troubleshooting Guide](https://github.com/uias/Tabman/blob/main/Docs/Troubleshooting.md)
 5 | - [ ] I searched for [existing GitHub issues](https://github.com/uias/Tabman/issues)
 6 | 
 7 | ### Issue Description
 8 | 
 9 | <!--- Please enter as much detail as possible about the issue you are having -->
10 | 
11 | ### Other useful things
12 | 
13 | <!--- Images, stack traces or any other things that you think would be useful! -->
14 | 


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/bg_logo_launch.imageset/Contents.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "images" : [
 3 |     {
 4 |       "filename" : "bg_logo_launch.png",
 5 |       "idiom" : "universal",
 6 |       "scale" : "1x"
 7 |     },
 8 |     {
 9 |       "filename" : "bg_logo_launch@2x.png",
10 |       "idiom" : "universal",
11 |       "scale" : "2x"
12 |     },
13 |     {
14 |       "filename" : "bg_logo_launch@3x.png",
15 |       "idiom" : "universal",
16 |       "scale" : "3x"
17 |     }
18 |   ],
19 |   "info" : {
20 |     "author" : "xcode",
21 |     "version" : 1
22 |   }
23 | }
24 | 


--------------------------------------------------------------------------------
/Docs/jazzy-theme/templates/nav.mustache:
--------------------------------------------------------------------------------
 1 | <nav class='navigation'>
 2 |   <ul class='nav-groups'>
 3 |     {{#structure}}
 4 |     <li class='nav-group-name'>
 5 |       <a class='nav-group-name-link' href='{{path_to_root}}{{section}}.html'>{{section}}</a>
 6 |       <ul class='nav-group-tasks'>
 7 |         {{#children}}
 8 |         <li class='nav-group-task'>
 9 |           <a class='nav-group-task-link' href='{{path_to_root}}{{url}}'>{{name}}</a>
10 |         </li>
11 |         {{/children}}
12 |       </ul>
13 |     </li>
14 |     {{/structure}}
15 |   </ul>
16 | </nav>
17 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Tabman.h:
--------------------------------------------------------------------------------
 1 | //
 2 | //  Tabman.h
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 17/02/2017.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | #import <UIKit/UIKit.h>
10 | 
11 | //! Project version number for Tabman.
12 | FOUNDATION_EXPORT double TabmanVersionNumber;
13 | 
14 | //! Project version string for Tabman.
15 | FOUNDATION_EXPORT const unsigned char TabmanVersionString[];
16 | 
17 | // In this header, you should import all the public headers of your framework using statements like #import <Tabman/PublicHeader.h>
18 | 
19 | 
20 | 


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/InsetStore/InsetStore.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  InsetStore.swift
 3 | //  AutoInsetter
 4 | //
 5 | //  Created by Merrick Sapsford on 19/03/2019.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | protocol InsetStore: AnyObject {
12 |     
13 |     func store(contentInset: UIEdgeInsets, for view: UIScrollView)
14 |     func store(contentOffset: CGPoint, for view: UIScrollView)
15 |     
16 |     func contentInset(for view: UIScrollView) -> UIEdgeInsets?
17 |     func contentOffset(for view: UIScrollView) -> CGPoint?
18 | }
19 | 


--------------------------------------------------------------------------------
/.github/workflows/docs.yml:
--------------------------------------------------------------------------------
 1 | name: Documentation
 2 | on:
 3 |   push:
 4 |     branches:
 5 |       - main
 6 | 
 7 | jobs:
 8 |   publish:
 9 |     runs-on: macOS-14
10 |     steps:
11 |       - uses: maxim-lobanov/setup-xcode@v1
12 |         with:
13 |           xcode-version: latest-stable
14 |       - uses: actions/checkout@v2
15 |       - name: Prepare
16 |         run: |
17 |           bundle update --bundler
18 |           bundle install
19 |       - name: Publish Docs
20 |         env:
21 |           GITHUB_API_TOKEN: ${{ secrets.GH_UIAS_TOKEN }}
22 |         run: ./.scripts/update-gh-pages
23 | 


--------------------------------------------------------------------------------
/.github/workflows/build.yml:
--------------------------------------------------------------------------------
 1 | name: Build
 2 | on:
 3 |   push:
 4 |   pull_request:
 5 |     branches-ignore:
 6 |       - 'gh-pages'
 7 | 
 8 | jobs:
 9 |   Test:
10 |     runs-on: macOS-14
11 |     steps:
12 |       - uses: maxim-lobanov/setup-xcode@v1
13 |         with:
14 |           xcode-version: latest-stable
15 |       - uses: actions/checkout@v2
16 |       - name: Prepare
17 |         run: |
18 |           bundle update --bundler
19 |           bundle install
20 |       - name: Run tests
21 |         env:
22 |           SLACK_URL: ${{ secrets.SLACK_URL }}
23 |         run: bundle exec fastlane test
24 | 


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/AutoInsetSpec.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  AutoInsetSpec.swift
 3 | //  AutoInset
 4 | //
 5 | //  Created by Merrick Sapsford on 16/01/2018.
 6 | //  Copyright © 2018 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Specification for Auto Insetting values.
12 | internal protocol AutoInsetSpec {
13 |     
14 |     /// The insets that are required IN addition to UIKit components / safe area.
15 |     var additionalRequiredInsets: UIEdgeInsets { get }
16 |     
17 |     /// All insets that are required INCLUDING UIKit components / safe area.
18 |     var allRequiredInsets: UIEdgeInsets { get }
19 | }
20 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Extensions/PageboyViewController+RelativeCurrentPosition.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  PageboyViewController+RelativeCurrentPosition.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 22/10/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | import Pageboy
11 | 
12 | internal extension PageboyViewController {
13 |     
14 |     var relativeCurrentPosition: CGFloat? {
15 |         guard let position = self.currentPosition else {
16 |             return nil
17 |         }
18 |         return self.navigationOrientation == .horizontal ? position.x : position.y
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Extensions/PageboyNavigationDirection+Tabman.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  PageboyNavigationDirection+Tabman.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 02/01/2020.
 6 | //  Copyright © 2020 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Pageboy
10 | 
11 | extension PageboyViewController.NavigationDirection {
12 |     
13 |     var barUpdateDirection: TMBarUpdateDirection {
14 |         switch self {
15 |         case .forward:
16 |             return .forward
17 |         case .neutral:
18 |             return .none
19 |         case .reverse:
20 |             return .reverse
21 |         }
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/Docs/Tabman 3 Migration Guide.md:
--------------------------------------------------------------------------------
 1 | # Tabman 3 Migration Guide
 2 | 
 3 | This document outlines the various changes required to migrate to Tabman 3 from a previous version of Tabman.
 4 | 
 5 | Tabman 3 is the latest major release of Tabman; A powerful paging view controller with tab bar for iOS. Tabman 3 introduces several API-breaking changes that should be made aware of.
 6 | 
 7 | ## Requirements
 8 | - iOS 11
 9 | - Xcode 12 or newer
10 | - Swift 5
11 | 
12 | ## What's new
13 | - Added support for Xcode 14.
14 | - Updated minimum deployment target to iOS 11.
15 | 
16 | ## API Changes
17 | - `TabmanViewController.delegate` is now `unavailable` and can not be used.
18 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarButton/TMBarButtonController.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarButtonController.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 05/07/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Foundation
10 | 
11 | /// A controller which is responsible for a collection of bar buttons.
12 | internal class TMBarButtonController {
13 |     
14 |     // MARK: Properties
15 |     
16 |     let barButtons: [WeakContainer<TMBarButton>]
17 |     
18 |     // MARK: Init
19 |     
20 |     init(for barButtons: [TMBarButton]) {
21 |         self.barButtons = barButtons.map({ WeakContainer<TMBarButton>(for: $0) })
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/Extensions/CGRect+Interpolation.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  CGRect+Interpolation.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 07/06/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | extension CGRect {
12 |     
13 |     func interpolate(with other: CGRect, progress: CGFloat) -> CGRect {
14 |         return CGRect(x: (other.origin.x - origin.x) * progress,
15 |                       y: (other.origin.y - origin.y) * progress,
16 |                       width: (other.size.width - size.width) * progress,
17 |                       height: (other.size.height - size.height) * progress)
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/.github/FUNDING.yml:
--------------------------------------------------------------------------------
 1 | # These are supported funding model platforms
 2 | 
 3 | github: [msaps]
 4 | patreon: # Replace with a single Patreon username
 5 | open_collective: # Replace with a single Open Collective username
 6 | ko_fi: # Replace with a single Ko-fi username
 7 | tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
 8 | community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
 9 | liberapay: # Replace with a single Liberapay username
10 | issuehunt: # Replace with a single IssueHunt username
11 | otechie: # Replace with a single Otechie username
12 | custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
13 | 


--------------------------------------------------------------------------------
/.github/workflows/publish.yml:
--------------------------------------------------------------------------------
 1 | name: Publish
 2 | on:
 3 |   push:
 4 |     tags:
 5 |       - '*'
 6 | 
 7 | jobs:
 8 |   publish_release:
 9 |     runs-on: macOS-14
10 |     steps:
11 |       - uses: maxim-lobanov/setup-xcode@v1
12 |         with:
13 |           xcode-version: latest-stable
14 |       - uses: actions/checkout@v2
15 |       - name: Prepare
16 |         run: |
17 |           bundle update --bundler
18 |           bundle install
19 |       - name: Publish release
20 |         env:
21 |           SLACK_URL: ${{ secrets.SLACK_URL }}
22 |           COCOAPODS_TRUNK_TOKEN: ${{ secrets.COCOAPODS_TRUNK_TOKEN }}
23 |           GITHUB_API_TOKEN: ${{ secrets.GH_UIAS_TOKEN }}
24 |         run: bundle exec fastlane deploy
25 | 


--------------------------------------------------------------------------------
/Docs/jazzy-theme/assets/js/jazzy.js:
--------------------------------------------------------------------------------
 1 | window.jazzy = {'docset': false};
 2 | 
 3 | if (typeof window.dash != 'undefined') {
 4 |   document.documentElement.className += ' dash';
 5 |   window.jazzy.docset = true;
 6 | }
 7 | 
 8 | if (navigator.userAgent.match(/xcode/i)) {
 9 |   document.documentElement.className += ' xcode';
10 |   window.jazzy.docset = true;
11 | }
12 | 
13 | if (!window.jazzy.docset) {
14 |   $(function() {
15 |     var filename = window.location.pathname.split('/').pop();
16 |     $('a[href="Documentation.html"]').attr('href', 'index.html');
17 |     $('.navigation a[href$="/' + filename + '"]').addClass('current-page');
18 |     $('.navigation a[href="' + filename + '"]').addClass('current-page');
19 |   });
20 | }
21 | 


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/InsetCalculator/InsetCalculations.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  InsetCalculations.swift
 3 | //  AutoInsetter
 4 | //
 5 | //  Created by Merrick Sapsford on 20/03/2019.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal struct ContentInsetCalculation {
12 |     /// The new Content Inset
13 |     let new: UIEdgeInsets
14 |     /// The previously calculated Content Inset
15 |     let previous: UIEdgeInsets?
16 |     /// The current actual Content Inset of the view.
17 |     let currentActual: UIEdgeInsets
18 | }
19 | 
20 | internal struct ContentOffsetCalculation {
21 |     let new: CGPoint
22 |     let previous: CGPoint?
23 |     let currentActual: CGPoint
24 | }
25 | 


--------------------------------------------------------------------------------
/Sources/TabmanTests/Info.plist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 3 | <plist version="1.0">
 4 | <dict>
 5 | 	<key>CFBundleDevelopmentRegion</key>
 6 | 	<string>en</string>
 7 | 	<key>CFBundleExecutable</key>
 8 | 	<string>$(EXECUTABLE_NAME)</string>
 9 | 	<key>CFBundleIdentifier</key>
10 | 	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
11 | 	<key>CFBundleInfoDictionaryVersion</key>
12 | 	<string>6.0</string>
13 | 	<key>CFBundleName</key>
14 | 	<string>$(PRODUCT_NAME)</string>
15 | 	<key>CFBundlePackageType</key>
16 | 	<string>BNDL</string>
17 | 	<key>CFBundleShortVersionString</key>
18 | 	<string>1.0</string>
19 | 	<key>CFBundleVersion</key>
20 | 	<string>1</string>
21 | </dict>
22 | </plist>
23 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarLayout/TMBarLayoutInsetGuides.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarLayoutInsetGuides.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 08/08/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Object that provides layout guides for bar layout insets.
12 | internal protocol TMBarLayoutInsetGuides: AnyObject {
13 |     
14 |     /// The leading inset guide for the layout.
15 |     var leadingInset: UILayoutGuide { get }
16 |     /// The trailing inset guide for the layout.
17 |     var trailingInset: UILayoutGuide { get }
18 |     /// The insetted guide for the content in the layout.
19 |     var content: UILayoutGuide { get }
20 |     
21 |     /// The insets that are applied to the layout.
22 |     var insets: UIEdgeInsets { get set }
23 | }
24 | 


--------------------------------------------------------------------------------
/Sources/iOS/AppDelegate.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  AppDelegate.swift
 3 | //  Example
 4 | //
 5 | //  Created by Merrick Sapsford on 04/10/2020.
 6 | //
 7 | 
 8 | import UIKit
 9 | 
10 | @main
11 | class AppDelegate: UIResponder, UIApplicationDelegate {
12 | 
13 |     var window: UIWindow?
14 | 
15 |     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
16 |         
17 |         let gradientColors: [UIColor] = [.tabmanPrimary, .tabmanSecondary]
18 |         
19 |         window = UIWindow(frame: UIScreen.main.bounds)
20 |         window?.rootViewController = GradientBackgroundViewController(embedding: ButtonBarExampleViewController(), colors: gradientColors)
21 |         window?.makeKeyAndVisible()
22 |         
23 |         return true
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/TMAnimation.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMAnimation.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 30/10/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Foundation
10 | 
11 | /// Configuration for an animation.
12 | public struct TMAnimation {
13 |     /// Whether the animation is enabled.
14 |     public let isEnabled: Bool
15 |     /// Duration of the animation in seconds.
16 |     public let duration: TimeInterval
17 | 
18 |     /// Create an animation configuration.
19 |     ///
20 |     /// - Parameters:
21 |     ///   - isEnabled: Whether the animation is enabled.
22 |     ///   - duration: Duration of the animation in seconds.
23 |     public init(isEnabled: Bool, duration: TimeInterval) {
24 |         self.isEnabled = isEnabled
25 |         self.duration = duration
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarItem/UIKit+TMBarItemable.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  UIKit+TMBarItem.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 19/10/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// :nodoc:
12 | extension UINavigationItem: TMBarItemable {
13 | 
14 |     // swiftlint:disable unused_setter_value
15 | 
16 |     public var image: UIImage? {
17 |         get {
18 |             return nil
19 |         }
20 |         set {}
21 |     }
22 |     
23 |     public var selectedImage: UIImage? {
24 |         get {
25 |             return nil
26 |         }
27 |         set {}
28 |     }
29 |     
30 |     public var badgeValue: String? {
31 |         get {
32 |             return nil
33 |         }
34 |         set {}
35 |     }
36 | }
37 | 
38 | /// :nodoc:
39 | extension UITabBarItem: TMBarItemable {
40 | }
41 | 


--------------------------------------------------------------------------------
/Docs/jazzy-theme/templates/header.mustache:
--------------------------------------------------------------------------------
 1 | <header class='header'>
 2 |   <p class='header-col header-col--primary'>
 3 |     <a class='header-link' href='{{path_to_root}}index.html'>
 4 |       {{module_name}} Docs
 5 |     </a>
 6 |     {{#doc_coverage}} ({{doc_coverage}}% documented){{/doc_coverage}}
 7 |   </p>
 8 | 
 9 |   {{#github_url}}
10 |     <p class='header-col header-col--secondary'>
11 |       <a class='header-link' href='{{github_url}}'>
12 |         <img class='header-icon' src='{{path_to_root}}img/gh.png'/>
13 |         View on GitHub
14 |       </a>
15 |     </p>
16 |   {{/github_url}}
17 | 
18 |   {{#dash_url}}
19 |     <p class='header-col header-col--secondary'>
20 |       <a class='header-link' href='{{dash_url}}'>
21 |         <img class='header-icon' src='{{path_to_root}}img/dash.png'/>
22 |         Install in Dash
23 |       </a>
24 |     </p>
25 |   {{/dash_url}}
26 | </header>
27 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarView/TMBarViewFocusProvider.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarViewFocusProvider.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 07/06/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// An object that can provide focus related positional data to a BarView.
12 | public protocol TMBarViewFocusProvider: AnyObject {
13 |     
14 |     /**
15 |      Calculate the 'focusArea' for the current position and capacity.
16 |      
17 |      This `CGRect` defines the area of the layout that should currently be highlighted for the selected bar button.
18 |      
19 |      - Parameter position: Current position to display.
20 |      - Parameter capacity: Capacity of the bar (items).
21 |      
22 |      - Returns: Calculated focus rect.
23 |      **/
24 |     func focusArea(for position: CGFloat, capacity: Int) -> CGRect
25 | }
26 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/TMTransition.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMTransition.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 30/10/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Foundation
10 | 
11 | /// Style of transition to use for updates.
12 | ///
13 | /// - progressive: Progress will transition smoothly, and interpolate between values.
14 | /// - snap: Progress will transition between ranges when the mid-threshold is reached using animation.
15 | /// - none: Progress will transition between ranges when the mid-threshold is reached without any animation.
16 | public enum TMTransitionStyle {
17 |     case progressive
18 |     case snap
19 |     case none
20 | }
21 | 
22 | /// Object that can provide an animation style.
23 | internal protocol TMTransitionStyleable: AnyObject {
24 |     
25 |     var transitionStyle: TMTransitionStyle { get set }
26 | }
27 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/Utility/BarMath.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  BarMath.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 07/06/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | class BarMath {
12 |     
13 |     static func localIndexRange(for position: CGFloat, minimum: Int, maximum: Int) -> Range<Int> {
14 |         guard maximum > minimum else {
15 |             return 0 ..< 0
16 |         }
17 |         let lower = floor(position)
18 |         let upper = ceil(position)
19 |         let minimum = CGFloat(minimum)
20 |         let maximum = CGFloat(maximum)
21 |         
22 |         return Int(max(minimum, min(maximum, lower))) ..< Int(min(maximum, max(minimum, upper)))
23 |     }
24 |     
25 |     static func localProgress(for position: CGFloat) -> CGFloat {
26 |         var integral: Float = 0.0
27 |         return CGFloat(modff(Float(position), &integral))
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Info.plist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 3 | <plist version="1.0">
 4 | <dict>
 5 | 	<key>CFBundleDevelopmentRegion</key>
 6 | 	<string>en</string>
 7 | 	<key>CFBundleDisplayName</key>
 8 | 	<string>Tabman</string>
 9 | 	<key>CFBundleExecutable</key>
10 | 	<string>$(EXECUTABLE_NAME)</string>
11 | 	<key>CFBundleIdentifier</key>
12 | 	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
13 | 	<key>CFBundleInfoDictionaryVersion</key>
14 | 	<string>6.0</string>
15 | 	<key>CFBundleName</key>
16 | 	<string>$(PRODUCT_NAME)</string>
17 | 	<key>CFBundlePackageType</key>
18 | 	<string>FMWK</string>
19 | 	<key>CFBundleShortVersionString</key>
20 | 	<string>$(MARKETING_VERSION)</string>
21 | 	<key>CFBundleVersion</key>
22 | 	<string>AUTO_GENERATED</string>
23 | 	<key>NSPrincipalClass</key>
24 | 	<string></string>
25 | </dict>
26 | </plist>
27 | 


--------------------------------------------------------------------------------
/fastlane/Fastfile:
--------------------------------------------------------------------------------
 1 | 
 2 | fastlane_version "2.26.1"
 3 | 
 4 | default_platform :ios
 5 | 
 6 | platform :ios do
 7 | 
 8 |   desc "Run unit tests and check library"
 9 |   lane :test do
10 |     scan(workspace: "Tabman.xcworkspace", scheme: "Tabman", clean: true)
11 |   end
12 | 
13 |   desc "Deploy a new version to CocoaPods and GitHub"
14 |   lane :deploy do
15 |     test
16 | 
17 |     podspec = "Tabman.podspec"
18 |     version = version_get_podspec(path: podspec)
19 | 
20 |     # Push new Github release
21 |     github_release = set_github_release(
22 |       repository_name: "uias/Tabman",
23 |       api_token: ENV["GITHUB_API_TOKEN"],
24 |       name: version,
25 |       tag_name: version,
26 |       description: "#{version} release.",
27 |       commitish: "main"
28 |     )
29 | 
30 |     # Push spec
31 |     pod_push(allow_warnings: true, verbose: true)
32 | 
33 |     slack(
34 |       message: "Tabman v#{version} released!" 
35 |     )
36 |   end
37 | end


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarIndicator/TMBarIndicatorLayoutHandler.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarIndicatorLayoutHandler.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 14/06/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Layout handler that updates a `TMBarIndicator` layout constraints for a new focus rect.
12 | internal final class TMBarIndicatorLayoutHandler {
13 |     
14 |     // MARK: Properties
15 |     
16 |     private let leading: NSLayoutConstraint?
17 |     private let width: NSLayoutConstraint?
18 |     
19 |     // MARK: Init
20 |     
21 |     init(leading: NSLayoutConstraint?,
22 |          width: NSLayoutConstraint?) {
23 |         self.leading = leading
24 |         self.width = width
25 |     }
26 |     
27 |     // MARK: Updates
28 |     
29 |     func update(for rect: CGRect) {
30 |         self.leading?.constant = rect.minX
31 |         self.width?.constant = rect.size.width
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/Dangerfile:
--------------------------------------------------------------------------------
 1 | 
 2 | has_source_changes = !git.modified_files.grep(/Sources.*\.swift/).empty? || !git.added_files.grep(/Sources.*\.swift/).empty?
 3 | has_tests_changes = !git.modified_files.grep(/Sources\/PageboyTests.*\.swift/).empty? || !git.added_files.grep(/Sources\/PageboyTests.*\.swift/).empty?
 4 | 
 5 | # Make it more obvious that a PR is a work in progress and shouldn't be merged yet
 6 | warn("PR is classed as Work in Progress") if github.pr_title.include? "[WIP]"
 7 | 
 8 | # Warn when there is a big PR
 9 | warn("This PR might be a little too big, consider breaking it up.") if git.lines_of_code > 500
10 | 
11 | # Require PR description
12 | warn "Please provide a summary in the PR description, it makes it easier to understand!" if github.pr_body.length < 5
13 | 
14 | # Check for source changes and prompt for test updates if non added.
15 | if (has_source_changes && ! has_tests_changes)
16 |     warn("Looks like you changed some source files, should there have been some tests added?")
17 | end
18 | 
19 | swiftlint.lint_files


--------------------------------------------------------------------------------
/Docs/Sections/Bar.md:
--------------------------------------------------------------------------------
1 | The bar is responsible for conveying the current page position of a `TabmanViewController`, and providing the user with the ability to interact with the page view controller indirectly. In Tabman, this comes in the form of `TMBar`, a protocol that is restricted to `UIView` types. `TMBar` instances can be added to a `TabmanViewController` and are then internally managed by the view controller.
2 | 
3 | The default `TMBar` provided in Tabman is the `TMBarView`, a flexible view which contains the following core components:
4 | - Layout (`TMBarLayout`) - responsible for dictating the layout and display of the bar.
5 | - Buttons (`TMBarButton`) - interactable views that directly map to each bar item.
6 | - Indicator (`TMBarIndicator`) - view that indicates the currently active item.
7 | 
8 | These components are defined with generic type constraints on `TMBarView`, providing a huge amount of customization and flexibility. In all likelyhood you will not have to create your own `TMBar` but if required it is absolutely possible.


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/TMBar+Templates.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBar+Templates.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 06/06/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Foundation
10 | 
11 | extension TMBar {
12 |  
13 |     /// The default button bar, very reminiscent of the Android `FragmentPagerAdapter`. It consists
14 |     /// of a horizontal layout containing label bar buttons, and a line indicator at the bottom.
15 |     public typealias ButtonBar = TMBarView<TMHorizontalBarLayout, TMLabelBarButton, TMLineBarIndicator>
16 |     /// iOS 'UITabBar' style bar, featuring a constrained horizontal layout, tab item bar buttons with a
17 |     /// vertically aligned image and label, and no visible indicator.
18 |     public typealias TabBar = TMBarView<TMConstrainedHorizontalBarLayout, TMTabItemBarButton, TMBarIndicator.None>
19 |     /// Bar which features only a line indicator, and no buttons.
20 |     public typealias LineBar = TMBarView<TMBarLayout.None, TMBarButton.None, TMLineBarIndicator>
21 | }
22 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarButton/Types/TMBarButton+None.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarButton+None.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 28/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | extension TMBarButton {
12 |     
13 |     /// Button that is zero height and hidden.
14 |     ///
15 |     /// Use this if you do not want visible buttons in the bar.
16 |     public final class None: TMBarButton {
17 |         
18 |         // MARK: Properties
19 |         
20 |         // swiftlint:disable unused_setter_value
21 |         public override var isHidden: Bool {
22 |             get {
23 |                 return super.isHidden
24 |             }
25 |             set {
26 |                 super.isHidden = true
27 |             }
28 |         }
29 |         
30 |         // MARK: Lifecycle
31 |         
32 |         public override func layout(in view: UIView) {
33 |             super.layout(in: view)
34 |             
35 |             super.isHidden = true
36 |         }
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/Sources/iOS/Extras/UIColor+Tabman.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  UIColor+Tabman.swift
 3 | //  Example iOS
 4 | //
 5 | //  Created by Merrick Sapsford on 04/10/2020.
 6 | //
 7 | 
 8 | import UIKit
 9 | 
10 | extension UIColor {
11 |     
12 |     class var tabmanPrimary: UIColor {
13 |         UIColor(red: 0.56, green: 0.18, blue: 0.89, alpha: 1.00)
14 |     }
15 |     
16 |     class var tabmanSecondary: UIColor {
17 |         UIColor(red: 0.29, green: 0.00, blue: 0.88, alpha: 1.00)
18 |     }
19 |     
20 |     class var tabmanForeground: UIColor {
21 |         if #available(iOS 13, *) {
22 |             return UIColor { (traitCollection) -> UIColor in
23 |                 switch traitCollection.userInterfaceStyle {
24 |                 case .dark:
25 |                     return .white
26 |                 default:
27 |                     return UIColor(red: 0.56, green: 0.18, blue: 0.89, alpha: 1.00)
28 |                 }
29 |             }
30 |         } else {
31 |             return UIColor(red: 0.56, green: 0.18, blue: 0.89, alpha: 1.00)
32 |         }
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/Tabman.podspec:
--------------------------------------------------------------------------------
 1 | Pod::Spec.new do |s|
 2 |   
 3 |   s.name         = "Tabman"
 4 |   s.platform     = :ios, "12.0"
 5 |   s.requires_arc = true
 6 | 
 7 |   if s.respond_to? 'swift_versions'
 8 |     s.swift_versions = ['5.0']
 9 |   end
10 | 
11 |   s.version      = "3.2.0"
12 |   s.summary      = "A powerful paging view controller with indicator bar."
13 |   s.description  = <<-DESC
14 |             Tabman is a highly customisable, powerful and extendable paging view controller with indicator bar.
15 |                    DESC
16 | 
17 |   s.homepage          = "https://github.com/uias/Tabman"
18 |   s.license           = "MIT"
19 |   s.author            = { "Merrick Sapsford" => "merrick@sapsford.tech" }
20 |   s.social_media_url  = "http://twitter.com/MerrickSapsford"
21 | 
22 |   s.source       = { :git => "https://github.com/uias/Tabman.git", :tag => s.version.to_s }
23 |   s.source_files = "Sources/Tabman/**/*.{h,m,swift}"
24 | 
25 |   s.resource_bundles = {'Tabman' => ['Sources/Tabman/PrivacyInfo.xcprivacy']}
26 | 
27 |   s.dependency 'Pageboy', '~> 4.2.0'
28 |   
29 | end
30 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarLayout/TMBarLayoutParent.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarLayoutParent.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 08/08/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// The object that acts as a parent to a `TMBarLayout`.
12 | ///
13 | /// This is expected to be a view that can directly maniuplate the frames that the layout is
14 | /// contained within to handle content inset and other properties that are accessible from the
15 | /// layout but expected that a parent view is responsible for.
16 | internal protocol TMBarLayoutParent: TMTransitionStyleable {
17 |     
18 |     /// Content inset that is applied to the frame of the layout.
19 |     var contentInset: UIEdgeInsets { get set }
20 |     
21 |     /// Alignment that is applied to the layout.
22 |     var alignment: TMBarLayout.Alignment { get set }
23 |     
24 |     /// Bar layout requires a reload of its contents.
25 |     ///
26 |     /// - Parameter layout: Layout.
27 |     func layout(needsReload layout: TMBarLayout)
28 | }
29 | 


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/InsetStore/DefaultInsetStore.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  DefaultInsetStore.swift
 3 | //  AutoInsetter
 4 | //
 5 | //  Created by Merrick Sapsford on 19/03/2019.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal final class DefaultInsetStore: InsetStore {
12 |     
13 |     // MARK: Properties
14 |     
15 |     private var contentInsets = [UIScrollView: UIEdgeInsets]()
16 |     private var contentOffsets = [UIScrollView: CGPoint]()
17 |     
18 |     // MARK: InsetStore
19 |     
20 |     func store(contentInset: UIEdgeInsets, for view: UIScrollView) {
21 |         contentInsets[view] = contentInset
22 |     }
23 |     
24 |     func store(contentOffset: CGPoint, for view: UIScrollView) {
25 |         contentOffsets[view] = contentOffset
26 |     }
27 |     
28 |     func contentInset(for view: UIScrollView) -> UIEdgeInsets? {
29 |         return contentInsets[view]
30 |     }
31 |     
32 |     func contentOffset(for view: UIScrollView) -> CGPoint? {
33 |         return contentOffsets[view]
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/Package.swift:
--------------------------------------------------------------------------------
 1 | // swift-tools-version:5.7
 2 | 
 3 | import PackageDescription
 4 | 
 5 | let package = Package(
 6 |     name: "Tabman",
 7 |     platforms: [
 8 |         .iOS(.v12)
 9 |     ],
10 |     products: [
11 |         .library(
12 |             name: "Tabman",
13 |             targets: ["Tabman"])
14 |     ],
15 |     dependencies: [
16 |         .package(url: "https://github.com/uias/Pageboy", from: "4.2.0")
17 |     ],
18 |     targets: [
19 |         .target(
20 |             name: "Tabman",
21 |             dependencies: ["Pageboy"],
22 |             path: "Sources/Tabman",
23 |             exclude: ["Tabman.h", "Info.plist", "PrivacyInfo.xcprivacy"],
24 |             resources: [.process("PrivacyInfo.xcprivacy")],
25 |             linkerSettings: [
26 |                 .linkedFramework("UIKit")
27 |             ]
28 |         ),
29 |         .testTarget(
30 |             name: "TabmanTests",
31 |             dependencies: ["Tabman"],
32 |             linkerSettings: [
33 |                 .linkedFramework("UIKit")
34 |             ]
35 |         )
36 |     ],
37 |     swiftLanguageVersions: [.v5]
38 | )
39 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2022 UI At Six
 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 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Extensions/UIViewController+Tabman.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  UIViewController+Tabman.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 23/02/2019.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | import Pageboy
11 | 
12 | extension UIViewController {
13 |     
14 |     /// Parent TabmanViewController if it exists.
15 |     public var tabmanParent: TabmanViewController? {
16 |         return pageboyParent as? TabmanViewController
17 |     }
18 |     
19 |     /// All bar items that are associated with the index of this view controller
20 |     /// if within within a `TabmanViewController`.
21 |     public var tabmanBarItems: [TMBarItemable]? {
22 |         guard let tabViewController = tabmanParent, let index = pageboyPageIndex else {
23 |             return nil
24 |         }
25 |         
26 |         var allItems = [TMBarItemable]()
27 |         tabViewController.bars.forEach({
28 |             guard let items = $0.items, items.count > index else {
29 |                 return
30 |             }
31 |             allItems.append(items[index])
32 |         })
33 |         return allItems
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarIndicator/Types/TMBarIndicator+None.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarIndicator+None.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 28/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | extension TMBarIndicator {
12 |     
13 |     /// Indicator that is zero height and hidden.
14 |     ///
15 |     /// Use this if you do not want a visible indicator in the bar.
16 |     public final class None: TMBarIndicator {
17 |         
18 |         // MARK: Properties
19 |         
20 |         public override var displayMode: TMBarIndicator.DisplayMode {
21 |             return .fill
22 |         }
23 |         
24 |         // swiftlint:disable unused_setter_value
25 |         public override var isHidden: Bool {
26 |             get {
27 |                 return super.isHidden
28 |             }
29 |             set {
30 |                 super.isHidden = true
31 |             }
32 |         }
33 |         
34 |         // MARK: Lifecycle
35 |         
36 |         public override func layout(in view: UIView) {
37 |             super.layout(in: view)
38 |             
39 |             super.isHidden = true
40 |         }
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarView/TMBarViewScrollHandler.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarViewScrollHandler.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 14/10/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal protocol TMBarViewScrollHandlerDelegate: AnyObject {
12 |     
13 |     func barViewScrollHandler(_ handler: TMBarViewScrollHandler,
14 |                               didReceiveUpdated contentOffset: CGPoint,
15 |                               from scrollView: UIScrollView)
16 | }
17 | 
18 | /// Handler which interprets raw `UIScrollViewDelegate` events and provides updates via `TMBarViewScrollHandlerDelegate`.
19 | internal final class TMBarViewScrollHandler: NSObject {
20 |     
21 |     weak var delegate: TMBarViewScrollHandlerDelegate?
22 |     
23 |     init(for scrollView: UIScrollView) {
24 |         super.init()
25 |         scrollView.delegate = self
26 |     }
27 | }
28 | 
29 | extension TMBarViewScrollHandler: UIScrollViewDelegate {
30 |     
31 |     func scrollViewDidScroll(_ scrollView: UIScrollView) {
32 |         delegate?.barViewScrollHandler(self, didReceiveUpdated: scrollView.contentOffset, from: scrollView)
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/Sources/TabmanTests/Bar/MockBarView.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  MockBarView.swift
 3 | //  TabmanTests
 4 | //
 5 | //  Created by Merrick Sapsford on 01/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Foundation
10 | import UIKit
11 | @testable import Tabman
12 | import Pageboy
13 | 
14 | class MockBarView: UIView, TMBar {
15 |     
16 |     private(set) var items: [TMBarItemable]?
17 |     
18 |     weak var dataSource: TMBarDataSource?
19 |     weak var delegate: TMBarDelegate?
20 |     
21 |     // MARK: Lifecycle
22 |     
23 |     init(height: CGFloat = 50.0) {
24 |         super.init(frame: .zero)
25 |         
26 |         translatesAutoresizingMaskIntoConstraints = false
27 |         heightAnchor.constraint(equalToConstant: height).isActive = true
28 |     }
29 |     
30 |     required init?(coder aDecoder: NSCoder) {
31 |         fatalError("Not Supported")
32 |     }
33 |     
34 |     // MARK: Bar
35 |     
36 |     func reloadData(at indexes: ClosedRange<Int>, context: TMBarReloadContext) {
37 |         
38 |     }
39 |     
40 |     func update(for pagePosition: CGFloat, capacity: Int, direction: TMBarUpdateDirection, animation: TMAnimation) {
41 |         
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/Sources/iOS/ChildViewController.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  ChildViewController.swift
 3 | //  Example
 4 | //
 5 | //  Created by Merrick Sapsford on 04/10/2020.
 6 | //
 7 | 
 8 | import UIKit
 9 | 
10 | class ChildViewController: UIViewController {
11 | 
12 |     // MARK: Properties
13 |     
14 |     let page: Int
15 |     
16 |     // MARK: Init
17 |     
18 |     init(page: Int) {
19 |         self.page = page
20 |         super.init(nibName: nil, bundle: nil)
21 |     }
22 |     
23 |     @available(*, unavailable)
24 |     required init?(coder: NSCoder) {
25 |         fatalError("Not supported")
26 |     }
27 |     
28 |     // MARK: Lifecycle
29 |     
30 |     override func viewDidLoad() {
31 |         super.viewDidLoad()
32 |         
33 |         let label = UILabel()
34 |         view.addSubview(label)
35 |         label.translatesAutoresizingMaskIntoConstraints = false
36 |         NSLayoutConstraint.activate([
37 |             label.centerXAnchor.constraint(equalTo: view.centerXAnchor),
38 |             label.centerYAnchor.constraint(equalTo: view.centerYAnchor)
39 |         ])
40 |         label.text = "Page \(page)"
41 |         label.font = .systemFont(ofSize: 20.0, weight: .medium)
42 |         label.textColor = .lightText
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/Docs/Sections/TMBadgeView.md:
--------------------------------------------------------------------------------
 1 | `TMBarButton` supports displaying badges via an `TMBadgeView` which is available as `.badge` on every button 
 2 | 
 3 | *Note - it is at the discretion of the button to layout the badge, and some types may not support badging*.
 4 | 
 5 | ### Displaying a Badge
 6 | 
 7 | Setting the value of the badge is defined by the item the bar is displaying:
 8 | ```swift
 9 | func barItem(for bar: TMBar, at index: Int) -> TMBarItemable {
10 |     return TMBarItem(title: "My Page", badgeValue: "1")
11 | }
12 | ```
13 | 
14 | `TMBarItemable` also supports these values being dynamically updated, so for example to update the badge value for a child view controller:
15 | ```swift
16 | class ChildViewController: UIViewController() {
17 | 
18 |     var badgeCount = 0
19 | 
20 |     func increaseBadgeCount() {
21 |         badgeCount += 1
22 | 
23 |         // Update items in every bar for this page.
24 |         tabmanBarItems?.forEach({ $0.badgeValue = "\(badgeCount)" })
25 |     }
26 | }
27 | ```
28 | 
29 | *Unfortunately `UINavigationItem` and `UITabBarItem` don't support this dynamic update behavior.*
30 | 
31 | ### Customization
32 | 
33 | Customizing the `TMBadgeView` can all be done via `.badge` on `TMBarButton`.
34 | ```swift
35 | bar.buttons.customize { (button) in
36 |     button.badge.tintColor = .blue
37 | }
38 | ```


--------------------------------------------------------------------------------
/Sources/Tabman/Extensions/UIView+LayoutGuide.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  UIView+LayoutGuide.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Nghia Nguyen on 6/17/19.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | extension UIView {
12 |     @available(iOS 11.0, *)
13 |     private var internalSafeAreaLayoutGuide: UILayoutGuide? {
14 |         if self.responds(to: #selector(getter: UIView.safeAreaLayoutGuide)) == .some(true) {
15 |             return self.safeAreaLayoutGuide
16 |         } else {
17 |             return nil
18 |         }
19 |     }
20 |     
21 |     @available(iOS 11.0, *)
22 |     var safeAreaTopAnchor: NSLayoutYAxisAnchor {
23 |         return internalSafeAreaLayoutGuide?.topAnchor ?? topAnchor
24 |     }
25 |     
26 |     @available(iOS 11.0, *)
27 |     var safeAreaBottomAnchor: NSLayoutYAxisAnchor {
28 |         return internalSafeAreaLayoutGuide?.bottomAnchor ?? bottomAnchor
29 |     }
30 |     
31 |     @available(iOS 11.0, *)
32 |     var safeAreaTrailingAnchor: NSLayoutXAxisAnchor {
33 |         return internalSafeAreaLayoutGuide?.trailingAnchor ?? trailingAnchor
34 |     }
35 |     
36 |     @available(iOS 11.0, *)
37 |     var safeAreaLeadingAnchor: NSLayoutXAxisAnchor {
38 |         return internalSafeAreaLayoutGuide?.leadingAnchor ?? leadingAnchor
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/Generic/ViewTitleViewContainer.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  ViewTitleViewContainer.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 23/03/2019.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// View which provides the necessary container utilities for setting a view
12 | /// as a `UINavigationItem.titleView`.
13 | class ViewTitleViewContainer: UIView {
14 |     
15 |     // MARK: Properties
16 |     
17 |     override var intrinsicContentSize: CGSize {
18 |         return UIView.layoutFittingExpandedSize
19 |     }
20 |     
21 |     // MARK: Init
22 |     
23 |     init(for view: UIView) {
24 |         super.init(frame: .zero)
25 |         
26 |         layout(view: view, in: self)
27 |     }
28 |     
29 |     required init?(coder aDecoder: NSCoder) {
30 |         super.init(coder: aDecoder)
31 |     }
32 |     
33 |     // MARK: Layout
34 |     
35 |     private func layout(view: UIView, in container: UIView) {
36 |         container.addSubview(view)
37 |         
38 |         view.translatesAutoresizingMaskIntoConstraints = false
39 |         NSLayoutConstraint.activate([
40 |             view.leadingAnchor.constraint(equalTo: container.leadingAnchor),
41 |             view.topAnchor.constraint(equalTo: container.topAnchor),
42 |             container.trailingAnchor.constraint(equalTo: view.trailingAnchor),
43 |             container.bottomAnchor.constraint(equalTo: view.bottomAnchor)
44 |             ])
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/InsetExecutor/InsetExecutor.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  InsetExecutor.swift
 3 | //  AutoInsetter
 4 | //
 5 | //  Created by Merrick Sapsford on 16/03/2019.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | @available(iOS, deprecated: 11)
12 | internal class InsetExecutor {
13 |     
14 |     let view: UIScrollView
15 |     let calculator: InsetCalculator
16 |     let spec: AutoInsetSpec
17 |     
18 |     init(view: UIScrollView, calculator: InsetCalculator, spec: AutoInsetSpec) {
19 |         self.view = view
20 |         self.calculator = calculator
21 |         self.spec = spec
22 |     }
23 |     
24 |     func execute(store: InsetStore) {
25 |         
26 |         // If content inset has changed
27 |         if let contentInset = calculator.calculateContentInset(from: spec, store: store) {
28 |             view.contentInset = contentInset.new
29 |             invalidateLayoutIfNeeded()
30 | 
31 |             // If content offset has changed
32 |             if let contentOffset = calculator.calculateContentOffset(from: contentInset, store: store) {
33 |                 view.contentOffset = contentOffset.new
34 |             }
35 |         }
36 |         
37 |         // If indicator insets have changed.
38 |         if let scrollIndicatorInsets = calculator.calculateScrollIndicatorInsets(from: spec) {
39 |             view.scrollIndicatorInsets = scrollIndicatorInsets
40 |         }
41 |     }
42 |     
43 |     private func invalidateLayoutIfNeeded() {
44 |         (view as? UICollectionView)?.collectionViewLayout.invalidateLayout()
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/.scripts/generate-docs:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # ----- Check for dependencies
 4 | 
 5 | JAZZY=$(which jazzy)
 6 | if [ $? != 0 ]; then
 7 |     echo -e "Jazzy is required to generate documentation. Install it with:\n"
 8 |     echo -e "    gem install jazzy\n"
 9 |     exit
10 | fi
11 | echo "Using jazzy: $JAZZY"
12 | 
13 | 
14 | # ----- Commandline options
15 | 
16 | if [ "$BRANCH" == "" ]; then
17 |   BRANCH=$([ "$1" == "" ] && echo "main" || echo "$1")
18 | fi
19 | 
20 | if [ "$OUTPUT_PATH" == "" ]; then
21 |   OUTPUT_PATH=$([ "$2" == "" ] && echo "Docs/output/$BRANCH" || echo "$2")
22 | fi
23 | 
24 | 
25 | # ----- Configuration
26 | 
27 | ORGANISATION=uias
28 | NAME=Tabman
29 | TMP=Docs/tmp
30 | GITHUB=https://github.com/$ORGANISATION/$NAME
31 | URL=http://$ORGANISATION.github.io/$NAME
32 | 
33 | DOC_PROC=.scripts/doc-processor
34 | 
35 | # ----- Setup and generate docs
36 | 
37 | # Clean $TMP folder
38 | if [ -d "$TMP" ]; then rm -rf "$TMP"; fi
39 | mkdir -p $TMP/{compile,docs,sections}
40 | 
41 | cp Docs/Sections/*.md $TMP/sections/
42 | cp Docs/*.md $TMP/docs/
43 | 
44 | # Copy remaining root docs
45 | cp CONTRIBUTING.md "$TMP/docs/Contributing.md"
46 | cp CHANGELOG.md "$TMP/docs/Changelog.md"
47 | 
48 | # Copy README as Documentation root.
49 | $DOC_PROC README.md "$TMP/compile/README.md"
50 | $DOC_PROC README.md "$TMP/sections/Documentation.md"
51 | 
52 | # Compile our Docs/tmp + generate API docs using jazzy
53 | jazzy \
54 |   --config .jazzy.yaml \
55 |   --clean \
56 |   --output "$OUTPUT_PATH" \
57 |   --module-version "$BRANCH" \
58 |   --root-url "$URL/$BRANCH/" \
59 |   --github_url "$GITHUB" \
60 |   --github-file-prefix "$GITHUB/tree/$BRANCH"
61 | 
62 | cp Docs/img/* $OUTPUT_PATH/img/
63 | 


--------------------------------------------------------------------------------
/Docs/jazzy-theme/templates/doc.mustache:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang='en'>
 3 |   <head>
 4 |     <title>{{name}} {{kind}} Reference</title>
 5 |     <link rel='stylesheet' type='text/css' href='{{path_to_root}}css/jazzy.css' />
 6 |     <link rel='stylesheet' type='text/css' href='{{path_to_root}}css/highlight.css' />
 7 |     <meta charset='utf-8'>
 8 |     <script src='{{path_to_root}}js/jquery.min.js' defer></script>
 9 |     <script src='{{path_to_root}}js/jazzy.js' defer></script>
10 |   </head>
11 |   <body>
12 | 
13 |     {{#dash_type}}
14 |     <a name='//apple_ref/{{language_stub}}/{{dash_type}}/{{name}}' class='dashAnchor'></a>
15 |     {{/dash_type}}
16 | 
17 |     <a title='{{name}} {{kind}} Reference'></a>
18 | 
19 |     {{> header}}
20 | 
21 |     <p class='breadcrumbs'>
22 |       <a class='breadcrumb' href='{{path_to_root}}index.html'>{{module_name}} Reference</a>
23 |       <img class='carat' src='{{path_to_root}}img/carat.png' />
24 |       {{name}} {{kind}} Reference
25 |     </p>
26 | 
27 |     <div class='content-wrapper'>
28 |       {{> nav}}
29 |       <article class='main-content'>
30 | 
31 |         <section class='section'>
32 |           <div class='section-content'>
33 |             {{^hide_name}}<h1>{{name}}</h1>{{/hide_name}}
34 |             {{#declaration}}
35 |               <div class='declaration'>
36 |                 <div class='language'>
37 |                   {{{declaration}}}
38 |                 </div>
39 |               </div>
40 |             {{/declaration}}
41 |             {{{overview}}}
42 |           </div>
43 |         </section>
44 | 
45 |         {{> tasks}}
46 | 
47 |       </article>
48 |     </div>
49 |     {{> footer}}
50 |   </body>
51 | </div>
52 | </html>
53 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # Xcode
 2 | #
 3 | # gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
 4 | 
 5 | ## Build generated
 6 | build/
 7 | DerivedData/
 8 | 
 9 | ## Various settings
10 | *.pbxuser
11 | !default.pbxuser
12 | *.mode1v3
13 | !default.mode1v3
14 | *.mode2v3
15 | !default.mode2v3
16 | *.perspectivev3
17 | !default.perspectivev3
18 | xcuserdata/
19 | 
20 | ## Other
21 | *.moved-aside
22 | *.xcuserstate
23 | 
24 | ## Obj-C/Swift specific
25 | *.hmap
26 | *.ipa
27 | *.dSYM.zip
28 | *.dSYM
29 | 
30 | ## Playgrounds
31 | timeline.xctimeline
32 | playground.xcworkspace
33 | 
34 | # Swift Package Manager
35 | #
36 | # Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
37 | # Packages/
38 | .build/
39 | 
40 | # CocoaPods
41 | #
42 | # We recommend against adding the Pods directory to your .gitignore. However
43 | # you should judge for yourself, the pros and cons are mentioned at:
44 | # https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
45 | #
46 | Pods/
47 | 
48 | # Carthage
49 | #
50 | # Add this line if you want to avoid checking in source code from Carthage dependencies.
51 | # Carthage/Checkouts
52 | 
53 | Carthage/*
54 | 
55 | # fastlane
56 | #
57 | # It is recommended to not store the screenshots in the git repo. Instead, use fastlane to re-generate the
58 | # screenshots whenever they are needed.
59 | # For more information about the recommended setup visit:
60 | # https://github.com/fastlane/fastlane/blob/master/fastlane/docs/Gitignore.md
61 | 
62 | fastlane/report.xml
63 | fastlane/Preview.html
64 | fastlane/screenshots
65 | fastlane/test_output
66 | 
67 | # IntelliJ
68 | 
69 | .idea/
70 | 


--------------------------------------------------------------------------------
/Sources/iOS/Info.plist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 3 | <plist version="1.0">
 4 | <dict>
 5 | 	<key>CFBundleDevelopmentRegion</key>
 6 | 	<string>$(DEVELOPMENT_LANGUAGE)</string>
 7 | 	<key>CFBundleDisplayName</key>
 8 | 	<string>Tabman</string>
 9 | 	<key>CFBundleExecutable</key>
10 | 	<string>$(EXECUTABLE_NAME)</string>
11 | 	<key>CFBundleIdentifier</key>
12 | 	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
13 | 	<key>CFBundleInfoDictionaryVersion</key>
14 | 	<string>6.0</string>
15 | 	<key>CFBundleName</key>
16 | 	<string>$(PRODUCT_NAME)</string>
17 | 	<key>CFBundlePackageType</key>
18 | 	<string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
19 | 	<key>CFBundleShortVersionString</key>
20 | 	<string>$(MARKETING_VERSION)</string>
21 | 	<key>CFBundleVersion</key>
22 | 	<string>1</string>
23 | 	<key>LSRequiresIPhoneOS</key>
24 | 	<true/>
25 | 	<key>UIApplicationSupportsIndirectInputEvents</key>
26 | 	<true/>
27 | 	<key>UILaunchStoryboardName</key>
28 | 	<string>LaunchScreen</string>
29 | 	<key>UIRequiredDeviceCapabilities</key>
30 | 	<array>
31 | 		<string>armv7</string>
32 | 	</array>
33 | 	<key>UISupportedInterfaceOrientations</key>
34 | 	<array>
35 | 		<string>UIInterfaceOrientationPortrait</string>
36 | 		<string>UIInterfaceOrientationLandscapeLeft</string>
37 | 		<string>UIInterfaceOrientationLandscapeRight</string>
38 | 	</array>
39 | 	<key>UISupportedInterfaceOrientations~ipad</key>
40 | 	<array>
41 | 		<string>UIInterfaceOrientationPortrait</string>
42 | 		<string>UIInterfaceOrientationPortraitUpsideDown</string>
43 | 		<string>UIInterfaceOrientationLandscapeLeft</string>
44 | 		<string>UIInterfaceOrientationLandscapeRight</string>
45 | 	</array>
46 | </dict>
47 | </plist>
48 | 


--------------------------------------------------------------------------------
/.jazzy.yaml:
--------------------------------------------------------------------------------
 1 | xcodebuild_arguments: ["-workspace", "Tabman.xcworkspace", "-scheme", "Tabman"]
 2 | module: Tabman
 3 | clean: true
 4 | author: UI At Six
 5 | author_url: https://github.com/uias
 6 | github_url: https://github.com/uias/Tabman
 7 | # podspec: Tabman.podspec
 8 | 
 9 | skip_undocumented: true
10 | readme: Docs/tmp/compile/README.md
11 | abstract: Docs/tmp/sections/*.md
12 | documentation: Docs/tmp/docs/*md
13 | 
14 | theme: Docs/jazzy-theme/
15 | 
16 | copyright: '© 2019 [UI At Six](https://github.com/uias) under [open source license](https://github.com/uias/Tabman/blob/main/LICENSE).'
17 | 
18 | # swift_version: 4.2
19 | 
20 | custom_categories:
21 |   - name: Documentation
22 |     children:
23 |     - Adding a Bar
24 |     - Going Custom
25 |     - Example Projects
26 |     - Contributing
27 |     - Changelog
28 |     - Troubleshooting
29 |     - Tabman 2 Migration Guide
30 | 
31 |   - name: View Controller
32 |     children:
33 |     - TabmanViewController
34 |     
35 |   - name: Bar
36 |     children:
37 |     - TMBar
38 |     - TMBarView
39 |     - TMBarItemable
40 |     - TMBarItem
41 |     - TMBarDataSource
42 |     - TMBarDelegate
43 |     - TMSystemBar
44 |     - TMHidingBar
45 | 
46 |   - name: Layout
47 |     children:
48 |     - TMBarLayout
49 |     - TMHorizontalBarLayout
50 |     - TMConstrainedHorizontalBarLayout
51 | 
52 |   - name: Buttons
53 |     children:
54 |     - TMBarButton
55 |     - TMBarButtonCollection
56 |     - TMLabelBarButton
57 |     - TMTabItemBarButton
58 |     - TMBadgeView
59 | 
60 |   - name: Indicator
61 |     children:
62 |     - TMBarIndicator
63 |     - TMLineBarIndicator
64 |     - TMBlockBarIndicator
65 |     - TMChevronBarIndicator
66 |     - TMDotBarIndicator
67 | 
68 |   - name: Animation
69 |     children:
70 |     - TMAnimation
71 |     - TMTransitionStyle
72 | 


--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
 1 | # Contributing to Tabman
 2 | 
 3 | Thanks for your interest in contributing to Tabman! Please have a read through this document for how you can help! 🎉
 4 | 
 5 | You can help us reach that goal by contributing. Here are some ways you can contribute:
 6 | 
 7 | - [Report any issues or bugs that you find](https://github.com/uias/Tabman/issues/new)
 8 | - [Open issues for any new features you'd like Tabman to have](https://github.com/uias/Pageboy/issues/new)
 9 | - [Implement other tasks selected for development](https://github.com/uias/Tabman/issues?q=is%3Aissue+is%3Aopen+label%3A%22ready+for+development%22)
10 | - [Help answer questions asked by the community](https://github.com/uias/Tabman/issues?q=is%3Aopen+is%3Aissue+label%3Aquestion)
11 | - [Spread the word about Tabman](https://twitter.com/intent/tweet?text=Tabman,%20a%20powerful%20paging%20view%20controller%20with%20indicator%20bar,%20for%20iOS:%20https://github.com/uias/Tabman)
12 | 
13 | ## Code of conduct
14 | 
15 | All contributors are expected to follow our [Code of conduct](CODE_OF_CONDUCT.md).
16 | Please read it before making any contributions.
17 | 
18 | ## Setting up the project for development
19 | 
20 | - Fork / Clone the `Tabman` repository. 
21 | - Open `Tabman.xcworkspace` in Xcode and off you go!
22 | 
23 | ## Testing
24 | 
25 | ### Running tests
26 | 
27 | Tests should be added for all functionality, both when adding new behaviors to existing features, and implementing new ones.
28 | 
29 | Pageboy uses `XCTest` to run its tests, which can either be run through Xcode or by running `$ swift test` in the repository.
30 | 
31 | ## Questions or discussions
32 | 
33 | If you have a question about the inner workings of Tabman, or if you want to discuss a new feature - feel free to [open an issue](https://github.com/uias/Tabman/issues/new).
34 | 
35 | Happy contributing! 👨🏻‍💻
36 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarIndicator/TMBarIndicatorContainer.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarIndicatorContainer.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 02/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Container view that embeds a `TMBarIndicator`.
12 | ///
13 | /// Used for providing AutoLayout properties to `TMBarIndicatorLayoutHandler`.
14 | internal final class TMBarIndicatorContainer<Indicator: TMBarIndicator>: UIView {
15 |     
16 |     // MARK: Properties
17 |     
18 |     private(set) var layoutHandler: TMBarIndicatorLayoutHandler!
19 |     
20 |     // MARK: Init
21 |     
22 |     init(for indicator: Indicator) {
23 |         super.init(frame: .zero)
24 |         isUserInteractionEnabled = false
25 |         layout(indicator: indicator)
26 |     }
27 |     
28 |     @available(*, unavailable)
29 |     required init?(coder aDecoder: NSCoder) {
30 |         fatalError()
31 |     }
32 |     
33 |     // MARK: Layout
34 |     
35 |     private func layout(indicator: Indicator) {
36 |         guard indicator.superview == nil else {
37 |             fatalError("Indicator already has a superview.")
38 |         }
39 |         
40 |         addSubview(indicator)
41 |         indicator.translatesAutoresizingMaskIntoConstraints = false
42 |         
43 |         let leading = indicator.leftAnchor.constraint(equalTo: leftAnchor)
44 |         let top = indicator.topAnchor.constraint(equalTo: topAnchor)
45 |         let bottom = indicator.bottomAnchor.constraint(equalTo: bottomAnchor)
46 |         let width = indicator.widthAnchor.constraint(equalToConstant: 0.0)
47 |         
48 |         NSLayoutConstraint.activate([leading, top, bottom, width])
49 |         self.layoutHandler = TMBarIndicatorLayoutHandler(leading: leading,
50 |                                                        width: width)
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/Sources/TabmanTests/MockTabmanViewController.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  MockTabmanViewController.swift
 3 | //  TabmanTests
 4 | //
 5 | //  Created by Merrick Sapsford on 01/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Tabman
10 | import UIKit
11 | import Pageboy
12 | 
13 | class MockTabmanViewController: TabmanViewController {
14 |     
15 |     let viewControllers: [UIViewController]
16 |     let defaultIndex: Int?
17 |     
18 |     // MARK: Init
19 |     
20 |     init(pageCount: Int = 5, defaultIndex: Int? = nil) {
21 |         
22 |         var viewControllers = [UIViewController]()
23 |         for _ in 0 ..< pageCount {
24 |             viewControllers.append(UIViewController())
25 |         }
26 |         self.viewControllers = viewControllers
27 |         self.defaultIndex = defaultIndex
28 |         
29 |         super.init(nibName: nil, bundle: nil)
30 |     }
31 |     
32 |     required init?(coder aDecoder: NSCoder) {
33 |         fatalError("Not Supported")
34 |     }
35 |     
36 |     // MARK: Lifecycle
37 |     
38 |     override func viewDidLoad() {
39 |         super.viewDidLoad()
40 |         
41 |         self.dataSource = self
42 |     }
43 | }
44 | 
45 | extension MockTabmanViewController: PageboyViewControllerDataSource {
46 |     
47 |     func numberOfViewControllers(in pageboyViewController: PageboyViewController) -> Int {
48 |         return viewControllers.count
49 |     }
50 |     
51 |     func viewController(for pageboyViewController: PageboyViewController, at index: PageboyViewController.PageIndex) -> UIViewController? {
52 |         return viewControllers[index]
53 |     }
54 |     
55 |     func defaultPage(for pageboyViewController: PageboyViewController) -> PageboyViewController.Page? {
56 |         if let defaultIndex = self.defaultIndex {
57 |             return .at(index: defaultIndex)
58 |         }
59 |         return nil
60 |     }
61 | }
62 | 


--------------------------------------------------------------------------------
/.scripts/update-gh-pages:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | set -eo pipefail
 4 | 
 5 | # ----- Configuration
 6 | 
 7 | ORGANISATION=uias
 8 | NAME=Tabman
 9 | BRANCH=`git branch --show-current`
10 | SHA=`git rev-parse --verify HEAD --short`
11 | REPO=`git config remote.origin.url`
12 | 
13 | TMP=Docs/tmp
14 | CHECKOUT_PATH=Docs/output
15 | OUTPUT_PATH=$CHECKOUT_PATH/$BRANCH
16 | 
17 | 
18 | # ----- Clone the GitHub pages repo if required
19 | 
20 | echo " ==> Updating documentation for '$BRANCH' branch"
21 | 
22 | if [ -d "$CHECKOUT_PATH" ]; then
23 |     echo " ==> Update: gh-pages -> $CHECKOUT_PATH"
24 |     git -C "$CHECKOUT_PATH" pull origin gh-pages
25 | else
26 |     echo " ==> Checkout: gh-pages -> $CHECKOUT_PATH"
27 |     git clone --branch gh-pages "$REPO" "$CHECKOUT_PATH"
28 | fi
29 | 
30 | echo " ==> Generate documentation"
31 | .scripts/generate-docs "$BRANCH" "$OUTPUT_PATH"
32 | 
33 | # ----- Documentation updater
34 | 
35 | pushd "$CHECKOUT_PATH"
36 | 
37 |     git config user.name "uias-bot"
38 |     git config user.email "uias@sapsford.tech"
39 | 
40 |     # Exit if there are no changes to the documentation
41 |     echo " ==> Check for documentation changes"
42 |     CHANGE_SET=$(git status -s)
43 |     if [ "$CHANGE_SET" == "" ]; then
44 |         echo " <== No changes to the output on this push; exiting."
45 |         exit 0
46 |     fi
47 | 
48 |     # Exit if only the docset archive has changed (it always changes)
49 |     if [ "$CHANGE_SET" == " M $BRANCH/docsets/$NAME.tgz" ]; then
50 |         echo " <== Only the docset archive changed on this push; exiting."
51 |         exit 0
52 |     fi
53 | 
54 |     echo " ==> Stage changes"
55 |     git add -A "$BRANCH"
56 | 
57 |     echo " ==> Commit changes"
58 |     git commit -m "[$BRANCH $SHA] Regenerate documentation"
59 | 
60 |     echo " ==> Push changes -> '$REPO'"
61 |     git push -q "https://$GITHUB_API_TOKEN@github.com/$ORGANISATION/$NAME.git" gh-pages
62 | 
63 |     echo " <== All done 👊"
64 | popd
65 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarIndicator/Types/TMBlockBarIndicator.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBlockBarIndicator.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 06/11/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Indicator that fills the bar, displaying a solid color.
12 | open class TMBlockBarIndicator: TMBarIndicator {
13 |     
14 |     // MARK: Types
15 |     
16 |     public enum CornerStyle {
17 |         case square
18 |         case rounded
19 |         case eliptical
20 |     }
21 |     
22 |     // MARK: Properties
23 |     
24 |     open override var displayMode: TMBarIndicator.DisplayMode {
25 |         return .fill
26 |     }
27 |     
28 |     // MARK: Customization
29 |     
30 |     /// Corner style for the indicator.
31 |     ///
32 |     /// Options:
33 |     /// - square: Corners are squared off.
34 |     /// - rounded: Corners are rounded.
35 |     /// - eliptical: Corners are completely circular.
36 |     ///
37 |     /// Default: `.square`.
38 |     open var cornerStyle: CornerStyle = .square {
39 |         didSet {
40 |             setNeedsLayout()
41 |         }
42 |     }
43 |     
44 |     // MARK: Lifecycle
45 |     
46 |     open override func layout(in view: UIView) {
47 |         super.layout(in: view)
48 |         
49 |         self.backgroundColor = tintColor.withAlphaComponent(0.25)
50 |     }
51 |     
52 |     open override func layoutSubviews() {
53 |         super.layoutSubviews()
54 |         
55 |         superview?.layoutIfNeeded()
56 |         layer.cornerRadius = cornerStyle.cornerRadius(for: bounds)
57 |     }
58 | }
59 | 
60 | private extension TMBlockBarIndicator.CornerStyle {
61 |     
62 |     func cornerRadius(for frame: CGRect) -> CGFloat {
63 |         switch self {
64 |         case .square:
65 |             return 0.0
66 |         case .rounded:
67 |             return frame.size.height / 6.0
68 |         case .eliptical:
69 |             return frame.size.height / 2.0
70 |         }
71 |     }
72 | }
73 | 


--------------------------------------------------------------------------------
/Docs/Sections/TMHidingBar.md:
--------------------------------------------------------------------------------
 1 | `TMHidingBar` allows you to hide/show a `TMBar` manually and automatically with triggers.
 2 | 
 3 | It is provided as an extension to a `TMBar`, similar to `TMSystemBar`:
 4 | ```swift
 5 | let bar = TMBar.ButtonBar()
 6 | let hidingBar = bar.hiding(trigger: .time(duration: 5))
 7 | ```
 8 | 
 9 | This would create a `TMBar.ButtonBar` that is automatically hidden after 5 seconds.
10 | 
11 | *Recommendation - you should always use `.hiding()` as the final function when creating a bar.*
12 | 
13 | **As Tabman relies so heavily on type inference - you should ensure you are using the correct types for customization with the `TMBar` extensions. For example:**
14 | 
15 | ```swift
16 | TMBar.ButtonBar() -> TMBarView<TMHorizontalBarLayout, TMLabelBarButton, TMLineBarIndicator>
17 | TMBar.hiding(trigger:) -> TMHidingBar
18 | ```
19 | 
20 | ## Hide and Show
21 | 
22 | `TMHidingBar` provides show / hide functions that can be called at any time to hide the bar.
23 | 
24 | ```swift
25 | bar.hide(animated: true, completion: nil)
26 | bar.show(animated: true, completion: nil)
27 | ```
28 | *.show(animated:completion:) is automatically called when the bar is updated for a page change. You are responsible for calling it in any other desired scenario.*
29 | 
30 | The transition that is used for animation is dependent on the `transition` property.
31 | ```swift
32 | bar.transition = .drawer
33 | bar.transition = .fade
34 | ```
35 | 
36 | ### Triggers
37 | `TMHidingBar` provides configurable triggers that are passed as the `trigger:` parameter during initialization. These triggers have the ability to automatically hide and show the bar based on their type. They can of course be overriden by manual show / hide function calls.
38 | 
39 | #### `.manual`
40 | The manual trigger does nothing, and allows you to show / hide the bar manually with show / hide calls.
41 | 
42 | ```swift
43 | .manual
44 | ```
45 | 
46 | #### .time`
47 | The time trigger will hide the bar after a specified `TimeInterval` has elapsed. 
48 | 
49 | ```swift
50 | .time(duration: 10)
51 | ```


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/Utilities/UIViewController+ScrollViewDetection.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  UIViewController+ScrollViewDetection.swift
 3 | //  AutoInset
 4 | //
 5 | //  Created by Merrick Sapsford on 16/01/2018.
 6 | //  Copyright © 2018 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal extension UIViewController {
12 |     
13 |     var embeddedScrollViews: [UIScrollView?] {
14 |         if let tableViewController = self as? UITableViewController { // UITableViewController
15 |             return [tableViewController.tableView]
16 |         } else if let collectionViewController = self as? UICollectionViewController { // UICollectionViewController
17 |             return [collectionViewController.collectionView]
18 |         } else { // standard subview filtering
19 |             return scrollViews(in: self.view)
20 |         }
21 |     }
22 |     
23 |     func scrollViews(in view: UIView) -> [UIScrollView] {
24 |         var scrollViews = [UIScrollView]()
25 |         
26 |         for subview in view.subviews {
27 |             // if current view is scroll view add it and ignore the subviews
28 |             // - as it can be assumed they will be insetted correctly within the parent scroll view.
29 |             if let scrollView = subview as? UIScrollView {
30 |                 scrollViews.append(scrollView)
31 |             } else {
32 |                 scrollViews.append(contentsOf: self.scrollViews(in: subview))
33 |             }
34 |         }
35 |         return scrollViews
36 |     }
37 |     
38 |     func forEachEmbeddedScrollView(_ action: (UIScrollView) -> Void) {
39 |         for scrollView in self.embeddedScrollViews {
40 |             guard let scrollView = scrollView, scrollView.window != nil else { continue }
41 |             
42 |             action(scrollView)
43 |         }
44 |     }
45 |     
46 |     func shouldEvaluateEmbeddedScrollViews() -> Bool {
47 |         if self is UIPageViewController { // Ignore UIPageViewController
48 |             return false
49 |         }
50 |         return true
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarLayout/Types/TMBarLayout+None.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarLayout+None.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 28/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | extension TMBarLayout {
12 |     
13 |     /// Layout that won't display any visible bar buttons.
14 |     ///
15 |     /// The indicator will be visible and equally distributed in the layout width.
16 |     public final class None: TMBarLayout {
17 |         
18 |         // MARK: Properties
19 |         
20 |         // swiftlint:disable unused_setter_value
21 |         @available(*, unavailable)
22 |         public override var contentMode: TMBarLayout.ContentMode {
23 |             get {
24 |                 return super.contentMode
25 |             }
26 |             set {
27 |                 fatalError("\(type(of: self)) does not support updating contentMode")
28 |             }
29 |         }
30 |         
31 |         // MARK: Lifecycle
32 |         
33 |         public override func layout(in view: UIView) {
34 |             super.layout(in: view)
35 |             super.contentMode = .fit
36 |         }
37 |         
38 |         public override func insert(buttons: [TMBarButton], at index: Int) {
39 |         }
40 |         
41 |         public override func remove(buttons: [TMBarButton]) {
42 |         }
43 |         
44 |         public override func focusArea(for position: CGFloat, capacity: Int) -> CGRect {
45 |             guard capacity != 0 else {
46 |                 return .zero
47 |             }
48 |             
49 |             let viewWidth = view.bounds.size.width
50 |             let buttonWidth = viewWidth / CGFloat(capacity)
51 |             
52 |             let proposedX = buttonWidth * position
53 |             let constrainedX = max(0.0, min(proposedX, viewWidth - buttonWidth))
54 |             
55 |             return CGRect(x: constrainedX,
56 |                           y: 0.0,
57 |                           width: buttonWidth,
58 |                           height: 0.0)
59 |         }
60 |     }
61 | }
62 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarButton/TMBarButtonInteractionController.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarButtonInteractionController.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 05/07/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import Foundation
10 | 
11 | internal protocol TMBarButtonInteractionHandler: AnyObject {
12 |     
13 |     func barButtonInteraction(controller: TMBarButtonInteractionController,
14 |                               didHandlePressOf button: TMBarButton,
15 |                               at index: Int)
16 | }
17 | 
18 | /// A bar button controller that is responsbile for handling interaction that occurs in bar buttons.
19 | internal final class TMBarButtonInteractionController: TMBarButtonController, Hashable, Equatable {
20 | 
21 |     // MARK: Properties
22 |     
23 |     private weak var handler: TMBarButtonInteractionHandler?
24 |     
25 |     // MARK: Init
26 |     
27 |     init(for barButtons: [TMBarButton], handler: TMBarButtonInteractionHandler) {
28 |         self.handler = handler
29 |         super.init(for: barButtons)
30 |         
31 |         barButtons.forEach({ (button) in
32 |             button.addTarget(self, action: #selector(barButtonPressed(_:)), for: .touchUpInside)
33 |         })
34 |     }
35 |     
36 |     override init(for barButtons: [TMBarButton]?) {
37 |         fatalError("Use init(for barButtons: handler:)")
38 |     }
39 |     
40 |     // MARK: Actions
41 |     
42 |     @objc private func barButtonPressed(_ sender: TMBarButton) {
43 |         guard let index = barButtons.firstIndex(where: { $0.object === sender }) else {
44 |             return
45 |         }
46 |         handler?.barButtonInteraction(controller: self,
47 |                                       didHandlePressOf: sender,
48 |                                       at: index)
49 |     }
50 | 
51 |     func hash(into hasher: inout Hasher) {
52 |     }
53 | 
54 |     static func == (lhs: TMBarButtonInteractionController, rhs: TMBarButtonInteractionController) -> Bool {
55 |         if lhs === rhs {
56 |             return true
57 |         }
58 |         if type(of: lhs) != type(of: rhs) {
59 |             return false
60 |         }
61 |         return true
62 |     }
63 | }
64 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarExtensions/AutoHidingBar/TMHidingBar+Triggers.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMHidingBar+Triggers.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 17/12/2018.
 6 | //  Copyright © 2018 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal class TMAutoHidingTriggerHandler {
12 |     
13 |     // MARK: Properties
14 |     
15 |     internal private(set) weak var bar: TMHidingBar!
16 |     
17 |     var viewController: UIViewController? {
18 |         return bar.delegate as? UIViewController
19 |     }
20 |     
21 |     // MARK: Init
22 |     
23 |     init(for bar: TMHidingBar) {
24 |         self.bar = bar
25 |     }
26 |     
27 |     // MARK: Lifecycle
28 |     
29 |     func invalidate(animated: Bool = true, completion: ((Bool) -> Void)? = nil) {
30 |         bar.performShow(animated: animated, completion: completion)
31 |     }
32 | }
33 | 
34 | internal class TMAutoHidingTimeTriggerHandler: TMAutoHidingTriggerHandler {
35 |     
36 |     // MARK: Properties
37 |     
38 |     let duration: TimeInterval
39 |     
40 |     private var timer: Timer?
41 |     
42 |     // MARK: Init
43 |     
44 |     init(for bar: TMHidingBar, duration: TimeInterval) {
45 |         self.duration = duration
46 |         super.init(for: bar)
47 |         
48 |         resetDismissTimer()
49 |     }
50 |     
51 |     @available(*, unavailable)
52 |     override init(for bar: TMHidingBar) {
53 |         fatalError()
54 |     }
55 |     
56 |     // MARK: Overrides
57 |     
58 |     override func invalidate(animated: Bool = true, completion: ((Bool) -> Void)? = nil) {
59 |         super.invalidate(animated: animated, completion: completion)
60 |         resetDismissTimer()
61 |     }
62 |     
63 |     // MARK: Timers
64 |     
65 |     private func resetDismissTimer() {
66 |         timer?.invalidate()
67 |         timer = Timer.scheduledTimer(timeInterval: duration,
68 |                                      target: self,
69 |                                      selector: #selector(timerFired(_:)),
70 |                                      userInfo: nil,
71 |                                      repeats: false)
72 |     }
73 |     
74 |     @objc private func timerFired(_ sender: Timer) {
75 |         bar.hide(animated: true, completion: nil)
76 |     }
77 | }
78 | 


--------------------------------------------------------------------------------
/Tabman.xcworkspace/xcshareddata/Tabman.xcscmblueprint:
--------------------------------------------------------------------------------
 1 | {
 2 |   "DVTSourceControlWorkspaceBlueprintPrimaryRemoteRepositoryKey" : "E5F0E81232759AF1971B67A3B1832E8FE24A37DA",
 3 |   "DVTSourceControlWorkspaceBlueprintWorkingCopyRepositoryLocationsKey" : {
 4 | 
 5 |   },
 6 |   "DVTSourceControlWorkspaceBlueprintWorkingCopyStatesKey" : {
 7 |     "E5F0E81232759AF1971B67A3B1832E8FE24A37DA" : 9223372036854775807,
 8 |     "5EAF35CE4BAF1F2954906692E85F4F33D0A586BE" : 9223372036854775807,
 9 |     "E6248D77DBBC6B1D6F6059D14C6A0B9ED1677585" : 9223372036854775807
10 |   },
11 |   "DVTSourceControlWorkspaceBlueprintIdentifierKey" : "2A0F3E59-3670-41EC-A4EB-8599A1093647",
12 |   "DVTSourceControlWorkspaceBlueprintWorkingCopyPathsKey" : {
13 |     "E5F0E81232759AF1971B67A3B1832E8FE24A37DA" : "Tabman\/",
14 |     "5EAF35CE4BAF1F2954906692E85F4F33D0A586BE" : "Tabman\/Example\/Dependencies\/Pageboy\/",
15 |     "E6248D77DBBC6B1D6F6059D14C6A0B9ED1677585" : "Tabman\/Example\/Dependencies\/PureLayout\/"
16 |   },
17 |   "DVTSourceControlWorkspaceBlueprintNameKey" : "Tabman",
18 |   "DVTSourceControlWorkspaceBlueprintVersion" : 204,
19 |   "DVTSourceControlWorkspaceBlueprintRelativePathToProjectKey" : "Tabman.xcworkspace",
20 |   "DVTSourceControlWorkspaceBlueprintRemoteRepositoriesKey" : [
21 |     {
22 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "https:\/\/github.com\/MerrickSapsford\/Pageboy",
23 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
24 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "5EAF35CE4BAF1F2954906692E85F4F33D0A586BE"
25 |     },
26 |     {
27 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "https:\/\/github.com\/MerrickSapsford\/Tabman.git",
28 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
29 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "E5F0E81232759AF1971B67A3B1832E8FE24A37DA"
30 |     },
31 |     {
32 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "https:\/\/github.com\/purelayout\/purelayout",
33 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
34 |       "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "E6248D77DBBC6B1D6F6059D14C6A0B9ED1677585"
35 |     }
36 |   ]
37 | }


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/Generic/EdgeFadedView.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  EdgeFadedView.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 03/08/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal final class EdgeFadedView: UIView {
12 |     
13 |     private struct Defaults {
14 |         static let leadingStartLocation: CGFloat = 0.02
15 |         static let leadingEndLocation: CGFloat = 0.05
16 |         static let trailingEndLocation: CGFloat = 0.95
17 |         static let trailingStartLocation: CGFloat = 0.98
18 |     }
19 |     
20 |     private let gradientLayer: CAGradientLayer = {
21 |         let gradientLayer = CAGradientLayer()
22 |         gradientLayer.colors = [UIColor.clear.cgColor, UIColor.white.cgColor, UIColor.white.cgColor, UIColor.clear.cgColor]
23 |         gradientLayer.startPoint = CGPoint(x: 0.0, y: 0.5)
24 |         gradientLayer.endPoint = CGPoint(x: 1.0, y: 0.5)
25 |         return gradientLayer
26 |     }()
27 |     
28 |     var showFade: Bool = false {
29 |         didSet {
30 |             updateFadeRatios()
31 |             layer.mask = showFade ? gradientLayer : nil
32 |         }
33 |     }
34 |     var leadingFade: CGFloat = 1.0 {
35 |         didSet {
36 |             updateFadeRatios()
37 |         }
38 |     }
39 |     var trailingFade: CGFloat = 1.0 {
40 |         didSet {
41 |             updateFadeRatios()
42 |         }
43 |     }
44 |     
45 |     // MARK: Lifecycle
46 |     
47 |     override func layoutSubviews() {
48 |         super.layoutSubviews()
49 |         superview?.layoutIfNeeded()
50 |         
51 |         gradientLayer.frame = self.bounds
52 |     }
53 |     
54 |     // MARK: Updates
55 |     
56 |     private func updateFadeRatios() {
57 |         
58 |         let leadingStartLocation = NSNumber(value: Float(Defaults.leadingStartLocation * leadingFade))
59 |         let leadingEndLocation = NSNumber(value: Float(Defaults.leadingEndLocation * leadingFade))
60 |         let trailingEndLocation = NSNumber(value: Float(1.0 - ((1.0 - Defaults.trailingEndLocation) * trailingFade)))
61 |         let trailingStartLocation = NSNumber(value: Float(1.0 - ((1.0 - Defaults.trailingStartLocation) * trailingFade)))
62 | 
63 |         gradientLayer.locations = [leadingStartLocation, leadingEndLocation,
64 |                                    trailingEndLocation, trailingStartLocation]
65 |     }
66 | }
67 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarButton/TMBarButtonStateController.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarButtonStateController.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 03/07/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// A bar button controller that is responsible for handling the control state of buttons.
12 | internal final class TMBarButtonStateController: TMBarButtonController {
13 |     
14 |     // MARK: Properties
15 |     
16 |     private weak var selectedButton: TMBarButton? {
17 |         didSet {
18 |             if oldValue !== selectedButton {
19 |                 oldValue?.selectionState = .unselected
20 |             }
21 |             selectedButton?.selectionState = .selected
22 |         }
23 |     }
24 |     
25 |     // MARK: Init
26 |     
27 |     override init(for barButtons: [TMBarButton]) {
28 |         super.init(for: barButtons)
29 |         barButtons.forEach({ $0.selectionState = .unselected })
30 |     }
31 |     
32 |     // MARK: Update
33 |     
34 |     func update(for position: CGFloat, direction: TMBarUpdateDirection) {
35 |         let capacity = barButtons.count
36 |         let range = BarMath.localIndexRange(for: position, minimum: 0, maximum: capacity - 1)
37 |         guard barButtons.count > range.upperBound else {
38 |             return
39 |         }
40 |         
41 |         let lowerButton = barButtons[range.lowerBound].object
42 |         let upperButton = barButtons[range.upperBound].object
43 |         
44 |         let targetButton = direction != .reverse ? upperButton : lowerButton
45 |         let oldTargetButton = direction != .reverse ? lowerButton : upperButton
46 |         
47 |         let progress = BarMath.localProgress(for: position)
48 |         let directionalProgress = direction != .reverse ? progress : 1.0 - progress
49 |         
50 |         guard targetButton !== oldTargetButton else {
51 |             self.selectedButton = targetButton
52 |             return
53 |         }
54 |         
55 |         targetButton?.selectionState = .from(rawValue: directionalProgress)
56 |         
57 |         let progressComplement = 1.0 - directionalProgress
58 |         if progressComplement < 0.001 { // e - 0.001
59 |             self.selectedButton = targetButton
60 |         }
61 |         
62 |         oldTargetButton?.selectionState = .from(rawValue: progressComplement)
63 |     }
64 | }
65 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarIndicator/TMBarIndicator.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarIndicator.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 07/06/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// View that provides indication of the current page position.
12 | open class TMBarIndicator: UIView, TMTransitionStyleable {
13 |     
14 |     // MARK: Types
15 |     
16 |     /// Display mode of the indicator in a bar.
17 |     ///
18 |     /// - top: Indicator goes above the bar contents.
19 |     /// - bottom: Indicator goes below the bar contents.
20 |     /// - fill: Indicator fills the height of the bar, behind the bar contents.
21 |     public enum DisplayMode {
22 |         case top
23 |         case bottom
24 |         case fill
25 |     }
26 | 
27 |     public enum OverscrollBehavior {
28 |         case bounce
29 |         case compress
30 |         case none
31 |     }
32 |     
33 |     // MARK: Customization
34 |     
35 |     /// Display mode for the indicator.
36 |     open var displayMode: DisplayMode {
37 |         fatalError("Return displayMode in subclass")
38 |     }
39 |     
40 |      /// Behavior the indicator should exhibit when scrolling over the bounds of the bar.
41 |      ///
42 |      /// Options:
43 |      /// - `.bounce`: Bounce the indicator beyond the bounds of the bar.
44 |      /// - `.compress`: Compress the indicators width as overscroll occurs.
45 |      /// - `.none`: Don't do anything.
46 |      ///
47 |      /// Defaults to `.bounce`.
48 |     open var overscrollBehavior: OverscrollBehavior = .bounce
49 |     /// Whether the indicator should display progressively, traversing page indexes as visible progress.
50 |     open var isProgressive: Bool = false
51 |     /// Style of transition to use when updating the indicator.
52 |     public var transitionStyle: TMTransitionStyle = .progressive
53 |     
54 |     // MARK: Init
55 |     
56 |     public required init() {
57 |         super.init(frame: .zero)
58 |         initialize()
59 |     }
60 |     
61 |     public override init(frame: CGRect) {
62 |         super.init(frame: frame)
63 |         initialize()
64 |     }
65 |     
66 |     public required init?(coder aDecoder: NSCoder) {
67 |         super.init(coder: aDecoder)
68 |         initialize()
69 |     }
70 |     
71 |     private func initialize() {
72 |         layout(in: self)
73 |     }
74 |     
75 |     // MARK: Lifecycle
76 |     
77 |     open func layout(in view: UIView) {
78 |     }
79 | }
80 | 


--------------------------------------------------------------------------------
/Sources/Tabman/TabmanViewController+Insets.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TabmanViewController+Insets.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 10/10/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | extension TabmanViewController {
12 |     
13 |     /// Object containing inset data that is required for all bars in a `TabmanViewController`.
14 |     public struct Insets {
15 |         
16 |         static func `for`(_ viewController: TabmanViewController) -> Insets {
17 |             return Insets(viewController: viewController)
18 |         }
19 |         
20 |         // MARK: Properties
21 |         
22 |         /// The safe area insets of the `TabmanViewController`.
23 |         public let safeAreaInsets: UIEdgeInsets
24 |         /// The insets required for all bars in the `TabmanViewController`
25 |         public let barInsets: UIEdgeInsets
26 |         
27 |         /// Inset specification for AutoInsetter.
28 |         internal var spec: AutoInsetSpec {
29 |             return InsetsSpec(allRequiredInsets: UIEdgeInsets(top: safeAreaInsets.top + barInsets.top,
30 |                                                               left: safeAreaInsets.left + barInsets.left,
31 |                                                               bottom: safeAreaInsets.bottom + barInsets.bottom,
32 |                                                               right: safeAreaInsets.right + barInsets.right),
33 |                               additionalRequiredInsets: barInsets)
34 |         }
35 |         
36 |         // MARK: Init
37 |         
38 |         private init(viewController: TabmanViewController) {
39 |             let safeAreaInsets = viewController.view.safeAreaInsets
40 |             let barInsets = UIEdgeInsets(top: viewController.topBarContainer.bounds.size.height,
41 |                                          left: 0.0,
42 |                                          bottom: viewController.bottomBarContainer.bounds.size.height,
43 |                                          right: 0.0)
44 |             
45 |             self.init(barInsets: barInsets, safeAreaInsets: safeAreaInsets)
46 |         }
47 |         
48 |         public init(barInsets: UIEdgeInsets, safeAreaInsets: UIEdgeInsets) {
49 |             self.barInsets = barInsets
50 |             self.safeAreaInsets = safeAreaInsets
51 |         }
52 |     }
53 | }
54 | 
55 | extension TabmanViewController {
56 |     
57 |     /// Spec for AutoInsetter
58 |     internal struct InsetsSpec: AutoInsetSpec {
59 |         
60 |         let allRequiredInsets: UIEdgeInsets
61 |         let additionalRequiredInsets: UIEdgeInsets
62 |     }
63 | }
64 | 


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/AutoInsetter.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  AutoInsetter.swift
 3 | //  AutoInset
 4 | //
 5 | //  Created by Merrick Sapsford on 16/01/2018.
 6 | //  Copyright © 2018 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Engine that provides Auto Insetting to UIViewControllers.
12 | internal final class AutoInsetter {
13 |     
14 |     // MARK: Properties
15 |     
16 |     private var currentContentInsets = [UIScrollView: UIEdgeInsets]()
17 |     private var currentContentOffsets = [UIScrollView: CGPoint]()
18 |     
19 |     private let insetStore: InsetStore = DefaultInsetStore()
20 |     
21 |     /// Whether auto-insetting is enabled.
22 |     @available(*, deprecated, message: "Use enable(for:)")
23 |     public var isEnabled: Bool {
24 |         get {
25 |             return _isEnabled
26 |         }
27 |         set {
28 |             if newValue {
29 |                 _enable(for: nil)
30 |             }
31 |         } 
32 |     }
33 |     private var _isEnabled: Bool = false
34 |     
35 |     // MARK: Init
36 |     
37 |     init() {}
38 |     
39 |     // MARK: State
40 |     
41 |     /// Enable Auto Insetting for a view controller.
42 |     ///
43 |     /// - Parameter viewController: View controller that will provide insetting.
44 |     func enable(for viewController: UIViewController?) {
45 |         _enable(for: viewController)
46 |     }
47 |     
48 |     private func _enable(for viewController: UIViewController?) {
49 |         _isEnabled = true
50 |     }
51 |     
52 |     // MARK: Insetting
53 |     
54 |     /// Inset a view controller by a set of required insets.
55 |     ///
56 |     /// - Parameters:
57 |     ///   - viewController: view controller to inset.
58 |     ///   - requiredInsetSpec: The required inset specification.
59 |     func inset(_ viewController: UIViewController?,
60 |                requiredInsetSpec: AutoInsetSpec) {
61 |         guard let viewController = viewController, _isEnabled else {
62 |             return
63 |         }
64 |         
65 |         if requiredInsetSpec.additionalRequiredInsets != viewController.additionalSafeAreaInsets {
66 |             viewController.additionalSafeAreaInsets = requiredInsetSpec.additionalRequiredInsets
67 |         }
68 |     }
69 | }
70 | 
71 | // MARK: - Utilities
72 | private extension AutoInsetter {
73 |     
74 |     /// Check whether a view controller is an 'embedded' view controller type (i.e. UITableViewController)
75 |     ///
76 |     /// - Parameters:
77 |     ///   - viewController: The view controller.
78 |     ///   - success: Execution if view controller is not embedded type.
79 |     func isEmbeddedViewController(_ viewController: UIViewController) -> Bool {
80 |         if (viewController is UITableViewController) || (viewController is UICollectionViewController) {
81 |             return true
82 |         }
83 |         return false
84 |     }
85 | }
86 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarView/TMBarViewLayoutGrid.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarViewLayoutGrid.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 02/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// 'Grid' view containig vertical / horizontal stack views.
12 | internal final class TMBarViewLayoutGrid: UIView {
13 |     
14 |     // MARK: Properties
15 |     
16 |     private let verticalStack: UIStackView = {
17 |         let stackView = UIStackView()
18 |         stackView.axis = .vertical
19 |         stackView.translatesAutoresizingMaskIntoConstraints = false
20 |         return stackView
21 |     }()
22 |     private let horizontalStack: UIStackView = {
23 |         let stackView = UIStackView()
24 |         stackView.axis = .horizontal
25 |         stackView.translatesAutoresizingMaskIntoConstraints = false
26 |         return stackView
27 |     }()
28 |     
29 |     var horizontalSpacing: CGFloat {
30 |         get {
31 |             return horizontalStack.spacing
32 |         }
33 |         set {
34 |             horizontalStack.spacing = newValue
35 |         }
36 |     }
37 |     
38 |     // MARK: Init
39 |     
40 |     init(with mainView: UIView) {
41 |         super.init(frame: .zero)
42 |         initialize(with: mainView)
43 |     }
44 |     
45 |     @available(*, unavailable)
46 |     init() {
47 |         fatalError("Use init(with mainView:)")
48 |     }
49 |     
50 |     @available(*, unavailable)
51 |     override init(frame: CGRect) {
52 |         fatalError("Use init(with mainView:)")
53 |     }
54 |     
55 |     @available(*, unavailable)
56 |     required init?(coder aDecoder: NSCoder) {
57 |         fatalError("Use init(with mainView:)")
58 |     }
59 |     
60 |     private func initialize(with view: UIView) {
61 |         addSubview(verticalStack)
62 |         NSLayoutConstraint.activate([
63 |             verticalStack.leadingAnchor.constraint(equalTo: leadingAnchor),
64 |             verticalStack.topAnchor.constraint(equalTo: topAnchor),
65 |             verticalStack.trailingAnchor.constraint(equalTo: trailingAnchor),
66 |             verticalStack.bottomAnchor.constraint(equalTo: bottomAnchor)
67 |             ])
68 |         
69 |         verticalStack.addArrangedSubview(horizontalStack)
70 |         horizontalStack.addArrangedSubview(view)
71 |     }
72 |     
73 |     // MARK: Layout
74 |     
75 |     func addTopSubview(_ view: UIView) {
76 |         verticalStack.insertArrangedSubview(view, at: 0)
77 |     }
78 |     
79 |     func addBottomSubview(_ view: UIView) {
80 |         verticalStack.addArrangedSubview(view)
81 |     }
82 |     
83 |     func addLeadingSubview(_ view: UIView) {
84 |         horizontalStack.insertArrangedSubview(view, at: 0)
85 |     }
86 |     
87 |     func addTrailingSubview(_ view: UIView) {
88 |         horizontalStack.addArrangedSubview(view)
89 |     }
90 | }
91 | 


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/InsetCalculator/InsetCalculator.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  InsetCalculator.swift
 3 | //  AutoInsetter
 4 | //
 5 | //  Created by Merrick Sapsford on 16/03/2019.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal protocol InsetCalculator: AnyObject {
12 |     
13 |     func calculateContentInset(from spec: AutoInsetSpec, store: InsetStore) -> ContentInsetCalculation?
14 | 
15 |     func calculateContentOffset(from insetCalculation: ContentInsetCalculation, store: InsetStore) -> ContentOffsetCalculation?
16 |     
17 |     func calculateScrollIndicatorInsets(from spec: AutoInsetSpec) -> UIEdgeInsets?
18 | }
19 | 
20 | internal class ViewInsetCalculator<InsetView: UIScrollView>: InsetCalculator {
21 |     
22 |     let view: InsetView
23 |     let viewController: UIViewController
24 |     
25 |     init(view: InsetView, viewController: UIViewController) {
26 |         self.view = view
27 |         self.viewController = viewController
28 |         
29 |         viewController.view.layoutIfNeeded()
30 |     }
31 |     
32 |     func calculateContentInset(from spec: AutoInsetSpec, store: InsetStore) -> ContentInsetCalculation? {
33 |         assert(false, "Override in subclass")
34 |         return nil
35 |     }
36 |     
37 |     func calculateContentOffset(from insetCalculation: ContentInsetCalculation, store: InsetStore) -> ContentOffsetCalculation? {
38 |         assert(false, "Override in subclass")
39 |         return nil
40 |     }
41 |     
42 |     func calculateScrollIndicatorInsets(from spec: AutoInsetSpec) -> UIEdgeInsets? {
43 |         assert(false, "Override in subclass")
44 |         return nil
45 |     }
46 |     
47 |     // MARK: Utility
48 |     
49 |     func applyCustomContentInset(to contentInset: UIEdgeInsets, from previous: UIEdgeInsets?) -> UIEdgeInsets {
50 |         let previous = previous ?? .zero
51 |         var contentInset = contentInset
52 |         
53 |         // Take into account any custom insets
54 |         if view.contentInset.top != 0.0 {
55 |             contentInset.top += view.contentInset.top - previous.top
56 |         }
57 |         if view.contentInset.left != 0.0 {
58 |             contentInset.left += view.contentInset.left - previous.left
59 |         }
60 |         if view.contentInset.bottom != 0.0 {
61 |             contentInset.bottom += view.contentInset.bottom - previous.bottom
62 |         }
63 |         if  view.contentInset.right != 0.0 {
64 |             contentInset.right += view.contentInset.right - previous.right
65 |         }
66 |         
67 |         return contentInset
68 |     }
69 |     
70 |     /// Whether the view controller is a 'Scroll View UIViewController' - a.k.a a `UITableViewController` et al.
71 |     var isScrollViewController: Bool {
72 |         return (viewController is UITableViewController) || (viewController is UICollectionViewController)
73 |     }
74 | }
75 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarView/TMBarViewContentInsetGuides.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBarViewContentInsetGuides.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 01/08/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Content Inset guides for a bar view.
12 | ///
13 | /// Contains layout guides for content views taking any contentInset into account.
14 | internal final class TMBarViewContentInsetGuides: TMBarLayoutInsetGuides {
15 |     
16 |     // MARK: Properties
17 |     
18 |     /// Layout Guide for the leading inset on the bar.
19 |     public let leadingInset: UILayoutGuide = {
20 |         let guide = UILayoutGuide()
21 |         guide.identifier = "barInsetsLeadingGuide"
22 |         return guide
23 |     }()
24 |     private let leadingWidth: NSLayoutConstraint
25 |     
26 |     /// Layout Guide for the trailing inset on the bar.
27 |     public let trailingInset: UILayoutGuide = {
28 |         let guide = UILayoutGuide()
29 |         guide.identifier = "barInsetsTrailingGuide"
30 |         return guide
31 |     }()
32 |     private let trailingWidth: NSLayoutConstraint
33 |     
34 |     /// Layout Guide for the content (middle) inside the two insets on the bar.
35 |     public let content: UILayoutGuide = {
36 |         let guide = UILayoutGuide()
37 |         guide.identifier = "barInsetsContentGuide"
38 |         return guide
39 |     }()
40 |     
41 |     /// The content inset currently applied to the bar.
42 |     internal var insets: UIEdgeInsets = .zero {
43 |         didSet {
44 |             leadingWidth.constant = insets.left
45 |             trailingWidth.constant = insets.right
46 |         }
47 |     }
48 |     
49 |     // MARK: Init
50 |     
51 |     init<Layout, Button, Indicator>(for barView: TMBarView<Layout, Button, Indicator>) {
52 |         barView.addLayoutGuide(leadingInset)
53 |         barView.addLayoutGuide(content)
54 |         barView.addLayoutGuide(trailingInset)
55 |         
56 |         leadingWidth = leadingInset.widthAnchor.constraint(equalToConstant: insets.left)
57 |         trailingWidth = trailingInset.widthAnchor.constraint(equalToConstant: insets.right)
58 |         
59 |         NSLayoutConstraint.activate([
60 |             leadingInset.leadingAnchor.constraint(equalTo: barView.safeAreaLeadingAnchor),
61 |             leadingInset.topAnchor.constraint(equalTo: barView.topAnchor),
62 |             content.leadingAnchor.constraint(equalTo: leadingInset.trailingAnchor),
63 |             content.topAnchor.constraint(equalTo: barView.topAnchor),
64 |             content.trailingAnchor.constraint(equalTo: trailingInset.leadingAnchor),
65 |             trailingInset.trailingAnchor.constraint(equalTo: barView.safeAreaTrailingAnchor),
66 |             trailingInset.topAnchor.constraint(equalTo: barView.topAnchor),
67 |             leadingWidth,
68 |             trailingWidth
69 |         ])
70 |     }
71 | }
72 | 


--------------------------------------------------------------------------------
/Sources/iOS/Assets.xcassets/AppIcon.appiconset/Contents.json:
--------------------------------------------------------------------------------
  1 | {
  2 |   "images" : [
  3 |     {
  4 |       "filename" : "Icon-20@2x.png",
  5 |       "idiom" : "iphone",
  6 |       "scale" : "2x",
  7 |       "size" : "20x20"
  8 |     },
  9 |     {
 10 |       "filename" : "Icon-20@3x.png",
 11 |       "idiom" : "iphone",
 12 |       "scale" : "3x",
 13 |       "size" : "20x20"
 14 |     },
 15 |     {
 16 |       "filename" : "Icon-29@2x.png",
 17 |       "idiom" : "iphone",
 18 |       "scale" : "2x",
 19 |       "size" : "29x29"
 20 |     },
 21 |     {
 22 |       "filename" : "Icon-29@3x.png",
 23 |       "idiom" : "iphone",
 24 |       "scale" : "3x",
 25 |       "size" : "29x29"
 26 |     },
 27 |     {
 28 |       "filename" : "Icon-40@2x.png",
 29 |       "idiom" : "iphone",
 30 |       "scale" : "2x",
 31 |       "size" : "40x40"
 32 |     },
 33 |     {
 34 |       "filename" : "Icon-40@3x.png",
 35 |       "idiom" : "iphone",
 36 |       "scale" : "3x",
 37 |       "size" : "40x40"
 38 |     },
 39 |     {
 40 |       "filename" : "Icon-60@2x.png",
 41 |       "idiom" : "iphone",
 42 |       "scale" : "2x",
 43 |       "size" : "60x60"
 44 |     },
 45 |     {
 46 |       "filename" : "Icon-60@3x.png",
 47 |       "idiom" : "iphone",
 48 |       "scale" : "3x",
 49 |       "size" : "60x60"
 50 |     },
 51 |     {
 52 |       "filename" : "Icon-20.png",
 53 |       "idiom" : "ipad",
 54 |       "scale" : "1x",
 55 |       "size" : "20x20"
 56 |     },
 57 |     {
 58 |       "filename" : "Icon-20@2x.png",
 59 |       "idiom" : "ipad",
 60 |       "scale" : "2x",
 61 |       "size" : "20x20"
 62 |     },
 63 |     {
 64 |       "filename" : "Icon-29.png",
 65 |       "idiom" : "ipad",
 66 |       "scale" : "1x",
 67 |       "size" : "29x29"
 68 |     },
 69 |     {
 70 |       "filename" : "Icon-29@2x.png",
 71 |       "idiom" : "ipad",
 72 |       "scale" : "2x",
 73 |       "size" : "29x29"
 74 |     },
 75 |     {
 76 |       "filename" : "Icon-40.png",
 77 |       "idiom" : "ipad",
 78 |       "scale" : "1x",
 79 |       "size" : "40x40"
 80 |     },
 81 |     {
 82 |       "filename" : "Icon-40@2x.png",
 83 |       "idiom" : "ipad",
 84 |       "scale" : "2x",
 85 |       "size" : "40x40"
 86 |     },
 87 |     {
 88 |       "filename" : "Icon-76.png",
 89 |       "idiom" : "ipad",
 90 |       "scale" : "1x",
 91 |       "size" : "76x76"
 92 |     },
 93 |     {
 94 |       "filename" : "Icon-76@2x.png",
 95 |       "idiom" : "ipad",
 96 |       "scale" : "2x",
 97 |       "size" : "76x76"
 98 |     },
 99 |     {
100 |       "filename" : "Icon-83.5@2x.png",
101 |       "idiom" : "ipad",
102 |       "scale" : "2x",
103 |       "size" : "83.5x83.5"
104 |     },
105 |     {
106 |       "filename" : "Icon-1024.png",
107 |       "idiom" : "ios-marketing",
108 |       "scale" : "1x",
109 |       "size" : "1024x1024"
110 |     }
111 |   ],
112 |   "info" : {
113 |     "author" : "xcode",
114 |     "version" : 1
115 |   }
116 | }
117 | 


--------------------------------------------------------------------------------
/Docs/jazzy-theme/templates/task.mustache:
--------------------------------------------------------------------------------
 1 | <div class="task-group">
 2 |   {{#name}}
 3 |   <div class="task-name-container">
 4 |     <a name="/{{uid}}"></a>
 5 |     <a name="//apple_ref/{{language_stub}}/Section/{{name}}" class="dashAnchor"></a>
 6 |     <a href="#/{{uid}}">
 7 |       <h3 class="section-name">{{name}}</h3>
 8 |     </a>
 9 |   </div>
10 |   {{/name}}
11 |   <ul class='item-container'>
12 |     {{#items}}
13 |     <li class="item">
14 |       <div class="item-heading">
15 |         <code>
16 |         <a name="/{{usr}}"></a>
17 |         <a name="//apple_ref/{{language_stub}}/{{dash_type}}/{{name}}" class="dashAnchor"></a>
18 |         <a class="token" href="#/{{usr}}">{{name}}</a>
19 |         </code>
20 |         {{#default_impl_abstract}}
21 |           <span class="declaration-note">
22 |             Default implementation
23 |           </span>
24 |         {{/default_impl_abstract}}
25 |         {{#from_protocol_extension}}
26 |           <span class="declaration-note">
27 |             Extension method
28 |           </span>
29 |         {{/from_protocol_extension}}
30 |       </div>
31 |       <div class="height-container">
32 |         <div class="pointer-container"></div>
33 |         <section class="section">
34 |           <div class="pointer"></div>
35 |           {{#abstract}}
36 |           <div class="abstract">
37 |             {{{abstract}}}
38 |           </div>
39 |           {{/abstract}}
40 |           {{#default_impl_abstract}}
41 |           <h5>Default Implementation</h5>
42 |           <div class="default_impl abstract">
43 |             {{{default_impl_abstract}}}
44 |           </div>
45 |           {{/default_impl_abstract}}
46 |           {{#declaration}}
47 |           <div class="declaration">
48 |             <h5>Declaration</h5>
49 |             <div class="language">
50 |               <p class="aside-title">{{language}}</p>
51 |               {{{declaration}}}
52 |             </div>
53 |           </div>
54 |           {{/declaration}}
55 |           {{#parameters.count}}
56 |           <div>
57 |             <h5>Parameters</h5>
58 |             <table class="graybox">
59 |               <tbody>
60 |                 {{#parameters}}
61 |                 {{> parameter}}
62 |                 {{/parameters}}
63 |               </tbody>
64 |             </table>
65 |           </div>
66 |           {{/parameters.count}}
67 |           {{#return}}
68 |           <div>
69 |             <h5>Return Value</h5>
70 |             {{{return}}}
71 |           </div>
72 |           {{/return}}
73 |           <div class="slightly-smaller">
74 |             {{#abstract}}{{#url}}
75 |               <a href="{{{path_to_root}}}{{{url}}}" class="button">See more</a>
76 |             {{/url}}{{/abstract}}
77 |             {{#github_token_url}}
78 |               <a href="{{{github_token_url}}}" class="button">Show on GitHub</a>
79 |             {{/github_token_url}}
80 |           </div>
81 |         </section>
82 |       </div>
83 |     </li>
84 |     {{/items}}
85 |   </ul>
86 | </div>
87 | 


--------------------------------------------------------------------------------
/Sources/iOS/ButtonBarExampleViewController.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  ButtonBarExampleViewController.swift
 3 | //  Example
 4 | //
 5 | //  Created by Merrick Sapsford on 04/10/2020.
 6 | //
 7 | 
 8 | import UIKit
 9 | import Tabman
10 | import Pageboy
11 | 
12 | class ButtonBarExampleViewController: TabmanViewController, PageboyViewControllerDataSource, TMBarDataSource {
13 | 
14 |     // MARK: Properties
15 |     
16 |     /// View controllers that will be displayed in page view controller.
17 |     private lazy var viewControllers: [UIViewController] = [
18 |         ChildViewController(page: 1),
19 |         ChildViewController(page: 2),
20 |         ChildViewController(page: 3),
21 |         ChildViewController(page: 4),
22 |         ChildViewController(page: 5)
23 |     ]
24 |     
25 |     // MARK: Lifecycle
26 |     
27 |     override func viewDidLoad() {
28 |         super.viewDidLoad()
29 |         
30 |         // Set PageboyViewControllerDataSource dataSource to configure page view controller.
31 |         dataSource = self
32 |         
33 |         // Create a bar
34 |         let bar = TMBarView.ButtonBar()
35 |         
36 |         // Customize bar properties including layout and other styling.
37 |         bar.layout.contentInset = UIEdgeInsets(top: 0.0, left: 16.0, bottom: 4.0, right: 16.0)
38 |         bar.layout.interButtonSpacing = 24.0
39 |         bar.indicator.weight = .light
40 |         bar.indicator.cornerStyle = .eliptical
41 |         bar.fadesContentEdges = true
42 |         bar.spacing = 16.0
43 |         
44 |         // Set tint colors for the bar buttons and indicator.
45 |         bar.buttons.customize {
46 |             $0.tintColor = UIColor.tabmanForeground.withAlphaComponent(0.4)
47 |             $0.selectedTintColor = .tabmanForeground
48 |             $0.adjustsFontForContentSizeCategory = true
49 |         }
50 |         bar.indicator.tintColor = .tabmanForeground
51 |         
52 |         // Add bar to the view - as a .systemBar() to add UIKit style system background views.
53 |         addBar(bar.systemBar(), dataSource: self, at: .top)
54 |     }
55 | 
56 |     // MARK: PageboyViewControllerDataSource
57 |     
58 |     func numberOfViewControllers(in pageboyViewController: PageboyViewController) -> Int {
59 |         viewControllers.count // How many view controllers to display in the page view controller.
60 |     }
61 |     
62 |     func viewController(for pageboyViewController: PageboyViewController, at index: PageboyViewController.PageIndex) -> UIViewController? {
63 |         viewControllers[index] // View controller to display at a specific index for the page view controller.
64 |     }
65 |     
66 |     func defaultPage(for pageboyViewController: PageboyViewController) -> PageboyViewController.Page? {
67 |         nil // Default page to display in the page view controller (nil equals default/first index).
68 |     }
69 |     
70 |     // MARK: TMBarDataSource
71 |     
72 |     func barItem(for bar: TMBar, at index: Int) -> TMBarItemable {
73 |         return TMBarItem(title: "Page No. \(index + 1)") // Item to display for a specific index in the bar.
74 |     }
75 | }
76 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/Extensions/UIColor+Interpolation.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  ColorUtils.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 22/02/2017.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal extension UIColor {
12 |     
13 |     func interpolate(with other: UIColor, percent: CGFloat) -> UIColor? {
14 |         return UIColor.interpolate(betweenColor: self, and: other, percent: percent)
15 |     }
16 |     
17 |     static func interpolate(betweenColor colorA: UIColor,
18 |                             and colorB: UIColor,
19 |                             percent: CGFloat) -> UIColor? {
20 |         if #available(iOS 13, *) {
21 |             return UIColor(dynamicProvider: { traitCollection in
22 |                 var redA: CGFloat = 0.0
23 |                 var greenA: CGFloat = 0.0
24 |                 var blueA: CGFloat = 0.0
25 |                 var alphaA: CGFloat = 0.0
26 |                 
27 |                 var redB: CGFloat = 0.0
28 |                 var greenB: CGFloat = 0.0
29 |                 var blueB: CGFloat = 0.0
30 |                 var alphaB: CGFloat = 0.0
31 |                 
32 |                 traitCollection.performAsCurrent {
33 |                     guard colorA.getRed(&redA, green: &greenA, blue: &blueA, alpha: &alphaA) else {
34 |                         return
35 |                     }
36 |                     guard colorB.getRed(&redB, green: &greenB, blue: &blueB, alpha: &alphaB) else {
37 |                         return
38 |                     }
39 |                 }
40 |                 
41 |                 let iRed = CGFloat(redA + percent * (redB - redA))
42 |                 let iBlue = CGFloat(blueA + percent * (blueB - blueA))
43 |                 let iGreen = CGFloat(greenA + percent * (greenB - greenA))
44 |                 let iAlpha = CGFloat(alphaA + percent * (alphaB - alphaA))
45 |                 
46 |                 return UIColor(red: iRed, green: iGreen, blue: iBlue, alpha: iAlpha)
47 |             })
48 |         } else {
49 |             var redA: CGFloat = 0.0
50 |             var greenA: CGFloat = 0.0
51 |             var blueA: CGFloat = 0.0
52 |             var alphaA: CGFloat = 0.0
53 |             guard colorA.getRed(&redA, green: &greenA, blue: &blueA, alpha: &alphaA) else {
54 |                 return nil
55 |             }
56 |             
57 |             var redB: CGFloat = 0.0
58 |             var greenB: CGFloat = 0.0
59 |             var blueB: CGFloat = 0.0
60 |             var alphaB: CGFloat = 0.0
61 |             guard colorB.getRed(&redB, green: &greenB, blue: &blueB, alpha: &alphaB) else {
62 |                 return nil
63 |             }
64 |             
65 |             let iRed = CGFloat(redA + percent * (redB - redA))
66 |             let iBlue = CGFloat(blueA + percent * (blueB - blueA))
67 |             let iGreen = CGFloat(greenA + percent * (greenB - greenA))
68 |             let iAlpha = CGFloat(alphaA + percent * (alphaB - alphaA))
69 |             
70 |             return UIColor(red: iRed, green: iGreen, blue: iBlue, alpha: iAlpha)
71 |         }
72 |     }
73 | }
74 | 


--------------------------------------------------------------------------------
/Docs/Troubleshooting.md:
--------------------------------------------------------------------------------
 1 | # Troubleshooting
 2 | 
 3 | If you are having trouble using Tabman, please check out this document to see if you can resolve any problems that you're having. If not please raise an [issue](https://github.com/uias/Tabman/issues/new).
 4 | 
 5 | ## Contents
 6 | - [Automatic Insetting](#automatic-insetting)
 7 | 
 8 | ## Automatic Insetting
 9 | Tabman is designed to automatically inset the contents of child view controllers that contain `UIScrollView` and other derived classes so that it shows correctly beneath the bar:
10 | 
11 | <p align="center">
12 |     </br>
13 |     <img src="./img/autoinsetting.png" width="375" alt="Auto Insetting"/>
14 |     </br>
15 | </p>
16 | 
17 | If you are having issues with Automatic Insetting, please try the following steps...
18 | 
19 | ### 0) Make sure you're up to date
20 | Ensure you're using the latest release of [**Tabman**](https://github.com/uias/Tabman/releases/latest).
21 | 
22 | ### 1) Ensure it's turned on
23 | Make sure that auto insetting is enabled (it is by default).
24 | ```swift
25 | .automaticallyAdjustsChildInsets = true
26 | ```
27 | 
28 | ### 2) Check your constraints
29 | If you are using a custom view controller (and not something like a `UITableViewController`), the way that your content scroll view is constrained to the superview is very important.
30 | 
31 | It is recommended that your `UIScrollView` is constrained directly to the superview, as shown below:
32 | 
33 | <p align="center">
34 |     <img src="./img/autoinsetting_constraints.png" width="890" alt="Auto Insetting"/>
35 | </p>
36 | 
37 | As you can see, the constraints for the `UITableView` are pinned to the superview rather than the `topLayoutGuide` or `Safe Area`.
38 | 
39 | <p align="center">
40 |     <img src="./img/autoinsetting_constraints_detail.png" width="262" alt="Auto Insetting Constraints"/>
41 | </p>
42 | 
43 | ### 3) Watch out for UIKit
44 | Tabman will also handle any `UIKit` properties that require modifying in order to get a reliable insetting behaviour. As we're providing a completely custom implementation, we disable a lot of the `UIKit` helper properties that would otherwise inset content correctly for system components such as a `UITabBar`.
45 | 
46 | Therefore, you shouldn't need to modify or have any of the following in your view controller code:
47 | ```swift
48 | UIScrollView.contentInsetAdjustmentBehavior
49 | UIViewController.automaticallyAdjustsScrollViewInsets
50 | ```
51 | 
52 | Modifying these properties will more than likely cause issues with the auto insetting engine, so it is advised to remove any usages from your code.
53 | 
54 | ### 4) Everything *should* be okay
55 | By this point, you should have a beautifully insetted table view in your child view controller, otherwise 😭.
56 | 
57 | **Next steps:**
58 | 1. It might be useful to use the numbers provided by `bar.requiredInsets` to manually inset your content. Depending on how successful this is will help with debugging.
59 | 2. Raise an [issue](https://github.com/uias/Tabman/issues/new), and provide as much detail as you can about your layout and just what is going wrong.
60 | 3. We'll get on with fixing it as soon as possible 🤞.
61 | 


--------------------------------------------------------------------------------
/Sources/TabmanTests/TabmanViewControllerTests.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TabmanViewControllerTests.swift
 3 | //  TabmanTests
 4 | //
 5 | //  Created by Merrick Sapsford on 01/09/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import XCTest
10 | import UIKit
11 | @testable import Tabman
12 | import Pageboy
13 | 
14 | class TabmanViewControllerTests: XCTestCase {
15 |     
16 |     var viewController: TabmanViewController!
17 |     var barDataSource: TMBarDataSource!
18 |     
19 |     // MARK: Set Up
20 |     
21 |     override func setUp() {
22 |         super.setUp()
23 |         
24 |         self.viewController = MockTabmanViewController()
25 |         self.barDataSource = MockBarDataSource()
26 |         
27 |         viewController.view.frame = CGRect(x: 0.0, y: 0.0,
28 |                                            width: 375,
29 |                                            height: 667)
30 |         viewController.view.layoutIfNeeded()
31 |     }
32 |     
33 |     override func tearDown() {
34 |         super.tearDown()
35 |         
36 |         self.viewController = nil
37 |         self.barDataSource = nil
38 |     }
39 |     
40 |     // MARK: Tests
41 |     
42 |     /// Test that bar can be added to view controller.
43 |     func testAddBar() {
44 |         
45 |         let bar = MockBarView()
46 |         viewController.addBar(bar,
47 |                               dataSource: barDataSource,
48 |                               at: .top)
49 |         XCTAssertNotNil(bar.superview)
50 |     }
51 |     
52 |     /// Test that bar added to .top location is at top of view controller.
53 |     func testAddBarToTop() {
54 |         
55 |         let bar = MockBarView()
56 |         viewController.addBar(bar,
57 |                               dataSource: barDataSource,
58 |                               at: .top)
59 |         
60 |         let frame = viewController.view.convert(bar.frame,
61 |                                                 from: bar.superview)
62 |         XCTAssert(frame.origin.y < viewController.view.frame.size.height / 2)
63 |     }
64 |     
65 |     /// Test that bar added to .bottom location is at bottom of view controller.
66 |     func testAddBarToBottom() {
67 |         
68 |         let bar = MockBarView()
69 |         viewController.addBar(bar,
70 |                               dataSource: barDataSource,
71 |                               at: .bottom)
72 |         
73 |         let frame = viewController.view.convert(bar.frame,
74 |                                                 from: bar.superview)
75 |         XCTAssert(frame.origin.y > viewController.view.frame.size.height / 2)
76 |     }
77 |     
78 |     /// Test that bar added to .custom location is in custom view.
79 |     func testAddBarToCustomView() {
80 |         
81 |         let customContainer = UIView()
82 |         
83 |         let bar = MockBarView()
84 |         viewController.addBar(bar,
85 |                               dataSource: barDataSource,
86 |                               at: .custom(view: customContainer, layout: nil))
87 |         
88 |         XCTAssertTrue(customContainer.subviews.first === bar)
89 |     }
90 | }
91 | 


--------------------------------------------------------------------------------
/Sources/Examples.xcodeproj/xcshareddata/xcschemes/Example iOS.xcscheme:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <Scheme
 3 |    LastUpgradeVersion = "1530"
 4 |    version = "1.3">
 5 |    <BuildAction
 6 |       parallelizeBuildables = "YES"
 7 |       buildImplicitDependencies = "YES">
 8 |       <BuildActionEntries>
 9 |          <BuildActionEntry
10 |             buildForTesting = "YES"
11 |             buildForRunning = "YES"
12 |             buildForProfiling = "YES"
13 |             buildForArchiving = "YES"
14 |             buildForAnalyzing = "YES">
15 |             <BuildableReference
16 |                BuildableIdentifier = "primary"
17 |                BlueprintIdentifier = "46B4875E2529C556007CCFF2"
18 |                BuildableName = "Example iOS.app"
19 |                BlueprintName = "Example iOS"
20 |                ReferencedContainer = "container:Examples.xcodeproj">
21 |             </BuildableReference>
22 |          </BuildActionEntry>
23 |       </BuildActionEntries>
24 |    </BuildAction>
25 |    <TestAction
26 |       buildConfiguration = "Debug"
27 |       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
28 |       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
29 |       shouldUseLaunchSchemeArgsEnv = "YES">
30 |       <Testables>
31 |       </Testables>
32 |    </TestAction>
33 |    <LaunchAction
34 |       buildConfiguration = "Debug"
35 |       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
36 |       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
37 |       launchStyle = "0"
38 |       useCustomWorkingDirectory = "NO"
39 |       ignoresPersistentStateOnLaunch = "NO"
40 |       debugDocumentVersioning = "YES"
41 |       debugServiceExtension = "internal"
42 |       allowLocationSimulation = "YES">
43 |       <BuildableProductRunnable
44 |          runnableDebuggingMode = "0">
45 |          <BuildableReference
46 |             BuildableIdentifier = "primary"
47 |             BlueprintIdentifier = "46B4875E2529C556007CCFF2"
48 |             BuildableName = "Example iOS.app"
49 |             BlueprintName = "Example iOS"
50 |             ReferencedContainer = "container:Examples.xcodeproj">
51 |          </BuildableReference>
52 |       </BuildableProductRunnable>
53 |    </LaunchAction>
54 |    <ProfileAction
55 |       buildConfiguration = "Release"
56 |       shouldUseLaunchSchemeArgsEnv = "YES"
57 |       savedToolIdentifier = ""
58 |       useCustomWorkingDirectory = "NO"
59 |       debugDocumentVersioning = "YES">
60 |       <BuildableProductRunnable
61 |          runnableDebuggingMode = "0">
62 |          <BuildableReference
63 |             BuildableIdentifier = "primary"
64 |             BlueprintIdentifier = "46B4875E2529C556007CCFF2"
65 |             BuildableName = "Example iOS.app"
66 |             BlueprintName = "Example iOS"
67 |             ReferencedContainer = "container:Examples.xcodeproj">
68 |          </BuildableReference>
69 |       </BuildableProductRunnable>
70 |    </ProfileAction>
71 |    <AnalyzeAction
72 |       buildConfiguration = "Debug">
73 |    </AnalyzeAction>
74 |    <ArchiveAction
75 |       buildConfiguration = "Release"
76 |       revealArchiveInOrganizer = "YES">
77 |    </ArchiveAction>
78 | </Scheme>
79 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/Generic/GestureScrollView.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  GestureScrollView.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 25/10/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | protocol GestureScrollViewGestureDelegate: AnyObject {
12 |     
13 |     func scrollView(_ scrollView: GestureScrollView,
14 |                     didReceiveSwipeTo direction: UISwipeGestureRecognizer.Direction)
15 | }
16 | 
17 | /// Scroll view which provides enhanced scroll modes via gestures.
18 | internal final class GestureScrollView: UIScrollView {
19 |     
20 |     // MARK: Types
21 |     
22 |     enum ScrollMode: Int {
23 |         case interactive
24 |         case swipe
25 |         case none
26 |     }
27 |     
28 |     // MARK: Properties
29 |     
30 |     @available(*, unavailable)
31 |     override var isScrollEnabled: Bool {
32 |         didSet {}
33 |     }
34 |     var scrollMode: ScrollMode = .interactive {
35 |         didSet {
36 |             guard scrollMode != oldValue else {
37 |                 return
38 |             }
39 |             update(for: scrollMode)
40 |         }
41 |     }
42 |     
43 |     weak var gestureDelegate: GestureScrollViewGestureDelegate?
44 |     
45 |     private var negativeSwipeRecognizer: UIGestureRecognizer?
46 |     private var positiveSwipeRecognizer: UIGestureRecognizer?
47 | 
48 |     // MARK: Updates
49 |     
50 |     private func update(for scrollMode: ScrollMode) {
51 |         switch scrollMode {
52 |         case .interactive:
53 |             super.isScrollEnabled = true
54 |             removeSwipeGestureRecognizers()
55 |         case .swipe:
56 |             super.isScrollEnabled = false
57 |             addSwipeGestureRecognizers()
58 |         case .none:
59 |             super.isScrollEnabled = false
60 |             removeSwipeGestureRecognizers()
61 |         }
62 |     }
63 | }
64 | 
65 | // MARK: - Gestures
66 | private extension GestureScrollView {
67 |     
68 |     func addSwipeGestureRecognizers() {
69 |         
70 |         let negativeDirection: UISwipeGestureRecognizer.Direction = .left
71 |         let positiveDirection: UISwipeGestureRecognizer.Direction = .right
72 |         
73 |         let negativeSwipeRecognizer = UISwipeGestureRecognizer(target: self, action: #selector(didSwipe(_:)))
74 |         negativeSwipeRecognizer.direction = negativeDirection
75 |         addGestureRecognizer(negativeSwipeRecognizer)
76 |         self.negativeSwipeRecognizer = negativeSwipeRecognizer
77 |         
78 |         let positiveSwipeRecognizer = UISwipeGestureRecognizer(target: self, action: #selector(didSwipe(_:)))
79 |         positiveSwipeRecognizer.direction = positiveDirection
80 |         addGestureRecognizer(positiveSwipeRecognizer)
81 |         self.positiveSwipeRecognizer = positiveSwipeRecognizer
82 |     }
83 |     
84 |     func removeSwipeGestureRecognizers() {
85 |         if let negativeSwipeRecognizer = negativeSwipeRecognizer {
86 |             removeGestureRecognizer(negativeSwipeRecognizer)
87 |         }
88 |         if let positiveSwipeRecognizer = positiveSwipeRecognizer {
89 |             removeGestureRecognizer(positiveSwipeRecognizer)
90 |         }
91 |     }
92 |     
93 |     @objc func didSwipe(_ recognizer: UISwipeGestureRecognizer) {
94 |         gestureDelegate?.scrollView(self, didReceiveSwipeTo: recognizer.direction)
95 |     }
96 | }
97 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarBackgroundView/TMBarBackgroundView.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  TMBarBackgroundView.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 29/08/2018.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | 
 11 | /// A view that displays a specified background style.
 12 | open class TMBarBackgroundView: UIView {
 13 |     
 14 |     /// Style of background.
 15 |     ///
 16 |     /// - clear: No visible background.
 17 |     /// - flat: A flat color background.
 18 |     /// - blur: A blurred background with a defined style.
 19 |     /// - custom: A custom view to use as the background.
 20 |     public enum Style {
 21 |         case clear
 22 |         case flat(color: UIColor)
 23 |         case blur(style: UIBlurEffect.Style)
 24 |         case custom(view: UIView)
 25 |     }
 26 |     
 27 |     // MARK: Properties
 28 | 
 29 |     /**
 30 |      Style of the visible background.
 31 |      
 32 |      Options: `.clear`, `.flat`, `.blur`, `.custom`.
 33 |     **/
 34 |     open var style: Style {
 35 |         didSet {
 36 |             update(for: style)
 37 |         }
 38 |     }
 39 |     
 40 |     @available(*, unavailable)
 41 |     open override var backgroundColor: UIColor? {
 42 |         didSet {
 43 |         }
 44 |     }
 45 |     
 46 |     private var backgroundView: UIView?
 47 |     
 48 |     // MARK: Init
 49 |     
 50 |     public init(style: Style = .clear) {
 51 |         self.style = style
 52 |         super.init(frame: .zero)
 53 |         
 54 |         isUserInteractionEnabled = false
 55 |         super.backgroundColor = .clear
 56 |         
 57 |         update(for: style)
 58 |     }
 59 |     
 60 |     @available(*, unavailable)
 61 |     public required init?(coder aDecoder: NSCoder) {
 62 |         fatalError("Use init(style:)")
 63 |     }
 64 | }
 65 | 
 66 | private extension TMBarBackgroundView {
 67 |     
 68 |     func update(for style: Style) {
 69 |         cleanUp(backgroundView: backgroundView)
 70 |         
 71 |         guard let backgroundView = view(for: style) else {
 72 |             return
 73 |         }
 74 |         self.backgroundView = backgroundView
 75 |         addSubview(backgroundView)
 76 |         backgroundView.translatesAutoresizingMaskIntoConstraints = false
 77 |         NSLayoutConstraint.activate([
 78 |             backgroundView.leadingAnchor.constraint(equalTo: leadingAnchor),
 79 |             backgroundView.topAnchor.constraint(equalTo: topAnchor),
 80 |             backgroundView.trailingAnchor.constraint(equalTo: trailingAnchor),
 81 |             backgroundView.bottomAnchor.constraint(equalTo: bottomAnchor)
 82 |             ])
 83 |     }
 84 |     
 85 |     func view(for style: Style) -> UIView? {
 86 |         switch style {
 87 |         case .flat(let color):
 88 |             let view = UIView()
 89 |             view.backgroundColor = color
 90 |             return view
 91 |         case .blur(let style):
 92 |             let effect = UIBlurEffect(style: style)
 93 |             return UIVisualEffectView(effect: effect)
 94 |         case .custom(let view):
 95 |             if view.superview !== nil {
 96 |                 view.removeFromSuperview()
 97 |             }
 98 |             return view
 99 |         default:
100 |             return nil
101 |         }
102 |     }
103 |     
104 |     func cleanUp(backgroundView: UIView?) {
105 |         backgroundView?.removeFromSuperview()
106 |     }
107 | }
108 | 


--------------------------------------------------------------------------------
/Sources/iOS/TabItemBarExampleViewController.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TabItemBarExampleViewController.swift
 3 | //  Example iOS
 4 | //
 5 | //  Created by Divyesh Makwana on 6/25/21.
 6 | //
 7 | 
 8 | import UIKit
 9 | import Tabman
10 | import Pageboy
11 | 
12 | class TabItemBarExampleViewController: TabmanViewController, PageboyViewControllerDataSource, TMBarDataSource {
13 | 
14 |     // MARK: Properties
15 |     
16 |     /// View controllers that will be displayed in page view controller.
17 |     private lazy var viewControllers: [UIViewController] = [
18 |         ChildViewController(page: 1),
19 |         ChildViewController(page: 2),
20 |         ChildViewController(page: 3),
21 |         ChildViewController(page: 4),
22 |         ChildViewController(page: 5)
23 |     ]
24 |     
25 |     // MARK: Lifecycle
26 |     
27 |     override func viewDidLoad() {
28 |         super.viewDidLoad()
29 |         
30 |         // Set PageboyViewControllerDataSource dataSource to configure page view controller.
31 |         dataSource = self
32 |         
33 |         // Create a bar
34 |         let bar = TMBarView<TMConstrainedHorizontalBarLayout, TMTabItemBarButton, TMBarIndicator.None>()
35 |         
36 |         // Customize bar properties including layout and other styling.
37 |         bar.layout.contentInset = UIEdgeInsets(top: 0.0, left: 8.0, bottom: 4.0, right: 8.0)
38 |         bar.spacing = 16.0
39 |         
40 |         // Set tint colors for the bar buttons and indicator.
41 |         bar.buttons.customize {
42 |             $0.tintColor = UIColor.tabmanForeground.withAlphaComponent(0.4)
43 |             $0.selectedTintColor = .tabmanForeground
44 |             $0.adjustsFontForContentSizeCategory = true
45 |         }
46 |         bar.indicator.tintColor = .tabmanForeground
47 |         
48 |         // Add bar to the view - as a .systemBar() to add UIKit style system background views.
49 |         addBar(bar.systemBar(), dataSource: self, at: .top)
50 |     }
51 | 
52 |     // MARK: PageboyViewControllerDataSource
53 |     
54 |     func numberOfViewControllers(in pageboyViewController: PageboyViewController) -> Int {
55 |         viewControllers.count // How many view controllers to display in the page view controller.
56 |     }
57 |     
58 |     func viewController(for pageboyViewController: PageboyViewController, at index: PageboyViewController.PageIndex) -> UIViewController? {
59 |         viewControllers[index] // View controller to display at a specific index for the page view controller.
60 |     }
61 |     
62 |     func defaultPage(for pageboyViewController: PageboyViewController) -> PageboyViewController.Page? {
63 |         nil // Default page to display in the page view controller (nil equals default/first index).
64 |     }
65 |     
66 |     // MARK: TMBarDataSource
67 |     
68 |     func barItem(for bar: TMBar, at index: Int) -> TMBarItemable {
69 |         return TMBarItem(title: "Page No. \(index + 1)", image: UIImage.star ?? UIImage(), selectedImage: UIImage.starFilled ?? UIImage())
70 |     }
71 | }
72 | 
73 | 
74 | // MARK: - Star Image Extensions
75 | extension UIImage {
76 |     
77 |     class var star: UIImage? {
78 |         if #available(iOS 13, *) {
79 |             return UIImage(systemName: "star")
80 |         } else {
81 |             return nil
82 |         }
83 |     }
84 |     
85 |     class var starFilled: UIImage? {
86 |         if #available(iOS 13, *) {
87 |             return UIImage(systemName: "star.fill")
88 |         } else {
89 |             return nil
90 |         }
91 |     }
92 | }
93 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/TMBar.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMBar.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 28/05/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Data source to a `TMBar` that is primarily responsible for providing a bar with contents.
12 | public protocol TMBarDataSource: AnyObject {
13 |     
14 |     /// Provide a `BarItem` for an index in the bar.
15 |     ///
16 |     /// - Parameters:
17 |     ///   - bar: The bar.
18 |     ///   - index: Index of the item.
19 |     /// - Returns: The BarItem.
20 |     func barItem(for bar: TMBar, at index: Int) -> TMBarItemable
21 | }
22 | 
23 | /// Delegate to a `TMBar` that is primarily responsible for handling user interaction within the bar.
24 | public protocol TMBarDelegate: AnyObject {
25 |     
26 |     /// Bar requires scrolling to a new page following a user interaction.
27 |     ///
28 |     /// - Parameters:
29 |     ///   - bar: The bar.
30 |     ///   - index: The new index.
31 |     func bar(_ bar: TMBar,
32 |              didRequestScrollTo index: Int)
33 | }
34 | 
35 | /// Context for causing a reload of a bar.
36 | ///
37 | /// - full: A full reload has taken place.
38 | /// - insertion: A page insertion has taken place.
39 | /// - deletion: A page deletion has taken place.
40 | public enum TMBarReloadContext {
41 |     case full
42 |     case insertion
43 |     case deletion
44 | }
45 | 
46 | /// Semantic direction of an update to the bar.
47 | ///
48 | /// - none: No direction.
49 | /// - forward: A forward direction (increasing).
50 | /// - reverse: A reverse direction (reversing).
51 | public enum TMBarUpdateDirection {
52 |     case none
53 |     case forward
54 |     case reverse
55 | }
56 | 
57 | /// `BaseTMBar` is a base protocol of AnyObject to avoid Swift compiler error
58 | /// :nodoc:
59 | public protocol BaseTMBar: AnyObject { }
60 | 
61 | /// `TMBar` is a protocol that is constrained to `UIView` types. Conforming view types can be added to
62 | /// and displayed in a `TabmanViewController`.
63 | ///
64 | /// `TMBar` is expected to display a `TMBarItem` collection provided by a data source visually
65 | /// in some form, and also respond to the current page position.
66 | ///
67 | /// The default implementation of `TMBar` in Tabman is `TMBarView`.
68 | public protocol TMBar: BaseTMBar where Self: UIView {
69 |     
70 |     /// Object that acts as a data source to the bar.
71 |     var dataSource: TMBarDataSource? { get set }
72 |     /// Object that acts as a delegate to the bar.
73 |     var delegate: TMBarDelegate? { get set }
74 |     
75 |     /// Items that are currently displayed in the bar.
76 |     var items: [TMBarItemable]? { get }
77 |     
78 |     /// Reload the data within the bar.
79 |     ///
80 |     /// - Parameters:
81 |     ///   - indexes: The indexes to reload.
82 |     ///   - context: The context for the reload.
83 |     func reloadData(at indexes: ClosedRange<Int>,
84 |                     context: TMBarReloadContext)
85 |     
86 |     /// Update the display in the bar for a particular page position.
87 |     ///
88 |     /// - Parameters:
89 |     ///   - pagePosition: Position to display.
90 |     ///   - capacity: The capacity of the bar.
91 |     ///   - direction: Semantic direction of the update.
92 |     ///   - shouldAnimate: Whether the bar should animate the update.
93 |     func update(for position: CGFloat,
94 |                 capacity: Int,
95 |                 direction: TMBarUpdateDirection,
96 |                 animation: TMAnimation)
97 | }
98 | 


--------------------------------------------------------------------------------
/CODE_OF_CONDUCT.md:
--------------------------------------------------------------------------------
 1 | # Contributor Covenant Code of Conduct
 2 | 
 3 | ## Our Pledge
 4 | 
 5 | In the interest of fostering an open and welcoming environment, we as
 6 | contributors and maintainers pledge to making participation in our project and
 7 | our community a harassment-free experience for everyone, regardless of age, body
 8 | size, disability, ethnicity, gender identity and expression, level of experience,
 9 | nationality, personal appearance, race, religion, or sexual identity and
10 | orientation.
11 | 
12 | ## Our Standards
13 | 
14 | Examples of behavior that contributes to creating a positive environment
15 | include:
16 | 
17 | * Using welcoming and inclusive language
18 | * Being respectful of differing viewpoints and experiences
19 | * Gracefully accepting constructive criticism
20 | * Focusing on what is best for the community
21 | * Showing empathy towards other community members
22 | 
23 | Examples of unacceptable behavior by participants include:
24 | 
25 | * The use of sexualized language or imagery and unwelcome sexual attention or
26 | advances
27 | * Trolling, insulting/derogatory comments, and personal or political attacks
28 | * Public or private harassment
29 | * Publishing others' private information, such as a physical or electronic
30 |   address, without explicit permission
31 | * Other conduct which could reasonably be considered inappropriate in a
32 |   professional setting
33 | 
34 | ## Our Responsibilities
35 | 
36 | Project maintainers are responsible for clarifying the standards of acceptable
37 | behavior and are expected to take appropriate and fair corrective action in
38 | response to any instances of unacceptable behavior.
39 | 
40 | Project maintainers have the right and responsibility to remove, edit, or
41 | reject comments, commits, code, wiki edits, issues, and other contributions
42 | that are not aligned to this Code of Conduct, or to ban temporarily or
43 | permanently any contributor for other behaviors that they deem inappropriate,
44 | threatening, offensive, or harmful.
45 | 
46 | ## Scope
47 | 
48 | This Code of Conduct applies both within project spaces and in public spaces
49 | when an individual is representing the project or its community. Examples of
50 | representing a project or community include using an official project e-mail
51 | address, posting via an official social media account, or acting as an appointed
52 | representative at an online or offline event. Representation of a project may be
53 | further defined and clarified by project maintainers.
54 | 
55 | ## Enforcement
56 | 
57 | Instances of abusive, harassing, or otherwise unacceptable behavior may be
58 | reported by contacting the project team at [uias@sapsford.tech](mailto:uias@sapsford.tech). All
59 | complaints will be reviewed and investigated and will result in a response that
60 | is deemed necessary and appropriate to the circumstances. The project team is
61 | obligated to maintain confidentiality with regard to the reporter of an incident.
62 | Further details of specific enforcement policies may be posted separately.
63 | 
64 | Project maintainers who do not follow or enforce the Code of Conduct in good
65 | faith may face temporary or permanent repercussions as determined by other
66 | members of the project's leadership.
67 | 
68 | ## Attribution
69 | 
70 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
71 | available at [http://contributor-covenant.org/version/1/4][version]
72 | 
73 | [homepage]: http://contributor-covenant.org
74 | [version]: http://contributor-covenant.org/version/1/4/


--------------------------------------------------------------------------------
/Docs/jazzy-theme/assets/css/highlight.css.scss:
--------------------------------------------------------------------------------
 1 | /* Credit to https://gist.github.com/wataru420/2048287 */
 2 | 
 3 | .highlight {
 4 |   .c { color: #999988; font-style: italic } /* Comment */
 5 |   .err { color: #a61717; background-color: #e3d2d2 } /* Error */
 6 |   .k { color: #000000; font-weight: bold } /* Keyword */
 7 |   .o { color: #000000; font-weight: bold } /* Operator */
 8 |   .cm { color: #999988; font-style: italic } /* Comment.Multiline */
 9 |   .cp { color: #999999; font-weight: bold } /* Comment.Preproc */
10 |   .c1 { color: #999988; font-style: italic } /* Comment.Single */
11 |   .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
12 |   .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
13 |   .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */
14 |   .ge { color: #000000; font-style: italic } /* Generic.Emph */
15 |   .gr { color: #aa0000 } /* Generic.Error */
16 |   .gh { color: #999999 } /* Generic.Heading */
17 |   .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
18 |   .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */
19 |   .go { color: #888888 } /* Generic.Output */
20 |   .gp { color: #555555 } /* Generic.Prompt */
21 |   .gs { font-weight: bold } /* Generic.Strong */
22 |   .gu { color: #aaaaaa } /* Generic.Subheading */
23 |   .gt { color: #aa0000 } /* Generic.Traceback */
24 |   .kc { color: #000000; font-weight: bold } /* Keyword.Constant */
25 |   .kd { color: #000000; font-weight: bold } /* Keyword.Declaration */
26 |   .kp { color: #000000; font-weight: bold } /* Keyword.Pseudo */
27 |   .kr { color: #000000; font-weight: bold } /* Keyword.Reserved */
28 |   .kt { color: #445588; } /* Keyword.Type */
29 |   .m { color: #009999 } /* Literal.Number */
30 |   .s { color: #d14 } /* Literal.String */
31 |   .na { color: #008080 } /* Name.Attribute */
32 |   .nb { color: #0086B3 } /* Name.Builtin */
33 |   .nc { color: #445588; font-weight: bold } /* Name.Class */
34 |   .no { color: #008080 } /* Name.Constant */
35 |   .ni { color: #800080 } /* Name.Entity */
36 |   .ne { color: #4A00E0; font-weight: bold } /* Name.Exception */
37 |   .nf { color: #4A00E0; } /* Name.Function */
38 |   .nn { color: #555555 } /* Name.Namespace */
39 |   .nt { color: #000080 } /* Name.Tag */
40 |   .nv { color: #008080 } /* Name.Variable */
41 |   .ow { color: #000000; font-weight: bold } /* Operator.Word */
42 |   .w { color: #bbbbbb } /* Text.Whitespace */
43 |   .mf { color: #009999 } /* Literal.Number.Float */
44 |   .mh { color: #009999 } /* Literal.Number.Hex */
45 |   .mi { color: #009999 } /* Literal.Number.Integer */
46 |   .mo { color: #009999 } /* Literal.Number.Oct */
47 |   .sb { color: #8E2DE2 } /* Literal.String.Backtick */
48 |   .sc { color: #8E2DE2 } /* Literal.String.Char */
49 |   .sd { color: #8E2DE2 } /* Literal.String.Doc */
50 |   .s2 { color: #8E2DE2 } /* Literal.String.Double */
51 |   .se { color: #8E2DE2 } /* Literal.String.Escape */
52 |   .sh { color: #8E2DE2 } /* Literal.String.Heredoc */
53 |   .si { color: #8E2DE2 } /* Literal.String.Interpol */
54 |   .sx { color: #8E2DE2 } /* Literal.String.Other */
55 |   .sr { color: #009926 } /* Literal.String.Regex */
56 |   .s1 { color: #8E2DE2 } /* Literal.String.Single */
57 |   .ss { color: #990073 } /* Literal.String.Symbol */
58 |   .bp { color: #999999 } /* Name.Builtin.Pseudo */
59 |   .vc { color: #008080 } /* Name.Variable.Class */
60 |   .vg { color: #008080 } /* Name.Variable.Global */
61 |   .vi { color: #008080 } /* Name.Variable.Instance */
62 |   .il { color: #009999 } /* Literal.Number.Integer.Long */
63 | }
64 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarLayout/Types/TMConstrainedHorizontalBarLayout.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  TMConstrainedHorizontalBarLayout.swift
 3 | //  Tabman
 4 | //
 5 | //  Created by Merrick Sapsford on 26/06/2018.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | /// Layout that displays bar buttons sequentially along the horizontal axis, but is constrained by the number of items it can display.
12 | ///
13 | /// Based on `TMHorizontalBarLayout`. If the bar happens to contain more bar buttons than the `visibleButtonCount`, they will be off screen.
14 | /// You should use this layout if you want to a horizontal layout with a limited amount of buttons, such as a tab bar.
15 | /// It's also worth noting that the button width is set to `bounds.size.width / visibleButtonCount` rather than using intrinsic sizing.
16 | open class TMConstrainedHorizontalBarLayout: TMHorizontalBarLayout {
17 |     
18 |     // MARK: Properties
19 |     
20 |     // swiftlint:disable unused_setter_value
21 |     @available(*, unavailable)
22 |     open override var contentMode: TMBarLayout.ContentMode {
23 |         get {
24 |             return super.contentMode
25 |         }
26 |         set {
27 |             fatalError("\(type(of: self)) does not support updating contentMode")
28 |         }
29 |     }
30 |     
31 |     // swiftlint:disable unused_setter_value
32 |     @available(*, unavailable)
33 |     open override var interButtonSpacing: CGFloat {
34 |         get {
35 |             return super.interButtonSpacing
36 |         }
37 |         set {
38 |             fatalError("\(type(of: self)) does not support updating interButtonSpacing")
39 |         }
40 |     }
41 |    
42 |     private var viewWidthConstraints: [NSLayoutConstraint]?
43 |     /// The number of buttons to be visible in the layout.
44 |     ///
45 |     /// If the number of buttons exceeds this value, paging will be enabled.
46 |     open var visibleButtonCount: Int = 5 {
47 |         didSet {
48 |             guard oldValue != visibleButtonCount else {
49 |                 return
50 |             }
51 |             constrain(views: stackView.arrangedSubviews, for: visibleButtonCount)
52 |         }
53 |     }
54 |     
55 |     // MARK: Lifecycle
56 |     
57 |     open override func layout(in view: UIView) {
58 |         super.layout(in: view)
59 |         super.interButtonSpacing = 0.0
60 |     }
61 |     
62 |     open override func insert(buttons: [TMBarButton], at index: Int) {
63 |         super.insert(buttons: buttons, at: index)
64 |         
65 |         // Constrain button widths to visible count on insertion
66 |         constrain(views: stackView.arrangedSubviews, for: visibleButtonCount)
67 |     }
68 | }
69 | 
70 | private extension TMConstrainedHorizontalBarLayout {
71 |     
72 |     func constrain(views: [UIView], for maximumCount: Int) {
73 |         if let oldConstraints = viewWidthConstraints {
74 |             NSLayoutConstraint.deactivate(oldConstraints)
75 |         }
76 |         
77 |         var constraints = [NSLayoutConstraint]()
78 |         let itemViews = views.filter { !($0 is SeparatorView) }
79 |         let multiplier = 1.0 / CGFloat(min(maximumCount, itemViews.count))
80 |         let separatorWidth = self.separatorWidth ?? 0
81 |         for view in itemViews {
82 |             constraints.append(view.widthAnchor.constraint(equalTo: layoutGuide.widthAnchor,
83 |                                                            multiplier: multiplier,
84 |                                                            constant: -separatorWidth))
85 |         }
86 |         NSLayoutConstraint.activate(constraints)
87 |         self.viewWidthConstraints = constraints
88 |     }
89 | }
90 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarIndicator/Types/TMLineBarIndicator.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  TMLineBarIndicator.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 07/06/2018.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | 
 11 | /// Simple indicator that displays as a horizontal line.
 12 | open class TMLineBarIndicator: TMBarIndicator {
 13 |     
 14 |     // MARK: Types
 15 |     
 16 |     public enum Weight {
 17 |         case light
 18 |         case medium
 19 |         case heavy
 20 |         case custom(value: CGFloat)
 21 |     }
 22 |     
 23 |     public enum CornerStyle {
 24 |         case square
 25 |         case rounded
 26 |         case eliptical
 27 |     }
 28 |     
 29 |     // MARK: Properties
 30 |     
 31 |     private var weightConstraint: NSLayoutConstraint?
 32 |     
 33 |     open override var displayMode: TMBarIndicator.DisplayMode {
 34 |         return .bottom
 35 |     }
 36 | 
 37 |     // MARK: Customization
 38 |     
 39 |     /// Color of the line.
 40 |     open override var tintColor: UIColor! {
 41 |         didSet {}
 42 |     }
 43 |     /// Weight of the line.
 44 |     ///
 45 |     /// Options:
 46 |     /// - light: 2.0 pt
 47 |     /// - medium: 4.0 pt
 48 |     /// - heavy: 8.0 pt
 49 |     /// - custom: Custom weight.
 50 |     ///
 51 |     /// Default: `.medium`
 52 |     open var weight: Weight = .medium {
 53 |         didSet {
 54 |             weightConstraint?.constant = weight.rawValue
 55 |             setNeedsLayout()
 56 |         }
 57 |     }
 58 |     /// Corner style for the ends of the line.
 59 |     ///
 60 |     /// Options:
 61 |     /// - square: Corners are squared off.
 62 |     /// - rounded: Corners are rounded.
 63 |     /// - eliptical: Corners are completely circular.
 64 |     ///
 65 |     /// Default: `.square`.
 66 |     open var cornerStyle: CornerStyle = .square {
 67 |         didSet {
 68 |             setNeedsLayout()
 69 |         }
 70 |     }
 71 |     
 72 |     // MARK: Lifecycle
 73 |     
 74 |     open override func layout(in view: UIView) {
 75 |         super.layout(in: view)
 76 |         
 77 |         let heightConstraint = heightAnchor.constraint(equalToConstant: weight.rawValue)
 78 |         heightConstraint.isActive = true
 79 |         self.weightConstraint = heightConstraint
 80 |         
 81 |         backgroundColor = self.tintColor
 82 |     }
 83 |     
 84 |     open override func layoutSubviews() {
 85 |         super.layoutSubviews()
 86 |         
 87 |         superview?.layoutIfNeeded()
 88 |         layer.cornerRadius = cornerStyle.cornerRadius(for: weight.rawValue,
 89 |                                                       in: bounds)
 90 |     }
 91 | 
 92 |     open override func tintColorDidChange() {
 93 |         super.tintColorDidChange()
 94 |         backgroundColor = tintColor
 95 |     }
 96 | }
 97 | 
 98 | private extension TMLineBarIndicator.Weight {
 99 |     
100 |     var rawValue: CGFloat {
101 |         switch self {
102 |         case .light:
103 |             return 2.0
104 |         case .medium:
105 |             return 4.0
106 |         case .heavy:
107 |             return 8.0
108 |         case .custom(let value):
109 |             return value
110 |         }
111 |     }
112 | }
113 | 
114 | private extension TMLineBarIndicator.CornerStyle {
115 |     
116 |     func cornerRadius(for weight: CGFloat, in frame: CGRect) -> CGFloat {
117 |         switch self {
118 |         case .square:
119 |             return 0.0
120 |         case .rounded:
121 |             return weight / 4.0
122 |         case .eliptical:
123 |             return frame.size.height / 2.0
124 |         }
125 |     }
126 | }
127 | 


--------------------------------------------------------------------------------
/Sources/Tabman/AutoInsetter/InsetCalculator/ScrollViewInsetCalculator.swift:
--------------------------------------------------------------------------------
 1 | //
 2 | //  ScrollViewInsetCalculator.swift
 3 | //  AutoInsetter
 4 | //
 5 | //  Created by Merrick Sapsford on 16/03/2019.
 6 | //  Copyright © 2022 UI At Six. All rights reserved.
 7 | //
 8 | 
 9 | import UIKit
10 | 
11 | internal class ScrollViewInsetCalculator: ViewInsetCalculator<UIScrollView> {
12 |     
13 |     override func calculateContentInset(from spec: AutoInsetSpec, store: InsetStore) -> ContentInsetCalculation? {
14 |         let previous = store.contentInset(for: view) ?? .zero
15 |         
16 |         let contentInset = makeContentAndScrollIndicatorInsets(from: spec)
17 |         guard contentInset != view.contentInset else {
18 |             return nil
19 |         }
20 |         store.store(contentInset: contentInset, for: view)
21 |         
22 |         let customContentInset = applyCustomContentInset(to: contentInset, from: previous)
23 |         return ContentInsetCalculation(new: customContentInset,
24 |                                        previous: previous,
25 |                                        currentActual: view.contentInset)
26 |     }
27 |     
28 |     override func calculateContentOffset(from insetCalculation: ContentInsetCalculation, store: InsetStore) -> ContentOffsetCalculation? {
29 |         guard insetCalculation.currentActual.top != insetCalculation.new.top else {
30 |             return nil
31 |         }
32 |         let topInsetDelta = insetCalculation.new.top - insetCalculation.currentActual.top
33 |         
34 |         let previous = store.contentOffset(for: view)
35 |         var contentOffset = previous ?? .zero
36 |         
37 |         var userOffsetDelta = view.contentOffset.y - contentOffset.y
38 |         if userOffsetDelta > 0 {
39 |             userOffsetDelta += contentOffset.y + insetCalculation.new.top
40 |         }
41 |         
42 |         contentOffset.y -= topInsetDelta
43 |         store.store(contentOffset: contentOffset, for: view)
44 |         
45 |         if userOffsetDelta > 0 {
46 |             contentOffset.y += userOffsetDelta
47 |         }
48 |         
49 |         return ContentOffsetCalculation(new: contentOffset,
50 |                                         previous: previous,
51 |                                         currentActual: view.contentOffset)
52 |     }
53 |     
54 |     override func calculateScrollIndicatorInsets(from spec: AutoInsetSpec) -> UIEdgeInsets? {
55 |         let scrollIndicatorInsets = makeContentAndScrollIndicatorInsets(from: spec)
56 |         guard scrollIndicatorInsets != view.scrollIndicatorInsets else {
57 |             return nil
58 |         }
59 |         return scrollIndicatorInsets
60 |     }
61 |     
62 |     // MARK: Calculations
63 |     
64 |     private func makeContentAndScrollIndicatorInsets(from spec: AutoInsetSpec) -> UIEdgeInsets {
65 |         let allRequiredInsets = spec.allRequiredInsets
66 |         
67 |         let relativeFrame = viewController.view.convert(view.frame, from: view.superview)
68 |         
69 |         // top
70 |         let topInset = max(allRequiredInsets.top - relativeFrame.minY, 0.0)
71 |         
72 |         // left
73 |         let leftInset = max(allRequiredInsets.left - relativeFrame.minX, 0.0)
74 |         
75 |         // right
76 |         let rightInsetMinX = viewController.view.bounds.width - allRequiredInsets.right
77 |         let rightInset = abs(min(rightInsetMinX - relativeFrame.maxX, 0.0))
78 |         
79 |         // bottom
80 |         let bottomInsetMinY = viewController.view.bounds.height - allRequiredInsets.bottom
81 |         let bottomInset = abs(min(bottomInsetMinY - relativeFrame.maxY, 0.0))
82 |         
83 |         return UIEdgeInsets(top: topInset, left: leftInset, bottom: bottomInset, right: rightInset)
84 |     }
85 | }
86 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarButton/TMBarButtonCollection.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  TMBarButtonCollection.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 03/08/2018.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | 
 11 | /// Container for BarButton objects and related controllers.
 12 | public final class TMBarButtonCollection<BarButton: TMBarButton>: TMTransitionStyleable {
 13 |     
 14 |     // MARK: Types
 15 |     
 16 |     public typealias Customization = (BarButton) -> Void
 17 |     
 18 |     // MARK: Buttons
 19 |     
 20 |     /// All bar buttons.
 21 |     public internal(set) var all = [BarButton]() {
 22 |         didSet {
 23 |             self.stateController = TMBarButtonStateController(for: all)
 24 |             self.interactionController = TMBarButtonInteractionController(for: all, handler: self)
 25 |             
 26 |             for button in all {
 27 |                 customization?(button)
 28 |             }
 29 |         }
 30 |     }
 31 |     
 32 |     private var customization: Customization?
 33 |     
 34 |     /// Controller which handles button state updates.
 35 |     internal private(set) var stateController: TMBarButtonStateController!
 36 |     /// Controller which handles button interaction.
 37 |     internal private(set) var interactionController: TMBarButtonInteractionController!
 38 |     
 39 |     /// External handler that responds to interaction controller events.
 40 |     internal weak var interactionHandler: TMBarButtonInteractionHandler?
 41 |     
 42 |     // MARK: Customization
 43 |     
 44 |     /// Style to use when transitioning between buttons.
 45 |     public var transitionStyle: TMTransitionStyle = .progressive
 46 |     
 47 |     // MARK: Init
 48 |     
 49 |     internal init() {
 50 |         self.stateController = TMBarButtonStateController(for: all)
 51 |         self.interactionController = TMBarButtonInteractionController(for: all, handler: self)
 52 |     }
 53 |     
 54 |     // MARK: Customization
 55 | 
 56 |     /**
 57 |      Customize the bar buttons that are added to the bar.
 58 |      
 59 |      Note: The customization closure is retained and will be called every time a bar button is added/removed.
 60 |      
 61 |      Parameter customize: The closure in which customization takes place.
 62 |      **/
 63 |     public func customize(_ customize: @escaping Customization) {
 64 |         self.customization = customize
 65 |         all.forEach { (button) in
 66 |             customize(button)
 67 |         }
 68 |     }
 69 |     
 70 |     // MARK: Utility
 71 |     
 72 |     /// Get a button that is associated with a bar item.
 73 |     ///
 74 |     /// - Parameter item: Item to search for.
 75 |     /// - Returns: Associated bar button.
 76 |     public func `for`(item: TMBarItemable) -> BarButton? {
 77 |         guard let index = all.firstIndex(where: { ($0.item === item) }) else {
 78 |             return nil
 79 |         }
 80 |         return all[index]
 81 |     }
 82 |     
 83 |     /// Get buttons associated with bar items.
 84 |     ///
 85 |     /// - Parameter items: Items to search for.
 86 |     /// - Returns: Associated bar buttons.
 87 |     public func `for`(items: TMBarItemable...) -> [BarButton] {
 88 |         return items.compactMap({ self.for(item: $0) })
 89 |     }
 90 | }
 91 | 
 92 | extension TMBarButtonCollection: TMBarButtonInteractionHandler {
 93 |     
 94 |     func barButtonInteraction(controller: TMBarButtonInteractionController,
 95 |                               didHandlePressOf button: TMBarButton,
 96 |                               at index: Int) {
 97 |         interactionHandler?.barButtonInteraction(controller: controller,
 98 |                                                  didHandlePressOf: button,
 99 |                                                  at: index)
100 |     }
101 | }
102 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarLayout/Types/TMHorizontalBarLayout+Separator.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  TMHorizontalBarLayout+Separator.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 28/04/2019.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | 
 11 | extension TMHorizontalBarLayout {
 12 |     
 13 |     internal class SeparatorView: UIView {
 14 |         
 15 |         // swiftlint:disable nesting
 16 |         
 17 |         private struct Defaults {
 18 |             static let width: CGFloat = 1.0
 19 |             static let contentInset = UIEdgeInsets(top: 4.0, left: 0.0, bottom: 4.0, right: 0.0)
 20 |         }
 21 |         
 22 |         // MARK: Properties
 23 |         
 24 |         private let content = UIView()
 25 |         
 26 |         @available (*, unavailable)
 27 |         override var backgroundColor: UIColor? {
 28 |             didSet {}
 29 |         }
 30 |         
 31 |         override var tintColor: UIColor! {
 32 |             didSet {
 33 |                 content.backgroundColor = tintColor
 34 |             }
 35 |         }
 36 |         
 37 |         private var contentWidth: NSLayoutConstraint?
 38 |         private var _width: CGFloat?
 39 |         var width: CGFloat! {
 40 |             get {
 41 |                 return _width ?? Defaults.width
 42 |             }
 43 |             set {
 44 |                 _width = newValue
 45 |                 contentWidth?.constant = width
 46 |             }
 47 |         }
 48 |         
 49 |         private var contentLeading: NSLayoutConstraint?
 50 |         private var contentTop: NSLayoutConstraint?
 51 |         private var contentTrailing: NSLayoutConstraint?
 52 |         private var contentBottom: NSLayoutConstraint?
 53 |         private var _contentInset: UIEdgeInsets?
 54 |         var contentInset: UIEdgeInsets! {
 55 |             get {
 56 |                 return _contentInset ?? Defaults.contentInset
 57 |             }
 58 |             set {
 59 |                 _contentInset = newValue
 60 |                 contentLeading?.constant = contentInset.left
 61 |                 contentTop?.constant = contentInset.top
 62 |                 contentTrailing?.constant = contentInset.right
 63 |                 contentBottom?.constant = contentInset.bottom
 64 |             }
 65 |         }
 66 |         
 67 |         // MARK: Init
 68 |         
 69 |         override init(frame: CGRect) {
 70 |             super.init(frame: frame)
 71 |             initialize()
 72 |         }
 73 |         
 74 |         required init?(coder aDecoder: NSCoder) {
 75 |             super.init(coder: aDecoder)
 76 |             initialize()
 77 |         }
 78 |         
 79 |         private func initialize() {
 80 |             
 81 |             content.translatesAutoresizingMaskIntoConstraints = false
 82 |             addSubview(content)
 83 |             
 84 |             let leading = content.leadingAnchor.constraint(equalTo: leadingAnchor, constant: contentInset.left)
 85 |             let top = content.topAnchor.constraint(equalTo: topAnchor, constant: contentInset.top)
 86 |             let trailing = trailingAnchor.constraint(equalTo: content.trailingAnchor, constant: contentInset.right)
 87 |             let bottom = bottomAnchor.constraint(equalTo: content.bottomAnchor, constant: contentInset.bottom)
 88 |             NSLayoutConstraint.activate([
 89 |                 leading,
 90 |                 top,
 91 |                 trailing,
 92 |                 bottom
 93 |                 ])
 94 |             contentLeading = leading
 95 |             contentTop = top
 96 |             contentTrailing = trailing
 97 |             contentBottom = bottom
 98 |             
 99 |             contentWidth = content.widthAnchor.constraint(equalToConstant: width)
100 |             contentWidth?.isActive = true
101 |             
102 |             content.backgroundColor = tintColor
103 |         }
104 |     }
105 | }
106 | 


--------------------------------------------------------------------------------
/Sources/Tabman.xcodeproj/xcshareddata/xcschemes/Tabman.xcscheme:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <Scheme
 3 |    LastUpgradeVersion = "1530"
 4 |    version = "1.3">
 5 |    <BuildAction
 6 |       parallelizeBuildables = "YES"
 7 |       buildImplicitDependencies = "YES">
 8 |       <BuildActionEntries>
 9 |          <BuildActionEntry
10 |             buildForTesting = "YES"
11 |             buildForRunning = "YES"
12 |             buildForProfiling = "YES"
13 |             buildForArchiving = "YES"
14 |             buildForAnalyzing = "YES">
15 |             <BuildableReference
16 |                BuildableIdentifier = "primary"
17 |                BlueprintIdentifier = "D62AC0B11E5733810020B8AE"
18 |                BuildableName = "Tabman.framework"
19 |                BlueprintName = "Tabman"
20 |                ReferencedContainer = "container:Tabman.xcodeproj">
21 |             </BuildableReference>
22 |          </BuildActionEntry>
23 |       </BuildActionEntries>
24 |    </BuildAction>
25 |    <TestAction
26 |       buildConfiguration = "Debug"
27 |       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
28 |       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
29 |       shouldUseLaunchSchemeArgsEnv = "YES">
30 |       <MacroExpansion>
31 |          <BuildableReference
32 |             BuildableIdentifier = "primary"
33 |             BlueprintIdentifier = "D62AC0B11E5733810020B8AE"
34 |             BuildableName = "Tabman.framework"
35 |             BlueprintName = "Tabman"
36 |             ReferencedContainer = "container:Tabman.xcodeproj">
37 |          </BuildableReference>
38 |       </MacroExpansion>
39 |       <Testables>
40 |          <TestableReference
41 |             skipped = "NO">
42 |             <BuildableReference
43 |                BuildableIdentifier = "primary"
44 |                BlueprintIdentifier = "D62AC0BA1E5733810020B8AE"
45 |                BuildableName = "TabmanTests.xctest"
46 |                BlueprintName = "TabmanTests"
47 |                ReferencedContainer = "container:Tabman.xcodeproj">
48 |             </BuildableReference>
49 |          </TestableReference>
50 |       </Testables>
51 |    </TestAction>
52 |    <LaunchAction
53 |       buildConfiguration = "Debug"
54 |       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
55 |       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
56 |       launchStyle = "0"
57 |       useCustomWorkingDirectory = "NO"
58 |       ignoresPersistentStateOnLaunch = "NO"
59 |       debugDocumentVersioning = "YES"
60 |       debugServiceExtension = "internal"
61 |       allowLocationSimulation = "YES">
62 |       <MacroExpansion>
63 |          <BuildableReference
64 |             BuildableIdentifier = "primary"
65 |             BlueprintIdentifier = "D62AC0B11E5733810020B8AE"
66 |             BuildableName = "Tabman.framework"
67 |             BlueprintName = "Tabman"
68 |             ReferencedContainer = "container:Tabman.xcodeproj">
69 |          </BuildableReference>
70 |       </MacroExpansion>
71 |    </LaunchAction>
72 |    <ProfileAction
73 |       buildConfiguration = "Release"
74 |       shouldUseLaunchSchemeArgsEnv = "YES"
75 |       savedToolIdentifier = ""
76 |       useCustomWorkingDirectory = "NO"
77 |       debugDocumentVersioning = "YES">
78 |       <MacroExpansion>
79 |          <BuildableReference
80 |             BuildableIdentifier = "primary"
81 |             BlueprintIdentifier = "D62AC0B11E5733810020B8AE"
82 |             BuildableName = "Tabman.framework"
83 |             BlueprintName = "Tabman"
84 |             ReferencedContainer = "container:Tabman.xcodeproj">
85 |          </BuildableReference>
86 |       </MacroExpansion>
87 |    </ProfileAction>
88 |    <AnalyzeAction
89 |       buildConfiguration = "Debug">
90 |    </AnalyzeAction>
91 |    <ArchiveAction
92 |       buildConfiguration = "Release"
93 |       revealArchiveInOrganizer = "YES">
94 |    </ArchiveAction>
95 | </Scheme>
96 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarIndicator/Types/TMDotBarIndicator.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  TMDotBarIndicator.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 07/11/2018.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | 
 11 | /// Indicator that displays a circular dot centered along the X-axis.
 12 | open class TMDotBarIndicator: TMBarIndicator {
 13 |     
 14 |     // MARK: Types
 15 |     
 16 |     public enum Size {
 17 |         case small
 18 |         case medium
 19 |         case large
 20 |         case custom(size: CGSize)
 21 |     }
 22 |     
 23 |     // MARK: Properties
 24 |     
 25 |     private let dotContainer = UIView()
 26 |     private let dotLayer = CAShapeLayer()
 27 |     
 28 |     private var widthConstraint: NSLayoutConstraint?
 29 |     private var heightConstraint: NSLayoutConstraint?
 30 |     
 31 |     open override var displayMode: TMBarIndicator.DisplayMode {
 32 |         return .bottom
 33 |     }
 34 |     
 35 |     // MARK: Customization
 36 |     
 37 |     open var size: Size = .medium {
 38 |         didSet {
 39 |             guard size.rawValue != oldValue.rawValue else {
 40 |                 return
 41 |             }
 42 |             update(for: size.rawValue)
 43 |         }
 44 |     }
 45 |     /// Color of the dot.
 46 |     open override var tintColor: UIColor! {
 47 |         didSet {}
 48 |     }
 49 |     
 50 |     // MARK: Lifecycle
 51 |     
 52 |     open override func layout(in view: UIView) {
 53 |         super.layout(in: view)
 54 |         
 55 |         view.addSubview(dotContainer)
 56 |         dotContainer.translatesAutoresizingMaskIntoConstraints = false
 57 |         let widthConstraint = dotContainer.widthAnchor.constraint(equalToConstant: size.rawValue.width)
 58 |         let heightConstraint = dotContainer.heightAnchor.constraint(equalToConstant: size.rawValue.height)
 59 |         NSLayoutConstraint.activate([
 60 |             dotContainer.topAnchor.constraint(equalTo: topAnchor),
 61 |             dotContainer.bottomAnchor.constraint(equalTo: bottomAnchor),
 62 |             dotContainer.centerXAnchor.constraint(equalTo: centerXAnchor),
 63 |             widthConstraint,
 64 |             heightConstraint
 65 |             ])
 66 |         self.widthConstraint = widthConstraint
 67 |         self.heightConstraint = heightConstraint
 68 |         
 69 |         dotLayer.fillColor = tintColor.cgColor
 70 |         dotContainer.layer.addSublayer(dotLayer)
 71 |     }
 72 | 
 73 |     open override func tintColorDidChange() {
 74 |         super.tintColorDidChange()
 75 |         dotLayer.fillColor = tintColor.cgColor
 76 |     }
 77 |     
 78 |     // MARK: Layout
 79 |     
 80 |     open override func layoutSubviews() {
 81 |         super.layoutSubviews()
 82 |         
 83 |         dotLayer.frame = dotContainer.bounds
 84 |         dotLayer.path = dotPath(for: size.rawValue).cgPath
 85 |     }
 86 |     
 87 |     private func update(for size: CGSize) {
 88 |         widthConstraint?.constant = size.width
 89 |         heightConstraint?.constant = size.height
 90 |         setNeedsLayout()
 91 |     }
 92 | }
 93 | 
 94 | private extension TMDotBarIndicator {
 95 |     
 96 |     func dotPath(for size: CGSize) -> UIBezierPath {
 97 |         let path = UIBezierPath(ovalIn: CGRect(x: 0.0,
 98 |                                                y: 0.0,
 99 |                                                width: size.width,
100 |                                                height: size.height))
101 |         return path
102 |     }
103 | }
104 | 
105 | private extension TMDotBarIndicator.Size {
106 |     
107 |     var rawValue: CGSize {
108 |         switch self {
109 |         case .small:
110 |             return CGSize(width: 6, height: 6)
111 |         case .medium:
112 |             return CGSize(width: 8, height: 8)
113 |         case .large:
114 |             return CGSize(width: 12, height: 12)
115 |         case .custom(let size):
116 |             return size
117 |         }
118 |     }
119 | }
120 | 


--------------------------------------------------------------------------------
/Sources/iOS/Extras/GradientBackgroundViewController.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  GradientBackgroundViewController.swift
  3 | //  Example
  4 | //
  5 | //  Created by Merrick Sapsford on 04/10/2020.
  6 | //
  7 | 
  8 | import UIKit
  9 | 
 10 | final class GradientBackgroundViewController: UIViewController {
 11 |     
 12 |     // MARK: Properties
 13 |     
 14 |     private lazy var gradientView = GradientView(colors: colors)
 15 |     private let child: UIViewController
 16 |     
 17 |     private let colors: [UIColor]
 18 |     
 19 |     // MARK: Init
 20 |     
 21 |     init(embedding child: UIViewController, colors: [UIColor]) {
 22 |         self.child = child
 23 |         self.colors = colors
 24 |         super.init(nibName: nil, bundle: nil)
 25 |     }
 26 |     
 27 |     @available(*, unavailable)
 28 |     required init?(coder: NSCoder) {
 29 |         fatalError("Not Supported")
 30 |     }
 31 |     
 32 |     // MARK: Lifecycle
 33 |     
 34 |     override func viewDidLoad() {
 35 |         super.viewDidLoad()
 36 |         
 37 |         view.addSubview(gradientView)
 38 |         gradientView.translatesAutoresizingMaskIntoConstraints = false
 39 |         NSLayoutConstraint.activate([
 40 |             gradientView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
 41 |             gradientView.topAnchor.constraint(equalTo: view.topAnchor),
 42 |             view.trailingAnchor.constraint(equalTo: gradientView.trailingAnchor),
 43 |             view.bottomAnchor.constraint(equalTo: gradientView.bottomAnchor)
 44 |         ])
 45 |         
 46 |         addChild(child)
 47 |         view.addSubview(child.view)
 48 |         child.view.translatesAutoresizingMaskIntoConstraints = false
 49 |         NSLayoutConstraint.activate([
 50 |             child.view.leadingAnchor.constraint(equalTo: view.leadingAnchor),
 51 |             child.view.topAnchor.constraint(equalTo: view.topAnchor),
 52 |             view.trailingAnchor.constraint(equalTo: child.view.trailingAnchor),
 53 |             view.bottomAnchor.constraint(equalTo: child.view.bottomAnchor)
 54 |         ])
 55 |     }
 56 | }
 57 | 
 58 | private final class GradientView: UIView {
 59 |     
 60 |     // MARK: Properties
 61 |     
 62 |     private var gradientLayer: CAGradientLayer? {
 63 |         if let gradientLayer = self.layer as? CAGradientLayer {
 64 |             return gradientLayer
 65 |         }
 66 |         return nil
 67 |     }
 68 |     
 69 |     var colors: [UIColor]? {
 70 |         didSet {
 71 |             var colorRefs = [CGColor]()
 72 |             for color in colors ?? [] {
 73 |                 colorRefs.append(color.cgColor)
 74 |             }
 75 |             gradientLayer?.colors = colorRefs
 76 |         }
 77 |     }
 78 |     
 79 |     var locations: [Double]? {
 80 |         didSet {
 81 |             var locationNumbers = [NSNumber]()
 82 |             for location in locations ?? [] {
 83 |                 locationNumbers.append(NSNumber(value: location))
 84 |             }
 85 |             gradientLayer?.locations = locationNumbers
 86 |         }
 87 |     }
 88 |     
 89 |     var startPoint: CGPoint = CGPoint(x: 0.5, y: 0.0) {
 90 |         didSet {
 91 |             gradientLayer?.startPoint = startPoint
 92 |         }
 93 |     }
 94 |     
 95 |     var endPoint: CGPoint = CGPoint(x: 0.5, y: 1.0) {
 96 |         didSet {
 97 |             gradientLayer?.endPoint = endPoint
 98 |         }
 99 |     }
100 |     
101 |     override class var layerClass: AnyClass {
102 |         return CAGradientLayer.self
103 |     }
104 |     
105 |     // MARK: Init
106 |     
107 |     init(colors: [UIColor]) {
108 |         super.init(frame: .zero)
109 |         commonInit(colors: colors)
110 |     }
111 |     
112 |     override init(frame: CGRect) {
113 |         super.init(frame: frame)
114 |         commonInit()
115 |     }
116 |     
117 |     required init?(coder aDecoder: NSCoder) {
118 |         super.init(coder: aDecoder)
119 |         commonInit()
120 |     }
121 |     
122 |     private func commonInit(colors: [UIColor] = [UIColor.white, UIColor.black]) {
123 |         self.colors = colors
124 |         gradientLayer?.startPoint = self.startPoint
125 |         gradientLayer?.endPoint = self.endPoint
126 |     }
127 | }
128 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarIndicator/Types/TMChevronBarIndicator.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  TMChevronBarIndicator.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 01/11/2018.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | 
 11 | /// Indicator that displays a vertical chevron centered along the X-axis.
 12 | open class TMChevronBarIndicator: TMBarIndicator {
 13 |     
 14 |     // MARK: Types
 15 |     
 16 |     public enum Size {
 17 |         case small
 18 |         case medium
 19 |         case large
 20 |         case custom(size: CGSize)
 21 |     }
 22 |     
 23 |     // MARK: Properties
 24 |     
 25 |     private let chevronContainer = UIView()
 26 |     private let chevronLayer = CAShapeLayer()
 27 |     
 28 |     private var widthConstraint: NSLayoutConstraint?
 29 |     private var heightConstraint: NSLayoutConstraint?
 30 |     
 31 |     open override var displayMode: TMBarIndicator.DisplayMode {
 32 |         return .bottom
 33 |     }
 34 |     
 35 |     // MARK: Customization
 36 |     
 37 |     /// Size of the chevron.
 38 |     ///
 39 |     /// Options:
 40 |     /// - small: (10 x 8pt)
 41 |     /// - medium: (14 x 12pt)
 42 |     /// - large: (20 x 16pt)
 43 |     /// - custom: A custom size.
 44 |     open var size: Size = .medium {
 45 |         didSet {
 46 |             guard size.rawValue != oldValue.rawValue else {
 47 |                 return
 48 |             }
 49 |             update(for: size.rawValue)
 50 |         }
 51 |     }
 52 |     /// Color of the chevron.
 53 |     open override var tintColor: UIColor! {
 54 |         didSet {}
 55 |     }
 56 |     
 57 |     // MARK: Lifecycle
 58 |     
 59 |     open override func layout(in view: UIView) {
 60 |         super.layout(in: view)
 61 |         
 62 |         view.addSubview(chevronContainer)
 63 |         chevronContainer.translatesAutoresizingMaskIntoConstraints = false
 64 |         let widthConstraint = chevronContainer.widthAnchor.constraint(equalToConstant: size.rawValue.width)
 65 |         let heightConstraint = chevronContainer.heightAnchor.constraint(equalToConstant: size.rawValue.height)
 66 |         NSLayoutConstraint.activate([
 67 |             chevronContainer.topAnchor.constraint(equalTo: topAnchor),
 68 |             chevronContainer.bottomAnchor.constraint(equalTo: bottomAnchor),
 69 |             chevronContainer.centerXAnchor.constraint(equalTo: centerXAnchor),
 70 |             widthConstraint,
 71 |             heightConstraint
 72 |             ])
 73 |         self.widthConstraint = widthConstraint
 74 |         self.heightConstraint = heightConstraint
 75 |         
 76 |         chevronLayer.fillColor = tintColor.cgColor
 77 |         chevronContainer.layer.addSublayer(chevronLayer)
 78 |     }
 79 | 
 80 |     open override func tintColorDidChange() {
 81 |         super.tintColorDidChange()
 82 |         chevronLayer.fillColor = tintColor.cgColor
 83 |     }
 84 |     
 85 |     // MARK: Layout
 86 |     
 87 |     open override func layoutSubviews() {
 88 |         super.layoutSubviews()
 89 |         
 90 |         chevronLayer.frame = chevronContainer.bounds
 91 |         chevronLayer.path = chevronPath(for: size.rawValue).cgPath
 92 |     }
 93 |     
 94 |     private func update(for size: CGSize) {
 95 |         widthConstraint?.constant = size.width
 96 |         heightConstraint?.constant = size.height
 97 |         setNeedsLayout()
 98 |     }
 99 | }
100 | 
101 | private extension TMChevronBarIndicator {
102 |     
103 |     func chevronPath(for size: CGSize) -> UIBezierPath {
104 |         let path = UIBezierPath()
105 |         path.move(to: CGPoint(x: 0.0, y: size.height))
106 |         path.addLine(to: CGPoint(x: size.width / 2, y: 0.0))
107 |         path.addLine(to: CGPoint(x: size.width, y: size.height))
108 |         path.close()
109 |         return path
110 |     }
111 | }
112 | 
113 | private extension TMChevronBarIndicator.Size {
114 |     
115 |     var rawValue: CGSize {
116 |         switch self {
117 |         case .small:
118 |             return CGSize(width: 10, height: 8)
119 |         case .medium:
120 |             return CGSize(width: 14, height: 12)
121 |         case .large:
122 |             return CGSize(width: 20, height: 16)
123 |         case .custom(let size):
124 |             return size
125 |         }
126 |     }
127 | }
128 | 


--------------------------------------------------------------------------------
/Docs/Adding a Bar.md:
--------------------------------------------------------------------------------
  1 | # Adding a Bar
  2 | 
  3 | `TabmanViewController` supports adding multiple bars to numerous locations on the view controller. This guide covers the intricacies of adding a bar to any of the available `TabmanViewController.BarLocation` locations:
  4 | 
  5 | - [top](#top)
  6 | - [bottom](#bottom)
  7 | - [navigationItem](#navigationItem)
  8 | - [custom](#custom)
  9 | 
 10 | ## top
 11 | The `.top` location describes the area at the top of the view controller, insetted below any system areas such as the Safe Area. 
 12 | 
 13 | For example, if your view controller is within a `UINavigationController` which has a visbile `UINavigationBar` the `.top` location would describe the area directly below the navigation bar.
 14 | 
 15 | ```swift
 16 | override func viewDidLoad() {
 17 |     super.viewDidLoad()
 18 | 
 19 |     let bar = TMBar.ButtonBar()
 20 |     addBar(bar, dataSource: self, at: .top)
 21 | }
 22 | ```
 23 | 
 24 | #### Extending the background
 25 | If you would like to use the `TMBar` as a system bar similar to `UINavigationBar` or `UITabBar` you can use the `TMSystemBar` wrapper.
 26 | 
 27 | This will extend the background of the bar to the view edges, and add other extras such as a separator.
 28 | 
 29 | ```swift
 30 | addBar(bar.systemBar(), dataSource: self, at: .top)
 31 | ```
 32 | 
 33 | ## bottom
 34 | The `.bottom` location describes the area at the bottom of the view controller, insetted above any system areas such as the Safe Area. 
 35 | 
 36 | For example, if your view controller is within a `UITabBarController`, the `.bottom` location would describe the area directly above the `UITabBar`.
 37 | 
 38 | ```swift
 39 | override func viewDidLoad() {
 40 |     super.viewDidLoad()
 41 | 
 42 |     let bar = TMBar.TabBar()
 43 |     addBar(bar, dataSource: self, at: .bottom)
 44 | }
 45 | ```
 46 | 
 47 | #### Extending the background
 48 | If you would like to use the `TMBar` as a system bar similar to `UINavigationBar` or `UITabBar` you can use the `TMSystemBar` wrapper.
 49 | 
 50 | This will extend the background of the bar to the view edges, and add other extras such as a separator.
 51 | 
 52 | ```swift
 53 | addBar(bar.systemBar(), dataSource: self, at: .bottom)
 54 | ```
 55 | 
 56 | ## navigationItem
 57 | Tabman also supports displaying a bar within a `UINavigationItem` as its `titleView`.
 58 | 
 59 | Due to lifecycle events, it is recommended that you perform this in `viewWillAppear` rather than `viewDidLoad` and also retain your `TMBar` to improve performance.
 60 | 
 61 | ```swift
 62 | let bar = TMBar.ButtonBar()
 63 | 
 64 | override func viewWillAppear(animated: Bool) {
 65 |     super.viewWillAppear(animated: Bool)
 66 | 
 67 |     addBar(bar, dataSource: self, at: .navigationItem(item: self.navigationItem))
 68 | }
 69 | ```
 70 | 
 71 | ## custom
 72 | If you want a completely custom location for your bar, this is also fully supported by Tabman. This allows you to be add the bar as a subview to a custom specified container view.
 73 | 
 74 | ⚠️**Note** - Using a custom view will prevent Tabman from providing automatic insetting support for the bar.
 75 | 
 76 | ```swift
 77 | let customContainer = UIView()
 78 | 
 79 | override func viewDidLoad() {
 80 |     super.viewDidLoad()
 81 | 
 82 |     let bar = TMBar.ButtonBar()
 83 |     addBar(bar, dataSource: self, at: .custom(view: customContainer, layout: nil))
 84 | }
 85 | ```
 86 | 
 87 | This will automatically add the view as a subview to `customContainer` and constrain all four anchors (`leadingAnchor`, `topAnchor`, `trailingAnchor` and `bottomAnchor`) to be equal to the custom view.
 88 | 
 89 | #### Custom Layout Constraints
 90 | You might also want control over the constraints that are added to the bar when it's added to the custom view - this is where the `layout` parameter comes in. 
 91 | 
 92 | By setting this to `nil` you will get the default constraints that are described above, or you can use the closure to build your custom layout:
 93 | 
 94 | ```swift
 95 | addBar(bar, dataSource: self, at: .custom(view: customContainer, layout: { (bar) in
 96 |     bar.translatesAutoresizingMaskIntoConstraints = false
 97 |     NSLayoutConstraint.activate([
 98 |         bar.topAnchor.constraint(equalTo: self.customContainer.topAnchor),
 99 |         bar.centerXAnchor.constraint(equalTo: self.customContainer.centerXAnchor)
100 |         ])
101 |     }))
102 | ```


--------------------------------------------------------------------------------
/Sources/iOS/Base.lproj/LaunchScreen.storyboard:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="17156" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="lDd-Mq-5ZS">
 3 |     <device id="retina6_1" orientation="portrait" appearance="light"/>
 4 |     <dependencies>
 5 |         <deployment identifier="iOS"/>
 6 |         <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="17125"/>
 7 |         <capability name="Safe area layout guides" minToolsVersion="9.0"/>
 8 |         <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
 9 |     </dependencies>
10 |     <scenes>
11 |         <!--View Controller-->
12 |         <scene sceneID="Qht-aY-2nS">
13 |             <objects>
14 |                 <viewController id="lDd-Mq-5ZS" sceneMemberID="viewController">
15 |                     <layoutGuides>
16 |                         <viewControllerLayoutGuide type="top" id="aaK-3l-cee"/>
17 |                         <viewControllerLayoutGuide type="bottom" id="wrn-Qe-dTH"/>
18 |                     </layoutGuides>
19 |                     <view key="view" contentMode="scaleToFill" id="1Ra-pe-Kc8">
20 |                         <rect key="frame" x="0.0" y="0.0" width="414" height="896"/>
21 |                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
22 |                         <subviews>
23 |                             <imageView userInteractionEnabled="NO" contentMode="scaleToFill" horizontalHuggingPriority="251" verticalHuggingPriority="251" image="bg_logo_launch" translatesAutoresizingMaskIntoConstraints="NO" id="McC-Pd-DnC">
24 |                                 <rect key="frame" x="0.0" y="398" width="414" height="100"/>
25 |                                 <constraints>
26 |                                     <constraint firstAttribute="height" constant="100" id="aLF-8c-Ulg"/>
27 |                                 </constraints>
28 |                             </imageView>
29 |                             <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="Tabman" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="Ir6-9p-pt7">
30 |                                 <rect key="frame" x="136" y="422.5" width="142.5" height="51"/>
31 |                                 <fontDescription key="fontDescription" type="system" pointSize="42"/>
32 |                                 <color key="textColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
33 |                                 <nil key="highlightedColor"/>
34 |                             </label>
35 |                         </subviews>
36 |                         <viewLayoutGuide key="safeArea" id="3V0-8P-luk"/>
37 |                         <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
38 |                         <constraints>
39 |                             <constraint firstItem="Ir6-9p-pt7" firstAttribute="centerY" secondItem="1Ra-pe-Kc8" secondAttribute="centerY" id="QGM-N7-qTz"/>
40 |                             <constraint firstItem="McC-Pd-DnC" firstAttribute="leading" secondItem="1Ra-pe-Kc8" secondAttribute="leading" id="R7e-Ey-IaU"/>
41 |                             <constraint firstAttribute="trailing" secondItem="McC-Pd-DnC" secondAttribute="trailing" id="Xop-BB-UAm"/>
42 |                             <constraint firstItem="McC-Pd-DnC" firstAttribute="centerY" secondItem="1Ra-pe-Kc8" secondAttribute="centerY" id="Yai-JR-sVg"/>
43 |                             <constraint firstItem="Ir6-9p-pt7" firstAttribute="centerX" secondItem="1Ra-pe-Kc8" secondAttribute="centerX" id="cm0-K8-bk6"/>
44 |                         </constraints>
45 |                     </view>
46 |                 </viewController>
47 |                 <placeholder placeholderIdentifier="IBFirstResponder" id="SBc-Lc-HTE" userLabel="First Responder" sceneMemberID="firstResponder"/>
48 |             </objects>
49 |             <point key="canvasLocation" x="52" y="374.66266866566718"/>
50 |         </scene>
51 |     </scenes>
52 |     <resources>
53 |         <image name="bg_logo_launch" width="375" height="100"/>
54 |     </resources>
55 | </document>
56 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/Generic/AnimateableLabel.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  AnimateableLabel.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 09/11/2018.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | import QuartzCore
 11 | 
 12 | internal class AnimateableLabel: UIView {
 13 |     
 14 |     // MARK: Properties
 15 |     
 16 |     override var intrinsicContentSize: CGSize {
 17 |         return textLayer.preferredFrameSize()
 18 |     }
 19 |     
 20 |     private let textLayer = CATextLayer()
 21 |     
 22 |     var text: String? {
 23 |         didSet {
 24 |             textLayer.string = text
 25 |             invalidateIntrinsicContentSize()
 26 |         }
 27 |     }
 28 |     var textColor: UIColor! {
 29 |         get {
 30 |             if let color = textLayer.foregroundColor {
 31 |                 return UIColor(cgColor: color)
 32 |             }
 33 |             return .black
 34 |         }
 35 |         set {
 36 |             let textColor = newValue ?? .black
 37 |             if #available(iOS 13, *) {
 38 |                 textLayer.foregroundColor = textColor.resolvedColor(with: traitCollection).cgColor
 39 |             } else {
 40 |                 textLayer.foregroundColor = textColor.cgColor
 41 |             }
 42 |         }
 43 |     }
 44 |     var font: UIFont? {
 45 |         didSet {
 46 |             reloadTextLayerForCurrentFont()
 47 |         }
 48 |     }
 49 |     var textAlignment: NSTextAlignment? {
 50 |         didSet {
 51 |             textLayer.alignmentMode = caTextLayerAlignmentMode(from: textAlignment) ?? .left
 52 |         }
 53 |     }
 54 |     
 55 |     private var _adjustsFontForContentSizeCategory = false
 56 |     /// A Boolean that indicates whether the object automatically updates its font when the device's content size category changes.
 57 |     ///
 58 |     /// Defaults to `false`.
 59 |     @available(iOS 11, *)
 60 |     var adjustsFontForContentSizeCategory: Bool {
 61 |         get {
 62 |             _adjustsFontForContentSizeCategory
 63 |         }
 64 |         set {
 65 |             _adjustsFontForContentSizeCategory = newValue
 66 |             reloadTextLayerForCurrentFont()
 67 |         }
 68 |     }
 69 |     
 70 |     // MARK: Init
 71 |     
 72 |     override init(frame: CGRect) {
 73 |         super.init(frame: frame)
 74 |         commonInit()
 75 |     }
 76 |     
 77 |     required init?(coder aDecoder: NSCoder) {
 78 |         super.init(coder: aDecoder)
 79 |         commonInit()
 80 |     }
 81 |     
 82 |     private func commonInit() {
 83 |         
 84 |         textLayer.truncationMode = .end
 85 |         textLayer.contentsScale = UIScreen.main.scale
 86 |         layer.addSublayer(textLayer)
 87 |     }
 88 |     
 89 |     // MARK: Lifecycle
 90 |     
 91 |     override func layoutSubviews() {
 92 |         super.layoutSubviews()
 93 |         textLayer.frame = bounds
 94 |     }
 95 |     
 96 |     override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {
 97 |         super.traitCollectionDidChange(previousTraitCollection)
 98 |         
 99 |         guard traitCollection.preferredContentSizeCategory != previousTraitCollection?.preferredContentSizeCategory else {
100 |             return
101 |         }
102 |         reloadTextLayerForCurrentFont()
103 |     }
104 |     
105 |     private func reloadTextLayerForCurrentFont() {
106 |         if adjustsFontForContentSizeCategory, let font = font, let textStyle = font.fontDescriptor.object(forKey: .textStyle) as? UIFont.TextStyle {
107 |             let font = UIFontMetrics(forTextStyle: textStyle).scaledFont(for: font)
108 |             textLayer.font = font
109 |             textLayer.fontSize = font.pointSize
110 |         } else {
111 |             textLayer.font = font
112 |             textLayer.fontSize = font?.pointSize ?? 17.0
113 |         }
114 |         invalidateIntrinsicContentSize()
115 |         superview?.setNeedsLayout()
116 |         superview?.layoutIfNeeded()
117 |     }
118 | }
119 | 
120 | private extension AnimateableLabel {
121 |     
122 |     func caTextLayerAlignmentMode(from alignment: NSTextAlignment?) -> CATextLayerAlignmentMode? {
123 |         guard let alignment = alignment else {
124 |             return nil
125 |         }
126 |         switch alignment {
127 |         case .center:
128 |             return .center
129 |         case .justified:
130 |             return .justified
131 |         case .natural:
132 |             return .natural
133 |         case .right:
134 |             return .right
135 |         default:
136 |             return .left
137 |         }
138 |     }
139 | }
140 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarView/TMBarViewFocusRect.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  TMBarViewFocusRect.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 04/09/2018.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | 
 11 | /// Rect struct similar to CGRect that provides ability to take factors such as capacity and position into account.
 12 | internal struct TMBarViewFocusRect {
 13 |     
 14 |     // MARK: Properties
 15 |     
 16 |     private let rect: CGRect
 17 |     private let maxRect: CGRect
 18 |     private let position: CGFloat
 19 |     private let capacity: CGFloat
 20 |     private let layoutDirection: UIUserInterfaceLayoutDirection
 21 |     
 22 |     /// Origin of the original rect.
 23 |     var origin: CGPoint {
 24 |         return rect.origin
 25 |     }
 26 |     /// Size of the original rect.
 27 |     var size: CGSize {
 28 |         return rect.size
 29 |     }
 30 |     
 31 |     // MARK: Init
 32 |     
 33 |     /// Create a FocusRect with an original CGRect at a position.
 34 |     ///
 35 |     /// - Parameters:
 36 |     ///   - rect: The original rect.
 37 |     ///   - position: The current page position.
 38 |     ///   - capacity: The capacity to use.
 39 |     ///   - layoutDirection: Layout direction of the user interface.
 40 |     init(rect: CGRect, maxRect: CGRect, at position: CGFloat, capacity: Int, layoutDirection: UIUserInterfaceLayoutDirection) {
 41 |         self.rect = rect
 42 |         self.maxRect = maxRect
 43 |         self.position = position
 44 |         self.capacity = CGFloat(capacity - 1) // Rect capacity is actually zero indexed
 45 |         self.layoutDirection = layoutDirection
 46 |     }
 47 |     
 48 |     /// Get the rect of the FocusRect accounting for additional factors.
 49 |     ///
 50 |     /// - Parameter isProgressive: Whether the rect should be displayed as progressive (i.e. always increases from initial position)
 51 |     /// - Parameter includeOverscroll: Whether to include overscrolling if relevant.
 52 |     /// - Returns: Rect with additional factors accounted for.
 53 |     func rect(isProgressive: Bool, overscrollBehavior: TMBarIndicator.OverscrollBehavior) -> CGRect {
 54 |         switch isProgressive {
 55 |         case true:
 56 |             return progressiveRect(with: overscrollBehavior, for: rect)
 57 |             
 58 |         case false:
 59 |             return rect(with: overscrollBehavior, for: rect)
 60 |         }
 61 |     }
 62 | }
 63 | 
 64 | private extension TMBarViewFocusRect {
 65 |     
 66 |     func rect(with overscrollBehavior: TMBarIndicator.OverscrollBehavior,
 67 |               for rect: CGRect) -> CGRect {
 68 |         var rect = rect
 69 |         let isLeftToRight = layoutDirection == .leftToRight
 70 |         
 71 |         switch overscrollBehavior {
 72 |             
 73 |         case .bounce:
 74 |             if position < 0.0 {
 75 |                 let xOffset = rect.width * position
 76 |                 rect = rect.offsetBy(dx: isLeftToRight ? xOffset : -xOffset, dy: 0.0)
 77 |             } else if position > capacity {
 78 |                 let delta = position - capacity
 79 |                 let xOffset = rect.width * delta
 80 |                 rect = rect.offsetBy(dx: isLeftToRight ? xOffset : -xOffset, dy: 0.0)
 81 |             }
 82 |             
 83 |         case .compress:
 84 |             if position < 0.0 {
 85 |                 let delta = rect.width * position
 86 |                 if !isLeftToRight {
 87 |                     rect.origin.x -= delta
 88 |                 }
 89 |                 rect.size.width += delta
 90 |             } else if position > capacity {
 91 |                 let delta = rect.width * (position - capacity)
 92 |                 rect.size.width -= delta
 93 |                 if isLeftToRight {
 94 |                     rect.origin.x += delta
 95 |                 }
 96 |             }
 97 |             
 98 |         default:
 99 |              break
100 |         }
101 |         return rect
102 |     }
103 |     
104 |     func progressiveRect(with overscrollBehavior: TMBarIndicator.OverscrollBehavior,
105 |                          for rect: CGRect) -> CGRect {
106 |         var rect = rect
107 |         let isLeftToRight = layoutDirection == .leftToRight
108 |         
109 |         if isLeftToRight {
110 |             rect.size.width += rect.origin.x
111 |             rect.origin.x = 0.0
112 |         } else {
113 |             rect.size.width = maxRect.size.width - rect.origin.x
114 |         }
115 |         
116 |         switch overscrollBehavior {
117 |         case .bounce, .compress:
118 |             if position < 0.0 {
119 |                 let delta = rect.width * position
120 |                 if !isLeftToRight {
121 |                     rect.origin.x -= delta
122 |                 }
123 |                 rect.size.width +=  delta
124 |             } else if position > capacity && overscrollBehavior != .compress {
125 |                 let delta = position - capacity
126 |                 let xOffset = (maxRect.size.width - rect.width) * delta
127 |                 rect = rect.offsetBy(dx: isLeftToRight ? xOffset : -xOffset, dy: 0.0)
128 |             }
129 |             
130 |         default:
131 |             break
132 |         }
133 |         return rect
134 |     }
135 | }
136 | 


--------------------------------------------------------------------------------
/Sources/Tabman/Bar/BarItem/TMBarItem.swift:
--------------------------------------------------------------------------------
  1 | //
  2 | //  TMBarItem.swift
  3 | //  Tabman
  4 | //
  5 | //  Created by Merrick Sapsford on 06/06/2018.
  6 | //  Copyright © 2022 UI At Six. All rights reserved.
  7 | //
  8 | 
  9 | import UIKit
 10 | 
 11 | internal let TMBarItemableNeedsUpdateNotification = Notification.Name(rawValue: "TMBarItemableNeedsUpdateNotification")
 12 | 
 13 | /// Definition of an item that can be displayed in a `TMBar`.
 14 | ///
 15 | /// Properties of a `TMBarItemable` are optionally displayed in a `TMBar` depending on the layout / configuration.
 16 | ///
 17 | /// Tabman adds extensions to UIKit components to natively support `TMBarItemable`, such as `UINavigationItem` and
 18 | /// `UITabBarItem`. Therefore for example, simply returning a `UIViewController` `navigationItem` as a `TMBarItemable` is
 19 | /// fully supported.
 20 | public protocol TMBarItemable: AnyObject {
 21 |     
 22 |     /// Title of the item.
 23 |     var title: String? { get set }
 24 |     /// Image to display.
 25 |     ///
 26 |     /// - Note: If you want the image to be colored by tint colors when within a `TMBar`, you must use the `.alwaysTemplate` image rendering mode.
 27 |     /// - Warning: The usage of this property is dependent on the type of `TMBarButton` within the bar.
 28 |     var image: UIImage? { get set }
 29 |     
 30 |     /// Image for the selected state.
 31 |     ///
 32 |     /// - Warning: The usage of this property is dependent on the type of `TMBarButton` within the bar.
 33 |     var selectedImage: UIImage? { get set }
 34 |     
 35 |     /// Badge value to display.
 36 |     var badgeValue: String? { get set }
 37 | 
 38 |     /// Returns a short description of the button.
 39 |     var accessibilityLabel: String? { get set }
 40 | 
 41 |     /// A brief description of the result of performing an action on the accessibility element, in a localized string.
 42 |     var accessibilityHint: String? { get set }
 43 |     
 44 |     /// Inform the bar that the item has been updated.
 45 |     ///
 46 |     /// This will notify any button that is responsible for the item
 47 |     /// that it requires updating, and will call `populate(for: item)`.
 48 |     /// The bar indicator position will also be reloaded to reflect any
 49 |     /// layout updates.
 50 |     func setNeedsUpdate()
 51 | }
 52 | 
 53 | extension TMBarItemable {
 54 |     
 55 |     public func setNeedsUpdate() {
 56 |         NotificationCenter.default.post(name: TMBarItemableNeedsUpdateNotification, object: self)
 57 |     }
 58 | }
 59 | 
 60 | /// :nodoc:
 61 | extension TMBarItemable {
 62 |     
 63 |     // swiftlint:disable unused_setter_value
 64 | 
 65 |     public var accessibilityLabel: String? {
 66 |         get {
 67 |             return nil
 68 |         }
 69 |         set {}
 70 |     }
 71 |     
 72 |     public var accessibilityHint: String? {
 73 |         get {
 74 |             return nil
 75 |         }
 76 |         set {}
 77 |     }
 78 | }
 79 | 
 80 | /// Default `TMBarItemable` that can be displayed in a `TMBar`.
 81 | open class TMBarItem: TMBarItemable {
 82 |     
 83 |     // MARK: Properties
 84 |     
 85 |     open var title: String? {
 86 |         didSet  {
 87 |             setNeedsUpdate()
 88 |         }
 89 |     }
 90 |     
 91 |     open var image: UIImage?  {
 92 |         didSet {
 93 |             setNeedsUpdate()
 94 |         }
 95 |     }
 96 |     
 97 |     open var selectedImage: UIImage?  {
 98 |         didSet {
 99 |             setNeedsUpdate()
100 |         }
101 |     }
102 |     
103 |     open var badgeValue: String? {
104 |         didSet {
105 |             setNeedsUpdate()
106 |         }
107 |     }
108 | 
109 |     public var accessibilityLabel: String? {
110 |         didSet {
111 |             setNeedsUpdate()
112 |         }
113 |     }
114 | 
115 |     public var accessibilityHint: String? {
116 |         didSet {
117 |             setNeedsUpdate()
118 |         }
119 |     }
120 | 
121 |     public var isAccessibilityElement: Bool { return true }
122 |         
123 |     // MARK: Init
124 |     
125 |     /// Create an Item with a title.
126 |     ///
127 |     /// - Parameters:
128 |     ///   - title: Title of the item.
129 |     ///   - badgeValue: Badge value to display.
130 |     public convenience init(title: String, badgeValue: String? = nil) {
131 |         self.init(with: title, image: nil, selectedImage: nil, badgeValue: badgeValue)
132 |     }
133 |     
134 |     /// Create an Item with an image.
135 |     ///
136 |     /// - Parameters:
137 |     ///   - image: Image of the item.
138 |     ///   - selectedImage: Image of the item when selected.
139 |     ///   - badgeValue: Badge value to display.
140 |     public convenience init(image: UIImage, selectedImage: UIImage? = nil, badgeValue: String? = nil) {
141 |         self.init(with: nil, image: image, selectedImage: selectedImage, badgeValue: badgeValue)
142 |     }
143 |     
144 |     /// Create an Item with a title and an image.
145 |     ///
146 |     /// - Parameters:
147 |     ///   - title: Title of the item.
148 |     ///   - image: Image of the item.
149 |     ///   - selectedImage: Image of the item when selected.
150 |     ///   - badgeValue: Badge value to display.
151 |     public convenience init(title: String, image: UIImage, selectedImage: UIImage? = nil, badgeValue: String? = nil) {
152 |         self.init(with: title, image: image, selectedImage: selectedImage, badgeValue: badgeValue)
153 |     }
154 |     
155 |     private init(with title: String?, image: UIImage?, selectedImage: UIImage?, badgeValue: String?) {
156 |         self.title = title
157 |         self.image = image
158 |         self.selectedImage = selectedImage
159 |         self.badgeValue = badgeValue
160 |     }
161 | }
162 | 


--------------------------------------------------------------------------------