https://github.com/TimOliver/CoreLayout
A collection of convenience properties and extensions for laying out views in UIKit
https://github.com/TimOliver/CoreLayout
coregraphics ios layout uikit
Last synced: 5 months ago
JSON representation
A collection of convenience properties and extensions for laying out views in UIKit
- Host: GitHub
- URL: https://github.com/TimOliver/CoreLayout
- Owner: TimOliver
- License: mit
- Created: 2022-05-14T06:31:57.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-01-16T10:12:28.000Z (over 1 year ago)
- Last Synced: 2025-02-13T02:53:52.513Z (over 1 year ago)
- Topics: coregraphics, ios, layout, uikit
- Language: Swift
- Homepage:
- Size: 487 KB
- Stars: 7
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/TimOliver/CoreLayout/actions?query=workflow%3ACI)
[](https://raw.githubusercontent.com/TimOliver/CoreLayout/main/LICENSE)
Core Layout is a framework with the mission of filling the gaps in Core Graphics layout logic when working with configuring and laying out `UIView` components. The framework features a collections of extensions for popular UIKit and Core Graphics components in order to make working with them much more streamlined and efficient.
While Auto Layout is officially recommended as the best way to lay out UI components in UIKit, it does have some downsides. When the rules and complexity of the layout become too high, performance can often take a hit. Likewise, when constraints break, debugging what went wrong can sometimes take a long time.
For this reason, sometimes manual frame layout is still the preferred method. However most of the time, it involves a lot of repetitive, hard-to-read math expressions. The goal of Core Layout is to help automate away a lot of the repetitive aspects of these expressions, making manual layout easier to type, and easier to read, without introducing the same performance overhead of Auto Layout.
# Features
* Adds semantically named accessors (eg. `topLeft`) to `CGRect` and `UIView`.
* Adds convenient offsetting APIs to `CGPoint`.
* Adds additional sizing mechanisms to `CGSize`.
* Streamlines configuring rounded `UIView` layers and laying out elements in it appropriately.
# Instructions
As a very simple use-case, consider how you would lay out this red view inside of its white container view.
It would probably look something like this.
```swift
redView.frame.origin.x = containerView.frame.width - (redView.frame.width + 10)
redView.frame.origin.y = (containerView.frame.height - redView.frame.height) * 0.5
```
This is super performant and is simple enough to write, but it isn't very easy to read after the fact.
With Core Layout, the equivalent code becomes this.
```swift
redView.rightCenter = containerView.bounds.rightCenter.offsetBy(dx: -10)
```
By defining and using relative anchors, we can achieve a similar flexibility to Auto Layout, but in a much simpler way.
# Requirements
* Swift 5
* UIKit-compatible platforms (iOS, tvOS, Mac Catalyst)
# Installation
Core Layout is a very simple framework and can be easily imported manually or with CocoaPods.
## Manual Installation
Drag the `CoreLayout` folder into your Xcode project.
### CocoaPods
```
pod 'CoreLayout'
```
### SPM
I'll add this eventually. But if you want it now, please file a PR!
# Credits
Core Layout was built as a component of iComics 2 by [Tim Oliver](https://threads.net/@timoliver)
# License
Core Layout is available under the MIT License. Please check the [LICENSE](LICENSE) file for more information.