UIKitViews

UIKitViews is a SwiftUI wrapper around UIView and UIViewController. It provides seamless integration of UIKit components with the SwiftUI framework. The UIKitView wrapper makes it incredibly easy to add and manipulate UIKit views and view controllers directly from your SwiftUI views.
UIKitViews is built on top of VDChain and is part of the VDLayout library that provides DSL syntax for UIKit views and view controllers.

• Straightforward integration of UIKit components into SwiftUI environment
• Support for environment variables through UIView/UIViewController keypaths
• HostingView, an analog of UIHostingController for UIView that supports updating via keypath
• SelfSizingHostingController - a UIHostingController that matches the root view size
• Provides uiKitViewFixedSize() and uiKitViewContentMode() methods for dynamic self-sizing of UIKit views

Using UIKitViews is as simple as placing the UIView or UIViewController you want within the UIKitView closure:

UIKitView {
    UILabel().chain
       .font(.systemFont(ofSize: 24)) // Constant properties
       .textColor(.black)
}
.text(title) // Updatable properties

UIKitViews provides a special operator § that allows you to create a UIKitView more concisely with an autoclosure:

UILabel()§
  .font(.systemFont(ofSize: 24)) 
  .textColor(.black)
  .text(title)

UIKitView also supports environment variables through UIView/UIViewController keypaths:

VStack {
  UIKitView {
    UILabel()
  }
  UIKitView {
    UILabel()
  }
}
.uiKitViewEnvironment(\UILabel.font, .systemFont(ofSize: 24))

If you need to access the environment, you can do it like this:

@Environment(\UILabel.font) var uiLabelFont

You can also bind SwiftUI environments to UIKitView:

UIKitView {
   UIScrollView()
}
.uiKitViewBind(environment: \.isScrollEnabled, to: \UIScrollView.isScrollEnabled)

The library includes a method uiKitViewFixedSize() that allows the UIKit view to adjust its size dynamically according to its content. You can specify the axis for self-sizing:

• For self-sizing in both dimensions:

.uiKitViewFixedSize()

• For self-sizing mostly in the vertical dimension:

.uiKitViewFixedSize(.vertical)

• For self-sizing mostly in the horizontal dimension:

.uiKitViewFixedSize(.horizontal)

The uiKitViewContentMode(_:) method adjusts the content resizing behavior of a UIView when its size is not fixed. You pass a UIKitViewContentMode value to this method to specify how you want the view to resize its content.

It comes with two modes:

• .fill: The content should resize to completely fill the view. The aspect ratio may not be preserved.
• .fit(Alignment): The UIView should resize to fit within the view while preserving its aspect ratio. The alignment parameter determines how the UIView is positioned within the view if there is extra space.

Here's an example:

UIKitView {
    UILabel().chain
       .font(.system(34))
       .textColor(.black)
       .textAlignment(.left)
}
.uiKitViewFixedSize(.vertical)
.uiKitViewContentMode(.fit(.trailing))

In this example, the UILabel will resize its content to fit within its bounds while preserving its aspect ratio. The content is positioned at the trailing edge of the UIKitView.

The repository contains two other key features:

• HostingView: This is an analogy of UIHostingController for UIView. It supports updating by keypath.

struct SomeView: View {

  var text: String
  // ...
}
// ...
let hosting = HostingView(SomeView())
hosting.text = "new text" // it will update the view

• SelfSizingHostingController: This is an UIHostingController that matches the View size, allowing your views to automatically adjust to the size of their content.

1. Swift Package Manager

Create a Package.swift file.

// swift-tools-version:5.7
import PackageDescription

let package = Package(
  name: "SomeProject",
  dependencies: [
    .package(url: "https://github.com/dankinsoid/UIKitViews.git", from: "1.5.0")
  ],
  targets: [
    .target(name: "SomeProject", dependencies: ["UIKitView"])
  ]
)

$ swift build

2. CocoaPods

Add the following line to your Podfile:

pod 'UIKitViews'

and run pod update from the podfile directory first.

dankinsoid, voidilov@gmail.com

UIKitView is available under the MIT license. See the LICENSE file for more info.