Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/allaboutapps/toolbox
https://github.com/allaboutapps/toolbox
id-allaboutapps-ios ios swift swiftui
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/allaboutapps/toolbox
- Owner: allaboutapps
- License: mit
- Created: 2020-09-08T08:01:48.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-02-15T14:27:48.000Z (11 months ago)
- Last Synced: 2024-04-24T15:13:24.297Z (9 months ago)
- Topics: id-allaboutapps-ios, ios, swift, swiftui
- Language: Swift
- Homepage:
- Size: 119 KB
- Stars: 9
- Watchers: 8
- Forks: 3
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Toolbox
[](https://developer.apple.com/swift)
[](https://developer.apple.com/xcode/swiftui/)
## What is Toolbox
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.
## How to use it
Import the framework to your `class` with `import ToolBox`.
You are now able to use some helpers like:
### Builder Pattern
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
}
```
### Check if string is empty
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
```
### Array safe index
Say Goodbye to `Index out of range`
```
let array = [1, 2, 3, 4]
array[safeIndex: 6] => nil
```
### UIView and UIStackView helpers
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()`
### Create separator view on the easy way
```
let separatorView = UIView.createSeparatorView(width: UIScreen.main.bounds.width, height: 1.0, color: .gray, priority: .required)
```
### Style helper
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
### UIAdaptivePresentationControllerDelegate
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.
#### Utilising UIAdaptivePresentationControllerDelegate
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 `targetAdaptiveDelegate` set to the correct object
* is another `NavigationCoordinator` pushed and intercepting the callbacks
## Installation
### Swift Package Manager
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`.
## Contributing
* Create something awesome, make the code better, add some functionality,
whatever (this is the hardest part).
* [Fork it](http://help.github.com/forking/)
* Create new branch to make your changes
* Commit all your changes to your branch
* Submit a [pull request](http://help.github.com/pull-requests/)