Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jdisho/vanillaconstraints
🍦 Simplified and chainable AutoLayout constraints for iOS.
https://github.com/jdisho/vanillaconstraints
autolayout constraints layout swift ui
Last synced: 6 days ago
JSON representation
🍦 Simplified and chainable AutoLayout constraints for iOS.
- Host: GitHub
- URL: https://github.com/jdisho/vanillaconstraints
- Owner: jdisho
- License: mit
- Created: 2018-08-13T08:48:05.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-08-12T11:28:33.000Z (over 1 year ago)
- Last Synced: 2024-12-01T04:38:52.055Z (about 1 month ago)
- Topics: autolayout, constraints, layout, swift, ui
- Language: Swift
- Homepage:
- Size: 182 KB
- Stars: 42
- Watchers: 4
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🍦 VanillaConstraints
- A simplified and chainable *AutoLayout* for iOS written in Swift.
- A thin wrapper around `NSLayoutConstraints`.
- Short syntax for creating layout constraints.
- Chainable way of describing `NSLayoutConstraint`s.
- Using `KeyPaths`.
- Constraints are active by default.
- No need to set `translatesAutoresizingMaskIntoConstraints = false`.
- No external dependencies.
## 🛠 Installation
### CocoaPods
To integrate VanillaConstraints into your Xcode project using CocoaPods, specify it in your `Podfile`:
```ruby
pod 'VanillaConstraints'
```
Then, run the following command:
```bash
$ pod install
```
### Carthage
```
github "jdisho/VanillaConstraints" ~> 1.0
```
Then, run the following command:
```bash
$ carthage update
```
### Manually
If you prefer not to use any of the dependency managers, you can integrate `VanillaConstraints` into your project manually, by downloading the source code and placing the files on your project directory.
## 👨🏻💻 Usage
**tl;dr**
It allows you to replace this:
```swift
anotherView.addSubview(view)
view.translatesAutoresizingMaskIntoConstraints = false
let top = view.topAnchor.constraint(equalTo: anotherView.topAnchor, constant: 16.0)
top.priority = .defaultLow
top.isActive = true
let trailing = view.trailingAnchor.constraint(lessThanOrEqualTo: anotherView.trailingAnchor)
trailing.priority = .defaultHigh
trailing.isActive = true
let bottom = view.bottomAnchor.constraint(equalTo: anotherView.bottomAnchor, constant: 16.0)
bottom.priority = .required
bottom.isActive = true
let leading = view.leadingAnchor.constraint(greaterThanOrEqualTo: anotherView.leadingAnchor, constant: 8.0)
leading.isActive = true
```
with this:
```swift
view.add(to: anotherView)
.top(to: \.topAnchor, constant: 16.0, priority: .defaultLow)
.trailing(to: \.trailingAnchor, relation: .equalOrLess, priority: .defaultHigh)
.bottom(to: \.bottomAnchor, constant: 16.0)
.leading(to: \.leadingAnchor, relation: .equalOrGreater, constant: 8.0)
```
**⚠️ If the anchor's view is not specified, it is constrained where it is added.**
### Edges
Pin a view to the edges of another view:
```swift
anotherView.addSubview(view)
view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
view.topAnchor.constraint(equalTo: anotherView.topAnchor),
view.leadingAnchor.constraint(equalTo: anotherView.leadingAnchor),
view.bottomAnchor.constraint(equalTo: anotherView.bottomAnchor),
view.trailingAnchor.constraint(equalTo: anotherView.trailingAnchor)
])
```
with `VanillaConstraints`:
```swift
view.add(to: anotherView).pinToEdges()
```
or with equal margins:
```swift
view.add(to: anotherView).pinToEdges(withMargins: 16.0)
```
or pinned to some other view different from where it is added:
```swift
view.add(to: anotherView).pinToEdges(of: someOtherView)
```
or pinned to safeAreaLayoutGuide egdes:
```swift
view.add(to: anotherView).pinToEdges(safeConstrainable: true) // false by default
```
### Center
Center a view to another view:
```swift
anotherView.addSubview(view)
view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
view.centerXAnchor.constraint(equalTo: anotherView.centerXAnchor)
view.centerYAnchor.constraint(equalTo: anotherView.centerYAnchor)
])
```
with `VanillaConstraints`:
```swift
view.add(to: anotherView).center()
```
or centered in some other view different from where it is added:
```swift
view.add(to: anotherView).center(in: someOtherView)
```
### Size
Set the size of the view:
```swift
anotherView.addSubview(view)
view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
view.widthAnchor.constraint(equalToConstant: 50.0)
view.heightAnchor.constraint(equalToConstant: 50.0)
])
```
with `VanillaConstraints`:
```swift
view.add(to: anotherView).size(CGSize(width: 50.0, height: 50))
```
or with other relations:
```swift
view.add(to: anotherView).size(CGSize(width: 50.0, height: 50), relation: .equalOrLess) // .equal by default
```
### Supported attributes
- `top`
- `bottom`
- `left`
- `right`
- `leading`
- `trailing`
- `centerX`
- `centerY`
- `width`
- `height`
## 👤 Author
This tiny library is created with ❤️ by [Joan Disho](https://twitter.com/_disho)
## 📃 License
VanillaConstraints is released under an MIT license. See [License.md](https://github.com/jdisho/VanillaConstraints/blob/master/LICENSE) for more information.