SUIKit 0.2.1

SUIKit 0.2.1

×

Maintained by mxcat..

SUIKit 0.2.1

SUIKit 🍯

CI Status Version License Platform

SwiftUI-like declarative UIKit based framework.

SwiftUI is great but still lacks some useful features of UIKit and doesn't support older versions of iOS. This framework will allow you to use UIKit in a declarative way, pretty similar to SwiftUI, but with support of iOS11+ and well-known behavior of the system.

Usage

import SUIKit

class ViewController: UIViewController {
    
    var label: UILabel?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setup()
    }
    
    func setup() {
        view.ui.add {
            UIView {
                UIView {
                    UILabel(text: "1").ui
                        .frame(x: 0, y: 44, width: CGRect.screen.width, height: 20)
                        .link(to: &label)
                        .view
                    UILabel(text: "2").ui
                        .frame(x: 44, y: 88, width: CGRect.screen.width, height: 20)
                        .view
                }
                UILabel(text: "3").ui
                    .frame(x: 88, y: 132, width: CGRect.screen.width, height: 20)
                    .view
                UILabel(text: "4").ui
                    .frame(x: 132, y: 176, width: CGRect.screen.width, height: 20)
                    .view
                UILabel(text: "5").ui
                    .frame(x: 176, y: 220, width: CGRect.screen.width, height: 20)
                    .view
            }
            .ui
            .size(width: CGRect.screen.width, height: 100)
            .origin(x: 0, y: 0)
            .background(color: .red)
            .cornerRadius(18, corners: .bottom)
            .view
            UILabel(text: "6").ui
                .frame(x: 220, y: 264, width: CGRect.screen.width, height: 20)
                .view
            UILabel(text: "7").ui
                .frame(x: 264, y: 308, width: CGRect.screen.width, height: 20)
                .view
            UILabel(text: "8").ui
                .frame(x: 308, y: 352, width: CGRect.screen.width, height: 20)
                .view
        }
        .background(color: .yellow)
    }
    
}

(Working on new features and documentation)

Initialization

Custom initializers for ui elements, provided by SUIKit.

UIView
UIView {
    UIView()
}
UILabel
UILabel(text: "Label", alignment: .center, color: .black) {
    UIView()
}

ViewDSL

SUIKit provides some DSLs for interaction with your view's properties. You can access these DSLs via UIView().ui property, which returns a ViewDSL or it's successor's instance.

Requirements

  • ⌨️ XCode11+
  • 📱 iOS 11.0+

Installation

SUILayout is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'SUIKit'

and run pod install from the terminal.

License

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

To-do

  • Add DSL's for every UIView subclass.
  • Add convenience methods for user interaction, such as tapAction(_ execute: ()->Void)
  • Complete xcode documentation.
  • Provide more examples.
  • Add API for shadows.
  • Add more animation templates.
  • Add layout engine.
  • Make some API improvements.
  • Add some classes like SUIGradientView.
  • Provide DSLs for UIViewControllers.

Feel free to contribute or communicate. S(wift)UIKit is open to your ideas. 🌝