https://github.com/ryanrudes/moreui

A comprehensive suite of practical extensions to the SwiftUI standard library.
https://github.com/ryanrudes/moreui

compatibility extension ios ipados library macos package swift swift-package swift-package-manager swiftui tvos uikit watchos

Last synced: 9 months ago
JSON representation

A comprehensive suite of practical extensions to the SwiftUI standard library.

• Host: GitHub
• URL: https://github.com/ryanrudes/moreui
• Owner: ryanrudes
• License: mit
• Created: 2021-10-11T22:30:45.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2021-11-14T20:22:09.000Z (over 4 years ago)
• Last Synced: 2025-09-02T03:55:28.594Z (9 months ago)
• Topics: compatibility, extension, ios, ipados, library, macos, package, swift, swift-package, swift-package-manager, swiftui, tvos, uikit, watchos
• Language: Swift
• Homepage:
• Size: 231 KB
• Stars: 14
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# MoreUI

MoreUI is a comprehensive extension to the SwiftUI standard library to enhance app development in SwiftUI; it bridges the gap between UIKit and SwiftUI by bringing the incredible extensiveness of UIKit into SwiftUI while maintaining the simplicity that makes SwiftUI special. It includes a vast number of unimplemented view controllers still not available as SwiftUI Views in the standard library. It alleviates the nuisance of manually interfacing with UIKit, and expands what's possible with pure SwiftUI. It also features a large collection of original views and capabilities that are highly practical for SwiftUI app development.

**MoreUI is presently under development**

# Contents

