TinyConstraints is the syntactic sugar that makes Auto Layout sweeter for human use.
- Pure Swift 5 sweetness.
- Everything you can do with Auto Layout, but shorter.
- Constraints are active by default.
- 100% compatible with other Auto Layout code.
- Optionally store your constraints.
- Set constraint priorities upon creation.
- Constrain directly to the superview.
- Stack views together with one line of code.
- No need to set
translatesAutoresizingMaskIntoConstraints
becauseTinyConstraints
does it for you.
Attaching a view to its superview with NSLayoutConstraint
:
NSLayoutConstraint.activate([
view.topAnchor.constraint(equalTo: superview.topAnchor, constant: 0),
view.leadingAnchor.constraint(equalTo: superview.leadingAnchor, constant: 0),
view.bottomAnchor.constraint(equalTo: superview.bottomAnchor, constant: 0),
view.trailingAnchor.constraint(equalTo: superview.trailingAnchor, constant: 0)
])
with TinyConstraints
:
view.edgesToSuperview()
or:
view.edgesToSuperview(insets: .top(10) + .left(10))
Constraining the center of a view to its superview with NSLayoutConstraint
:
NSLayoutConstraint.activate([
view.centerXAnchor.constraint(equalTo: superview.centerXAnchor, constant: 0)
view.centerYAnchor.constraint(equalTo: superview.centerYAnchor, constant: 0)
])
with TinyConstraints
:
view.center(in: superview)
or:
view.center(in: superview, offset: CGPoint(x: 10, y: 10))
TinyConstraints
gives you convenient and tiny typealiases for handling constraints.
Constraint
=NSLayoutConstraint
Constraints
=[NSLayoutConstraint]
This constraints the top-anchor
of the view to the top-anchor
of the superview:
view.top(to: superview)
This constraints the top-anchor
of firstView
to the bottom-anchor
of secondView
:
firstView.topToBottom(of: secondView)
Often you need to constrain a view to it's superview, with TinyConstraints you can do this super easy:
view.edgesToSuperview()
Or only one edge:
view.topToSuperview()
Or you can attach all edges except one, like this:
view.edgesToSuperview(excluding: .bottom)
For almost all constraints you can set the relation
and priority
properties. The default relation is .equal
and the default priority is .required
:
container.width(150, relation: .equalOrLess, priority: .high)
Here we create a set of inactive constraints and store these to our property:
let constraints = view.size(CGSize(width: 100, height: 100), isActive: false)
Besides the default NSLayoutConstraint
activation, TinyConstraints
also provides a way to activate a set of constraints:
constraints.activate()
You can also do this in an animation:
oldConstraints.deActivate()
constraints.activate()
UIViewPropertyAnimator(duration: 1, dampingRatio: 0.4) {
self.layoutIfNeeded()
}.startAnimation()
Here we add a height constraint to a view, store it and animate it later:
let height = view.height(100)
height.constant = 200
UIViewPropertyAnimator(duration: 1, dampingRatio: 0.4) {
self.layoutIfNeeded()
}.startAnimation()
Stack provides a way of constraining views together in a superview:
let views = [logo, title, description]
superview.stack(views, axis: .vertical, spacing: 10)
TinyConstraints is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "TinyConstraints"
TinyConstraints is available through Carthage. To install it, simply add the following line to your Cartfile:
github "roberthein/TinyConstraints"
TinyConstraints is available through Swift Package Manager. To install
it, in Xcode 11.0 or later select File
> Swift Packages
> Add Package Dependency...
and add TinyConstraints repository URL:
https://github.com/roberthein/TinyConstraints.git
Here are some video tutorials made by Alex Nagy.
Feel free to create a pull request, open an issue or find me on Twitter.