Skip to content

Latest commit

 

History

History
263 lines (208 loc) · 5.29 KB

FormsUtilsUI.md

File metadata and controls

263 lines (208 loc) · 5.29 KB
Raw

FormsUtilsUI

FormsUtilsUI is a collection of extension and useful classes

Import

import FormsUtilsUI

Dependencies

FormsInjector.framework
FormsUtils.framework

Extensions

UIKit class extensions.

Bundle.swift
CGPoint.swift
CGRect.swift
CGSize.swift
Date.swift
Number.swift
String.swift
UIActivityIndicatorView.swift
UIAlertViewController.swift
UIApplicationShortcutIcon.swift
UIBezierPath.swift
UIButton.swift
UICollectionView.swift
UIColor.swift
UIEdgeInset.swift
UIImage.swift
UIImageView.swift
UILabel.swift
UINavigationController.swift
UIResponder.swift
UIScrollView.swift
UISearchBar.swift
UIStackView.swift
UIStatusBarStyle.swift
UITableView.swift
UITextField.swift
UIView.swift
UIViewController.swift
UIWindow.swift

Utils

Helper classes

AppLifecycleable

Available events

enum AppLifecycleEvent {
    case didEnterBackground
    case willEnterForeground
    case didFinishLaunching
    case didBecomeActive
    case willResignActive
    case didReceiveMemoryWarning
    case willTerminate
    case significantTimeChange
}

Usage

class SomeClass: AppLifecycleable {
    var appLifecycleableEvents: [AppLifecycleEvent] {
        return [.didEnterBackground, .willEnterForeground]
    }
    
    func appLifecycleable(event: AppLifecycleEvent) {
        switch event {
            case .didEnterBackground: // Some action
            case .willEnterForeground: // Some action
            default: break
        }
    }
}

Registration

let object = SomeClass()
object.registerAppLifecycle()

or

let object = SomeClass()
object.unregisterAppLifecycle()

By default Forms controllers supports implements AppLifecycleable. protocol

AttributedString

Generate clickable NSAttributedString

let attributedString = AttributedString()
    .with(color: UIColor.black)
    .with(font: UIFont.systemFont(ofSize: 16))
    .with(string: "Attributed label\n")
    .switchStyle() // change style only for next string
    .with(color: UIColor.lightGray)
    .with(underlineStyle: .single)
    .with(string: "Some NSAttributedString\n")
    .with(string: "Attributed label\n")
    .with(alignment: .center)
    .with(string: "Is centered\n")
    .with(string: "Is still centered\n")
    .with(string: "\n")
    .switchStyle() // change style only for next string
    .with(color: UIColor.red)
    .with(font: UIFont.boldSystemFont(ofSize: 23))
    .with(underlineStyle: .thick)
    .with(string: "Tapable item", onClick: { print("Click") })
    .with(string: "\nSome text")

CodeGenerator

Generates bar and qr code

enum CodeType {
    case aztecCode
    case checkerboard
    case code128Barcode
    case constantColor
    case lenticularHalo
    case pdf417Barcode
    case qrCode(CorrectionLevel)
    case random
    case starShine
    case stripes
    case sunbeams
}
let request = CodeGeneratorRequest()
    .with(background: UIColor.black)
    .with(foreground: UIColor.white)
    .with(size: imageView.frame.size)
let image: UIImage? = "123123123"
    .code(type: .code128Barcode, request: request)?
imageView.image = image

Image Preview

Shows full screen image after tap

private let imageView = UIImageView(()
    .with(contentMode: .scaleAspectFill)
    .with(isPreviewable: true)

LoremIpsum

Generates lorem ipsum text

Reference

Utils supports Weak, Unowned and Strong 'functions'. It wraps object and return proper reference in closure.

reloadButton.onClick = Unowned(self) { (_self) in
    _self.reloadMock()
    _self.reloadData()
}

Pagination

More info is in Forms documentation.

ScrollSteps

Allows you update view in certain offsets

var scrollTopSteps = ScrollStep(0..<200)
var scrollBottomSteps = ScrollStep(200..<800)
var scrollSteps = ScrollSteps([scrollTopSteps, scrollBottomSteps])

ScrollContainer has scrollSteps property to manage steps and send onUpdate callbacks.

For other scroll you can perform update method when offset did change

func scrollViewDidScroll(_ scrollView: UIScrollView) {
    scrollSteps.update(scrollView.contentOffset)
}

You can use onUpdateVertical and onUpdateHorizontal callbacks.

scrollSteps.onUpdateVertical = { (step: ScrollStep, progress: CGFloat) in
    switch step {
    case scrollTopSteps:
        // some changes
    case scrollBottomSteps:
        // some changes
    default: break
    }
}

SVG

Generate UIBezierPath from SVG path. At this moment SVG doesn't support .svg file format - supports ONLY svg paths.

let path = "M85 32C115 68 239 170 281 192 311 126 274 43 244 0c97 58 146 167 121 254 28 28 40 89 29 108 -25-45-67-39-93-24C176 409 24 296 0 233c68 56 170 65 226 27C165 217 56 89 36 54c42 38 116 96 161 122C159 137 108 72 85 32z"
let bezierPath = UIBezierPath(svg: path)

or

let svg = SVG.Path(path)
let bezierPath = UIBezierPath(svg: svg)

By default UIImageView supports SVG and implements SVGView protocol

protocol SVGView: class {
    var svgLayer: CAShapeLayer? { get set }
}
let imageView = UIImageView()
    .with(width: 200, height: 200)
    .with(svg: path)
    .with(svgBackgroundColor: UIColor.white.cgColor)
    .with(svgFillColor: UIColor.blue.cgColor)
    .with(svgStrokeColor: UIColor.black.cgColor)