Documentation is currently a work-in-progress, available via the [repository wiki](https://github.com/ryanrudes/MoreUI/wiki).

### UIKit → SwiftUI 

| UIKit                                   | MoreUI                                     | Status     |

| --------------------------------------- | ------------------------------------------ | ---------- |

| `UIReferenceLibraryViewController`      | `ReferenceLibrary`                         | Completed  |

| `PHPickerViewController`                | `PhotoPicker`                              | Completed  |

| `UIImagePickerController`               | `ImagePicker`                              | W.I.P.     |

| `UISearchBar`                           | `SearchBar`                                | Completed  |

| `UIPageViewController`                  | `PageView`                                 | W.I.P.     |

| `UIVideoEditorController`               | `VideoEditor`                              | W.I.P.     |

| `UIFontPickerViewController`            | `FontPicker`                               | Completed  |

| `UIDocumentBrowserViewController`       | `DocumentBrowser`                          | W.I.P.     |

| `UIDocumentPickerViewController`        | `DocumentPicker`                           | Completed  |

| `UIDocumentInteractionController`       | `DocumentInteractor`                       | W.I.P.     |

| `UICloudSharingController`              | `CloudSharingView`                         | W.I.P.     |

| `UIActivityViewController`              | `ActivityView`                             | W.I.P.     |

| `UIPrinterPickerController`             | `PrinterPicker`                            | W.I.P.     |

| `UISegmentedControl`                    | `SegmentedControl`                         | W.I.P.     |

| `UIFeedbackGenerator`                   | `Feedback` & `HapticGenerator`             | Completed  |

| `MFMessageComposeViewController`        | `MessageComposer`                          | W.I.P.     |

| `CNContactViewController`               | `ContactView`                              | W.I.P.     |

| `CNContactPickerViewController`         | `ContactPicker`                            | W.I.P.     |

| `EKEventViewController`                 | `EventView`                                | W.I.P.     |

| `EKEventEditViewController`             | `EventEditor`                              | W.I.P.     |

| `EKCalendarChooser`                     | `CalendarPicker`                           | Completed  |

| `QLPreviewView`                         | `QuickLook`                                | W.I.P.     |

### Original SwiftUI Views

| View                                    | Description                                                         | Status     |

| --------------------------------------- | ------------------------------------------------------------------- | ---------- |

| `RangeSlider`                           | Two-handle slider for selecting an interval of values.              | W.I.P.     |

| `PinchView`                             | View wrapper that enables scaling via the pinch gesture.            | Completed  |

| `PIPView`                               | View wrapper to present video content in picture-in-picture mode.   | W.I.P.     |

| `SFSymbolPicker`                        | Picker for the selection of SFSymbols.                              | Completed  |

| `Toast`                                 | View for presenting Apple-style toast alerts (new in iOS 15).       | W.I.P.     |

| `SpeechRecognizer`                      | View wrapper for performing actions according to dictated input.    | Completed  |

| `TimeIntervalPicker`                    | A wheel picker for selecting a time interval, as seen in Clock app. | W.I.P.     |

| `ModalLink`                             | A navigation link that presents a view modally.                     | W.I.P.     |

| `Stopwatch`                             | A stopwatch view as seen in the Clock app native to iOS.            | W.I.P.     |

### Original SwiftUI Capabilities

| Feature                                 | Description                                                         | Status     |

| --------------------------------------- | ------------------------------------------------------------------- | ---------- |

| `Animation.wiggle`                      | Wiggle animation, resembles shaking icons when editing home screen. | W.I.P.     |

| `.toast()`                              | View modifier for presenting alert toasts.                          | W.I.P.     |

| `.pip()`                                | View modifier for presenting content in picture-in-picture mode.    | W.I.P.     |

| `\.notificationCenter`                  | Environment value for delivering notifications.                     | Completed  |

| `Feedback` & `HapticGenerator`          | Custom property wrapper for triggering haptic feedback.             | Completed  |

| `.documentPicker()`                     | Sheet for presenting a document picker.                             | Completed  |

| `.referenceLibrary()`                   | Sheet for presenting a reference library.                           | Completed  |

| `.pinchToZoom()`                        | View modifier to allow view scaling via a magnification gesture.    | Completed  |

| `Ringtone`                              | Environment value for playing system and user-downloaded ringtones. | W.I.P.     |

| `SystemSound`                           | Environment value for playing system sounds.                        | W.I.P.     |

| `.stopwatchStyle()`                     | Either `.digital` or `.graphical`.                                  | W.I.P.     |

| `Font.Family`                           | Font families for safe text view modifiers (no str in init).        | W.I.P.     |

| `\.bluetooth`                           | Environment value for handling Bluetooth IO.                        | W.I.P.     |

### Notifications

MoreUI features the scheduling of local notifications for delivery by exposing an extended `UNUserNotificationCenter` through a new environment value, `\.notificationCenter`. See the basic implementation below.

```swift

struct ContentView: View {

    @Environment(\.notificationCenter) var notificationCenter

    

    var body: some View {

        Button("Send Notification") {

            notificationCenter.post(title: "My Notification",

                                    subtitle: "A brief description",

                                    body: "Some more info.",

                                    trigger: {

                let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 3, repeats: false)

                return trigger

            })

        }

    }

}

```

https://user-images.githubusercontent.com/18452581/140665813-b26292f4-f042-4082-82e6-3c9fbb0ed4dd.mp4

You can customize all properties exposed by `UNNotificationContent`, including the badge, sound, optional attachments, and much more. In addition, you can customize the trigger, as in, how the system delivers the notification.

All in all, here's a succinct documentation of the notification delivery method, `post()`:

- Parameters:

    - `title`: The localized title, containing the reason for the alert.

    - `subtitle`: The localized subtitle, containing a secondary description of the reason for the alert.

    - `body`: The localized message to display in the notification alert.

    - `badge`: The number to apply to the app’s icon.

    - `sound`: The sound to play when the system delivers the notification.

    - `launchImageName`: The name of the custom launch image to display when the system launches your app in response to the notification.

    - `userInfo`: A dictionary of custom information associated with the notification.

    - `attachments`: An array of attachments to display in an alert-based notification.

    - `summaryArgument`: The string the notification adds to the category’s summary format string. This argument has been deprecated starting in iOS 15.0.

    - `summaryArgumentCount`: The number of items the notification adds to the category’s summary format string. This argument has been deprecated starting in iOS 15.0.

    - `categoryIdentifier`: The identifier of the category object that represents the notification’s type.

    - `threadIdentifier`: An identifier that you use to group related notifications together.

    - `targetContentIdentifier`: A value your app uses to identify the notification content.

    - `interruptionLevel`: The interruption level determines the degree of interruption associated with the notification.

    - `relevanceScore`: The value the system uses to sort your app’s notifications.

    - `options`: The authorization options your app is requesting. You may combine the available constants to request authorization for multiple items. Request only the authorization options that you plan to use. For a list of possible values, see ``UNAuthorizationOptions``. Some notification options are handled automatically based on the specification of other parameters, such as `.badge`, `.sound`, `.criticalAlert`, and `.alert`. These do not need to be specified manually by the user.

    - `trigger`: A function returning the condition that causes the system to deliver the notification. Specify `nil` to deliver the notification right away. See ``UNNotificationTrigger`` for documentation on concrete trigger classes.

### Word Reference Library

MoreUI brings `UIReferenceLibraryViewController` into SwiftUI as `ReferenceLibrary`. It also adds a view modifier `.referenceLibrary` similar to `.sheet` and `.fullScreenCover` for presenting a reference library. Here's an example:

```swift

struct ContentView: View {

    @State var term = ""

    @State var isPresented = false

    @State var showingAlert = false

    

    var body: some View {

        Form {

            TextField("Term", text: $term)

                .textInputAutocapitalization(.never)

                .onSubmit {

                    guard !term.isEmpty else { return }

                    

                    if dictionaryHasDefinition(forTerm: term) {

                        isPresented = true

                    } else {

                        showingAlert = true

                    }

                }

        }

        .referenceLibrary(term: $term,

                          isPresented: $isPresented,

                          onDismiss: didDismiss)

        .alert("No definition found for \"\(term)\"", isPresented: $showingAlert) {

            Button("OK", role: .cancel) { }

        }

    }

    

    func didDismiss() {

        // Handle the dismissing action.

    }

}

```

https://user-images.githubusercontent.com/18452581/140837265-b8f18ff8-b09f-45a0-a9a3-2d647c50f5f7.mp4

### Range Slider

MoreUI adds a two-handle slider, but for selecting a closed *interval* of values, rather than just a value in and of itself. The syntax if mostly identical to `Slider`. It accepts either a `ClosedRange` as `interval` or separate lower and upper bounds as `lower` and `upper`, respectively. For instance:

```swift

struct ContentView: View {

    @State var interval: ClosedRange = 25...75

    

    var body: some View {

        RangeSlider(interval: $interval,

                    in: 0...100,

                    step: 10) {

            Label("Label", systemImage: "circle.hexagongrid.fill")

                .symbolRenderingMode(.multicolor)

        } minimumValueLabel: {

            Text("0")

        } maximumValueLabel: {

            Text("100")

        } onEditingChanged: { isEditing in

            didEditingChange(isEditing)

        }

        .padding(.horizontal)

    }

    

    func didEditingChange(_ isEditing: Bool) {

        // Handle editing change.

    }

}

```

https://user-images.githubusercontent.com/18452581/140848619-efb0987f-5655-405a-b456-ca2474b75c8a.mp4

# License

MoreUI is licensed under the [MIT License](https://github.com/ryanrudes/MoreUI/blob/main/LICENSE).

# Credits

MoreUI is a project of [@ryanrudes](httpsL//github.com/ryanrudes).

# Related Projects

- [SwiftUIX](https://github.com/SwiftUIX/SwiftUIX)

- [PhantomKit](https://github.com/pawello2222/PhantomKit)