UIView+AutoLayout

The ultimate API for iOS Auto Layout -- impressively simple, immensely powerful. Comprised of categories on UIView, NSArray, and NSLayoutConstraint.

UIView+AutoLayout provides a developer-friendly interface for the vast majority of Auto Layout use cases. It is designed for clarity and simplicity, taking inspiration from the Auto Layout UI options available in Interface Builder but delivering far more flexibility and capability. The API is also highly efficient, as it adds only a thin layer of third party code and is engineered for maximum performance (for example, by automatically adding constraints to the nearest ancestor view).

API Cheat Sheet

This is just a handy overview of the core API methods. Check out the header file for the full API and documentation. A couple notes:

All of the API methods begin with auto... for easy autocompletion!
All methods that generate constraints also automatically add the constraint(s) to the correct view, then return the newly created constraint(s) for you to optionally store for later adjustment or removal.
Many methods below also have a variant which includes a relation: parameter to make the constraint an inequality.

UIView

+ autoRemoveConstraint(s):
- autoRemoveConstraintsAffectingView(AndSubviews)
+ autoSetPriority:forConstraints:
- autoSetContent(CompressionResistance|Hugging)PriorityForAxis:
- autoCenterInSuperview:
- autoAlignAxisToSuperviewAxis:
- autoPinEdgeToSuperviewEdge:withInset:
- autoPinEdgesToSuperviewEdges:withInsets:(excludingEdge:)
- autoPinEdge:toEdge:ofView:(withOffset:)
- autoAlignAxis:toSameAxisOfView:(withOffset:)
- autoMatchDimension:toDimension:ofView:(withOffset:|withMultiplier:)
- autoSetDimension(s)ToSize:
- autoConstrainAttribute:toAttribute:ofView:(withOffset:|withMultiplier:)
- autoPinTo(Top|Bottom)LayoutGuideOfViewController:withInset:

NSArray

- autoAlignViewsToEdge:
- autoAlignViewsToAxis:
- autoMatchViewsDimension:
- autoSetViewsDimension:toSize:
- autoDistributeViewsAlongAxis:withFixedSpacing:alignment:
- autoDistributeViewsAlongAxis:withFixedSize:alignment:

NSLayoutConstraint

- autoRemove

Setup

Note: you must be developing for iOS 6.0 or later to use Auto Layout.

Using CocoaPods

Add the pod UIView+AutoLayout to your Podfile.
```
pod 'UIView+AutoLayout'
```
Run pod install from Terminal, then open your app's .xcworkspace file to launch Xcode.
#import UIView+AutoLayout.h wherever you want to use the API.

(Hint: adding the import to your precompiled header (.pch) file once will remove the need to import the .h file everywhere!)
That's it - now go write some beautifully simple Auto Layout code!

Manually from GitHub

Download the UIView+AutoLayout.h and UIView+AutoLayout.m files in the Source directory.
Add both files to your Xcode project.
#import UIView+AutoLayout.h wherever you want to use the API.

(Hint: adding the import to your precompiled header (.pch) file once will remove the need to import the .h file everywhere!)
That's it - now go write some beautifully simple Auto Layout code!

Releases

Releases are tagged in the git commit history using semantic versioning. Check out the releases and release notes for each version.

Usage

Example Project

Check out the example project included in the repository. It contains a few demos of the API in use for various scenarios. While running the app, tap on the screen to cycle through the demos. You can rotate the device to see the constraints in action (as well as toggle the taller in-call status bar in the iOS Simulator).

Tips and Tricks

Check out some Tips and Tricks to keep in mind when using the API.

Limitations

May need to use the NSLayoutConstraint SDK API directly for some extremely uncommon use cases