🍦 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
NSLayoutConstraints. - 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:
pod 'VanillaConstraints'Then, run the following command:
$ pod installCarthage
github "jdisho/VanillaConstraints" ~> 1.0
Then, run the following command:
$ carthage updateManually
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:
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 = truewith this:
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)Edges
Pin a view to the edges of another view:
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:
view.add(to: anotherView).pinToEdges()or with equal margins:
view.add(to: anotherView).pinToEdges(withMargins: 16.0)or pinned to some other view different from where it is added:
view.add(to: anotherView).pinToEdges(of: someOtherView)or pinned to safeAreaLayoutGuide egdes:
view.add(to: anotherView).pinToEdges(safeConstrainable: true) // false by defaultCenter
Center a view to another view:
anotherView.addSubview(view)
view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
view.centerXAnchor.constraint(equalTo: anotherView.centerXAnchor)
view.centerYAnchor.constraint(equalTo: anotherView.centerYAnchor)
])with VanillaConstraints:
view.add(to: anotherView).center()or centered in some other view different from where it is added:
view.add(to: anotherView).center(in: someOtherView)Size
Set the size of the view:
anotherView.addSubview(view)
view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
view.widthAnchor.constraint(equalToConstant: 50.0)
view.heightAnchor.constraint(equalToConstant: 50.0)
])with VanillaConstraints:
view.add(to: anotherView).size(CGSize(width: 50.0, height: 50))or with other relations:
view.add(to: anotherView).size(CGSize(width: 50.0, height: 50), relation: .equalOrLess) // .equal by default Supported attributes
topbottomleftrightleadingtrailingcenterXcenterYwidthheight
👤 Author
This tiny library is created with
📃 License
VanillaConstraints is released under an MIT license. See License.md for more information.