SwiftUIExtensions

1.0.0

Provides extensions and utilities for SwiftUI
xiiagency/SwiftUIExtensions

What's New

1.0.0

2022-05-05T18:54:13Z

Initial public release

SwiftUIExtensions Library

GitHub

An open source library with utilities and extensions for SwiftUI.

Developed as re-usable components for various projects at XII's iOS, macOS, and watchOS applications.

Installation

Swift Package Manager

  1. In Xcode, select File > Swift Packages > Add Package Dependency.
  2. Follow the prompts using the URL for this repository
  3. Select the SwiftUIExtensions library to add to your project

Dependencies

License

See the LICENSE file.

Text case shorthands (Source)

extension View {
  func standardcase() -> some View

  func uppercase() -> some View

  func lowercase() -> some View
}

Shorthand for applying the textCase ViewModifier.

Shorthand for stretching Views (Source)

extension Axis.Set {
  static let None: Axis.Set
  static let Horizontal: Axis.Set
  static let Vertical: Axis.Set
  static let All: Axis.Set
}

extension View {
  func stretch(
    _ axes: Axis.Set = [.horizontal],
    alignment: Alignment = .center
  ) -> some View
}

Sets the view's frame to stretch to fill its parent by setting maxWidth (and/or) maxHeight based on the requested Axis.

  • By default it will stretch .Horizontal as it's the more common scenario
  • Also allows for adjusting internal alignment with .center used as the default

ScenePhase change shorthand (Source)

extension View {
  func onScenePhaseChanged(
    _ action: @escaping (ScenePhase) -> Void
  ) -> some View
}

Calls an action when the ScenePhase has changed. Avoid performing long-running tasks in action since it is called from the main thread.

URL open helpers

Cross platform (iOS + macOS)

func sendUserToApplicationUrl(_ url: URL)

func sendUserToApplicationUrl(_ urlString: String)

iOS only

func sendUserToApplicationSettings()

iOS keyboard helpers (Source)

func hideKeyboard()

HiddenView shorthand (Source)

struct HiddenView : View {
  init()

  var body: some View { get }
}

A specialty view that has no visible representation (clear 0x0 pixel view) but can still have functionality attached (e.g. onChange(of:)).

NOTE: If used in a container view that has spacing (e.g. VStack) this view will still be counted as one and will add unintended spacing.

Avoid animations (Source)

func doWithoutAnimations(_ block: @escaping () -> Void)

Performs the provided block in a transaction with animations disabled.

Useful for cancelling some animations that are hard to control (e.g. navigation view transitions).

NOTE: This is a bit finicky, use at your own risk.

MomentarySwitch Utility (Source)

class MomentarySwitch {
  init()

  func trigger(
    offDelaySeconds: Double = 0.0,
    switchOn: @escaping () -> Void,
    switchOff: @escaping () -> Void
  )
}

An implementation of a momentary switch: one that has an on/off state, can be turned on repeatedly, turns off after a delay. If triggered multiple times before the off delay is elapses, it re-schedules the reaction (relative to the last time it was triggered). Ideally used for triggering animations on user interaction, and auto-reverting once they've stopped interacting for enough time.

NOTE: The switch itself will operate on the background thread, but the on/off callbacks are executed on the @MainActor.

Description

  • Swift Tools 5.5.0
View More Packages from this Author

Dependencies

Last updated: Fri May 06 2022 12:32:16 GMT-0500 (GMT-05:00)