SwiftUIX: An extension to the standard SwiftUI library.

SwiftUIX attempts to fill the gaps of the still nascent SwiftUI framework, providing an extensive suite of components, extensions and utilities to complement the standard library. This project is by far the most complete port of missing UIKit/AppKit functionality, striving to deliver it in the most Apple-like fashion possible.

Why
Requirements
Installation
Contents
Contributing
License
Support
Credits

Why

The goal of this project is to complement the SwiftUI standard library, offering hundreds of extensions and views that empower you, the developer, to build applications with the ease promised by the revolution that is SwiftUI.

Requirements

iOS 13, macOS 10.15, tvOS 13, or watchOS 6
Swift 5.3
Xcode 12

Installation

The preferred way of installing SwiftUIX is via the Swift Package Manager.

Xcode 11 integrates with libSwiftPM to provide support for iOS, watchOS, and tvOS platforms.

In Xcode, open your project and navigate to File → Swift Packages → Add Package Dependency...
Paste the repository URL (https://github.com/SwiftUIX/SwiftUIX) and click Next.
For Rules, select Branch (with branch set to master).
Click Finish.
Open the Project settings, add SwiftUI.framework to the Linked Frameworks and Libraries, set Status to Optional.

All documentation is available via the repository wiki.

While the project itself is stable and heavily being used in production, its documentation is work-in-progress. Contributions are encouraged and welcomed.

UIKit → SwiftUI

UIKit	SwiftUI	SwiftUIX
`UIActivityIndicatorView`	-	`ActivityIndicator`
`UIActivityViewController`	-	`AppActivityView`
`UIBlurEffect`	-	`BlurEffectView`
`UICollectionView`	-	`CollectionView`
`UIDeviceOrientation`	-	`DeviceLayoutOrientation`
`UIImagePickerController`	-	`ImagePicker`
`UIPageViewController`	-	`PaginationView`
`UIScreen`	-	`Screen`
`UISearchBar`	-	`SearchBar`
`UIScrollView`	`ScrollView`	`CocoaScrollView`
`UISwipeGestureRecognizer`	-	`SwipeGestureOverlay`
`UITableView`	`List`	`CocoaList`
`UITextField`	`TextField`	`CocoaTextField`
`UIModalPresentationStyle`	-	`ModalPresentationStyle`
`UIViewControllerTransitioningDelegate`	-	`UIHostingControllerTransitioningDelegate`
`UIVisualEffectView`	-	`VisualEffectView`
`UIWindow`	-	`WindowOverlay`

Activity

ActivityIndicator

ActivityIndicator()
    .animated(true)
    .style(.large)

AppActivityView - a SwiftUI port for UIActivityViewController.

AppActivityView(activityItems: [...])
    .excludeActivityTypes([...])
    .onCancel { }
    .onComplete { result in
        foo(result)
    }

Appearance

View#visible(_:) - Sets a view's visibility.

Error Handling

TryButton - A button capable of performing throwing functions.

Geometry

flip3D(_:axis:reverse:) - Flips this view.
RectangleCorner - A corner of a Rectangle.
ZeroSizeView - A zero-size view for when EmptyView just doesn't work.

Keyboard

Keyboard - An object representing the keyboard.
View#padding(.keyboard) - Pads this view with the active system height of the keyboard.

Navigation

View#navigationBarColor(_:) - Configures the color of the navigation bar for this view.
View#navigationBarTranslucent(_:) - Configures the translucency of the navigation bar for this view.
View#navigationBarTransparent(_:) - Configures the transparency of the navigation bar for this view.

Pagination

PaginationView

PaginationView(axis: .horizontal) {
    ForEach(0..<10, id: \.hashValue) { index in
        Text(String(index))
    }
}
.currentPageIndex($...)
.pageIndicatorAlignment(...)
.pageIndicatorTintColor(...)
.currentPageIndicatorTintColor(...)

Scrolling

View#isScrollEnabled(_:) - Adds a condition that controls whether users can scroll within this view. Works with:
- CocoaList
- CocoaScrollView
- CollectionView
- TextView
Does not work with SwiftUI's ScrollView.

Search

SearchBar - A SwiftUI port for UISearchBar.

struct ContentView: View {
    @State var isEditing: Bool = false
    @State var searchText: String = ""
    
    var body: some View {
        SearchBar("Search...", text: $searchText, isEditing: $isEditing)
            .showsCancelButton(isEditing)
            .onCancel { print("Canceled!") }
    }
}

View#navigationSearchBar(_:) - Sets the navigation search bar for this view.

Text("Hello, world!")
    .navigationSearchBar {
        SearchBar("Placeholder", text: $text)
    }

Screen

Screen - A representation of the device's screen.
UserInterfaceIdiom - A SwiftUI port for UIUserInterfaceIdiom.
UserInterfaceOrientation - A SwiftUI port for UserInterfaceOrientation.

Status Bar

View#statusItem(id:image:) - Adds a status bar item configured to present a popover when clicked

Text("Hello, world!")
    .statusItem(id: "foo", image: .system(.exclamationmark)) {
        Text("Popover!")
            .padding()
    }

Text

TextView

TextView("placeholder text", text: $text, onEditingChanged: { editing in
    print(editing)
})

Visual Effects

VisualEffectBlurView - A blur effect view that expands to fill.

VisualEffectBlurView(blurStyle: .dark)
    .edgesIgnoringSafeArea(.all)

Window

View#windowOverlay(isKeyAndVisible:content:) - Makes a window key and visible when a given condition is true.

Contributing

SwiftUIX welcomes contributions in the form of GitHub issues and pull-requests. Please refer the projects section before raising a bug or feature request, as it may already be under progress.

To create an Xcode project for SwiftUIX run bundle install; bundle exec fastlane generate_xcodeproj. To check the automated builds for SwiftUIX run bundle install; bundle exec fastlane build.

License

SwiftUIX is licensed under the MIT License.

Support

SwiftUIX is and will always be free and open. Maintaining SwiftUIX, however, is a time-consuming endeavour. If you're reliant on SwiftUIX for your app/project and would like to see it grow, consider contributing/donating as way to help.

Credits

SwiftUIX is a project of @vmanot.

Thambich89/SwiftUIX