https://github.com/samdawes/SegmentedControlPageView

Native Segmented Control + Page View implementation for SwiftUI. Supports iOS/iPadOS 13+ and visionOS 1+
https://github.com/samdawes/SegmentedControlPageView

ios ios-app ios13 ipados page-view pageview pageviewcontroller segmented-control segmentedcontrol swift swift-package swiftpackage swiftui swiftui-example visionos visionos-animation visionos-interaction

Last synced: 2 months ago
JSON representation

Native Segmented Control + Page View implementation for SwiftUI. Supports iOS/iPadOS 13+ and visionOS 1+

• Host: GitHub
• URL: https://github.com/samdawes/SegmentedControlPageView
• Owner: samdawes
• License: mit
• Created: 2024-02-03T17:35:00.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-02-24T21:11:35.000Z (10 months ago)
• Last Synced: 2024-07-30T20:59:25.285Z (5 months ago)
• Topics: ios, ios-app, ios13, ipados, page-view, pageview, pageviewcontroller, segmented-control, segmentedcontrol, swift, swift-package, swiftpackage, swiftui, swiftui-example, visionos, visionos-animation, visionos-interaction
• Language: Swift
• Homepage:
• Size: 26.4 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# SegmentedControlPageView

**Offers a seamless integration of a segmented control and a page view in native SwiftUI applications**. Users can navigate between pages by swiping or tapping on segments in the control. Compatible with iOS 13+ and visionOS 1+. 

![2024-02-18 18 34 46](https://github.com/samdawes/SegmentedControlPageView/assets/12502222/23e2b34f-e332-44e8-a47f-c463710e21db)

![2024-02-18 18 54 14](https://github.com/samdawes/SegmentedControlPageView/assets/12502222/bcf97d3e-2563-4bcc-906c-fa4a2f54e264)

## Usage

The following example shows a possible onboarding process. The segmented control has three segments with the labels `Welcome`, `Features`, and `Next Steps` that correspond to three custom SwiftUI views: `WelcomeView()`, `FeaturesView()`, and `NextStepsView()`.

```swift

import SegmentedControlPageView

@State var currentSelection: Int = 0

SegmentedControlPageView(

  "Onboarding Process",

  selection: $currentSelection,

  labels: [

    "Welcome",

    "Features",

    "Next Steps"

  ],

  pages: [

    WelcomeView(),

    FeaturesView(),

    NextStepsView()

  ]

)

```

If you'd like to use the page view without the segmented control, initialize a `PageView` in your project. This will fall back to a UIKit implementation for older versions of iOS, to ensure consistency on all versions.

```swift

PageView([

  WelcomeView(),

  FeaturesView(),

  NextStepsView()

], selection: $currentSelection)

```

## Requirements

- iOS 13.0 or later

- visionOS 1.0 or later

## Installation

### Swift Package Manager

In Xcode go to Project -> Your Project Name -> `Package Dependencies` -> Tap _Plus_. Insert url:

```

https://github.com/samdawes/SegmentedControlPageView

```

or add it to the `dependencies` section in your `Package.swift` file:

```swift

dependencies: [

    .package(url: "https://github.com/samdawes/SegmentedControlPageView", .upToNextMajor(from: "1.0.0"))

]

```

### Manually

If you prefer not to use Swift Package Manager, you can integrate manually. Put the `Sources/SegmentedControlPageView` folder in your Xcode project. Make sure to enable `Copy items if needed` and `Create groups`.

## Apps Using

If your app uses `SegmentedControlPageView`, don't hesitate to add yours to the list!

- [LineTime for Disneyland](https://apps.apple.com/us/app/linetime-for-disneyland/id1462481042)

- [LineTime for Disney World](https://apps.apple.com/us/app/linetime-for-disney-world/id1530744555)