Toolbox is a framework for iOS development with collected code snippets and extensions that is repeatedly copied from project to project. With the toolbox we want to save time and get rid of copy/paste stuff.
Import the framework to your class with import ToolBox.
You are now able to use some helpers like:
Old way
let fooView: UIView() = {
let view = UIView()
view.translatesAutoresizingMaskIntoConstraints = false
view.backgroundColor = .white
return view
}()
New way
let fooView = UIView().with {
$0.translatesAutoresizingMaskIntoConstraints = false
$0.backgroundColor = .white
}
It will return true if the string is optional, nil, empty, empty space, tab, newline or return
let string: String?
string.isBlank // => true
let string: String? = nil
string.isBlank // => true
let string = ""
string.isBlank // => true
let string = " "
string.isBlank // => true
let string = "\n"
string.isBlank // => true
Say Goodbye to Index out of range
let array = [1, 2, 3, 4]
array[safeIndex: 6] => nil
Add subView of UIView:
// old
view.addSubview(foo)
view.addSubview(bar)
// new
view.add(foo, bar)
Add arrangedSubview of UIStackView
// old
stackView.addArrangedSubview(foo)
stackView.addArrangedSubview(bar)
// new
stackView.addArrangedSubviews(foo, bar)
Remove all subviews form stackView now easier
stackView.removeAllArrangedSubviews()
let separatorView = UIView.createSeparatorView(width: UIScreen.main.bounds.width, height: 1.0, color: .gray, priority: .required)
Get rid of using the old way to define styles to the UILabel or UIButtons
The old way is inconsistent and in case you need to change the font size you need to go all through and change it manually
let label = UILabel().with {
$0.translatesAutoresizingMaskIntoConstraints = false
$0.font = UIFont(name: "HelveticaNeue-UltraLight", size: 20.0)
$0.textColor = .darkText
}
A new way with styles
// Define the styles on one place e.g. Appearance.swift
extension UIColor {
struct App {
static let text = .darkText
}
}
extension Style {
static let headline1 = Style(font: UIFont(name: "HelveticaNeue-UltraLight", size: 20) ?? .systemFont(ofSize: 20), color: UIColor.App.text)
}
// and now in your classes you can use it like this
let label = UILabel().with {
$0.translatesAutoresizingMaskIntoConstraints = false
$0.setStyle(.headline1)
}
Coordinators use UIAdaptivePresentationControllerDelegate to receive callbacks, when managed UIViewControllers are being dismissed.
The delegate will only be set to the Coordinator, when a Coordinator is presented modally (through present(_ coordinator: Coordinator, animated: Bool, completion: (() -> Void)? = nil)). If the delegate is already set a fatalError is thrown, as this is a programming error.
If the UIAdaptivePresentationControllerDelegate callbacks are needed they can be implemented directly in the Coordinator itself.
The delegate callbacks can be forwarded to another object via the targetAdaptiveDelegate.
Per default the targetAdaptiveDelegate is the rootViewController of the Coordinator.
For the NavigationCoordinator the topViewController is the targetAdaptiveDelegate.
The UIAdaptivePresentationControllerDelegate is handed over, when pushing a NavigationCoordinator (e.g. calling the push(_ coordinator: NavigationCoordinator, animated: Bool) function)
If you do not receive callbacks check:
- does your class / UIViewController confirm to
UIAdaptivePresentationControllerDelegate - does the Coordinator intercept the callbacks (e.g. has implemented the function)
- is the
targetAdaptiveDelegateset to the correct object - is another
NavigationCoordinatorpushed and intercepting the callbacks
Add the following dependency to your Package.swift file:
.package(url: "https://github.com/allaboutapps/Toolbox", from: "1.0.0")
In any file you'd like to use Toolbox in, don't forget to import the framework with import ToolBox.
- Create something awesome, make the code better, add some functionality, whatever (this is the hardest part).
- Fork it
- Create new branch to make your changes
- Commit all your changes to your branch
- Submit a pull request