Awesome

I am glad to share with you a lightweight Swift framework for Apple's Auto-Layout. It helps you write readable and compact UI code using simple API.

At first, it was only a few extenstions of UIView desiged for some of my commercial projects, but eventually code continued to grow, so I decided to move it to a seperate framework. I hope some of you find it helpful, so feel free to share your feedback and give some stars to EasySwiftLayout!

If you want to report bug or request new feature - open a ticket. I will try my best to cover them as soon as posible.

Contents

• Requirements
• Documentation
• Installation
• Usage
• API Cheat Sheet
• License

Requirements

• iOS 9.0+
• Xcode 9.0+
• Swift 4+

Documentation

All methods in EasySwiftLayout designed to be self-explaining, but at the same time all of them includes detail description of usage. You can check it both in code by pressing ⌥ key and clicking on the method, and in our API Cheat Sheet section down below.

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate EasySwiftLayout into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'EasySwiftLayout'

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate EasySwiftLayout into your Xcode project using Carthage, specify it in your Cartfile:

github "denandreychuk/EasySwiftLayout"

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler. It is in early development, but EasySwiftLayout does support its use on supported platforms.

Once you have your Swift package set up, adding EasySwiftLayout as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/Pimine/EasySwiftLayout.git", .upToNextMajor(from: "1.6.0"))
]

Manually

If you prefer not to use any of the aforementioned dependency managers, you can integrate EasySwiftLayout into your project manually.

Embedded Framework

• Clone this repo by running:

  $ git clone https://github.com/denandreychuk/EasySwiftLayout.git
  

• Navigate to the project folder and open EasySwiftLayout.xcodeproj.

• Select scheme Build Framework by pressing ^ + 0 and run it on any device. It will automatically generate for you EasySwiftLayout.framework file and open it in Finder.

• Move this file to your project folder.

• Select your application in the Project Navigator (blue icon) to navigate to the target configuration window.

• Select the desired target under the "Targets" heading in the sidebar.

• In "General" tab click on the + button under the "Embedded Binaries" section (in Xcode 11 it calls Frameworks, Libraries, and Embedded Content) and select moved EasySwiftLayout.framework file.

• Done.

  The EasySwiftLayout.framework is automatically added as a target dependency, linked framework and embedded framework in a copy files build phase which is all you need to build on the simulator and a device.

Usage

Quick Start

import EasySwiftLayout

class ViewController: UIViewController {
    private let boxView = UIView()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        addAndLayoutSubviews()
    }
    
    private func addAndLayoutSubviews() {        
        boxView
            .add(toSuperview: view)
            .centerInSuperview()
            .size(toSquareWithSide: 50)
    }
}

Example

EasySwiftLayout comes with project example. You can check out how easily you can create screens like this with ESL:

• Navigate to the project folder and open EasySwiftLayout.xcworkspace.
• Select scheme iOS Example by pressing ^ + 0 and just run it on any device.

API Cheat Sheet

UIView Extenstions:

Helpers

Summary

Adds the view as a subview of specified superview.

Declaration

func add(toSuperview superview: UIView) -> Self

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Helpers.swift

Size Methods (Constants)

Summary

Sets the width of the view using the specified type of relation to the given size with the priority of the constraint.

Declaration

func width(_ width: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Constraints the width anchor using NSLayoutConstraint.

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

Pass size greater than zero, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Size.swift

Summary

Sets the height of the view using the specified type of relation to the given size with the priority of the constraint.

Declaration

func height(_ height: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Constraints the height anchor using NSLayoutConstraint.

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

Pass size greater than zero, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Size.swift

Summary

Sets the dimensions of the view using the specified type of relation to the given size with the priority of the constraint.

Declaration

func size(_ size: CGSize, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Constraints the height and width anchors using NSLayoutConstraint

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

Pass size greater than zero, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Size.swift

Summary

Sets the dimensions of the view to a square with the side using the specified type of relation to the given size with the priority of the constraint.

Declaration

func size(toSquareWithSide side: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Constraints width and height anchors using NSLayoutConstraint to match square size.

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

Pass side greater than zero, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Size.swift

Size Methods (Another view)

Summary

Sets the width of the view using the specified type of relation to the width of another view with the inset and priority of the constraint.

Declaration

func width(match anotherView: UIView, withInset inset: CGFloat = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Constraints width and height anchors using NSLayoutConstraint to match square size.

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Size.swift

Summary

Sets the height of the view using the specified type of relation to the height of another view with the inset and priority of the constraint.

Declaration

func height(match anotherView: UIView, withInset inset: CGFloat = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Constraints width and height anchors using NSLayoutConstraint to match square size.

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Size.swift

Summary

Sets the size of the view using the specified type of relation to the size of another view with the insets and priority of the constraints.

Declaration

func size(match anotherView: UIView, withInsets insets: ESLSizeInsets = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Constraints width and height anchors using NSLayoutConstraint to match square size.

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Size.swift

Summary

Sets the size of the view using the specified type of relation to the size of another view with the insets and priority of the constraints.

Declaration

func size(match anotherView: UIView, withInset inset: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Constraints width and height anchors using NSLayoutConstraint to match square size.

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Size.swift

Pin Methods

Summary

Pins the edges to the given NSLayoutAxisAnchors with the insets and priority of the constraints.

Declaration

func pin(topTo top: NSLayoutYAxisAnchor? = nil, leftTo left: NSLayoutXAxisAnchor? = nil, bottomTo bottom: NSLayoutYAxisAnchor? = nil, rightTo right: NSLayoutXAxisAnchor? = nil, withInsets insets: UIEdgeInsets = .zero, priority: UILayoutPriority = .required) -> Self

Discussion

• Compact version of default Swift layout. Allows you to pin edges to specific NSLayoutAxisAnchor.

• To make Auto-Layout works properly, it automatically sets view’s property translatesAutoresizingMaskIntoConstraints to false

Precondition

You should pass at least one anchor, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the edge of the view using the specified type of relation to the given edge of another view with the inset and priority of the constraint.

Declaration

func pinEdge(_ edge: ESLEdge, toEdge pinningEdge: ESLEdge, ofView anotherView: UIView, withInset inset: CGFloat = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Consider, accordingly to Apple's documentation, you cannot pin edges with different axis, otherwise it will throw fatal error.

• To make Auto-Layout works properly, it automatically sets view’s property translatesAutoresizingMaskIntoConstraints to false.

Precondition

• Another view must be in the same view hierarchy as this view.

• Pin edges with same axis or method will throw fatal error.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the given edge of the view using the specified type of relation to the corresponding margin of another view with the inset and priority of the constraint.

Declaration

func pinEdge(_ edge: ESLEdge, toSameEdgeOfView anotherView: UIView, withInset inset: CGFloat = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view’s property translatesAutoresizingMaskIntoConstraints to false.

Precondition

Another view must be in the same view hierarchy as this view.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the given edges of the view using the specified type of relation to the corresponding margins of another view with the insets and priority of the constraints.

Declaration

func pinEdges(_ edges: [ESLEdge] = ESLEdge.all, toSameEdgesOfView anotherView: UIView, withInsets insets: UIEdgeInsets = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• If you need to customize the insets based on the edge, use pinEdges(_:toSameEdgesOfView:withInset:usingRelation:priority:).

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

Another view must be in the same view hierarchy as this view.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the given edges of the view using the specified type of relation to the corresponding margins of another view with the equal insets and priority of the constraints.

Declaration

func pinEdges(_ edges: [ESLEdge] = ESLEdge.all, toSameEdgesOfView anotherView: UIView, withInset inset: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• If you don’t need to customize the insets based on the edge, use pinEdges(_:toSameEdgesOfView:withInsets:usingRelation:priority:).

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

Another view must be in the same view hierarchy as this view.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins edges of the view of the given group using the specified type of relation to the corresponding margins of another view with the equal insets and priority of the constraints.

Declaration

func pinEdges(ofGroup edgeGroup: ESLEdgeGroup, toSameEdgesOfView anotherView: UIView, withInset inset: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

Another view must be in the same view hierarchy as this view.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the edges of the view using the specified type of relation to the corresponding margins of another view with the insets and priority of the constraints, excluding one edge

Declaration

func pinEdges(toSameEdgesOfView anotherView: UIView, excludingEdge excludedEdge: ESLEdge, withInsets insets: UIEdgeInsets = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• If you don’t need to customize the insets based on the edge, use pinEdges(toSameEdgesOfView:excludingEdge:withInset:usingRelation:priority:).
• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

Another view must be in the same view hierarchy as this view.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the edges of the view using the specified type of relation to the corresponding margins of another view with the equal inset and priority of the constraints, excluding one edge.

Declaration

func pinEdges(toSameEdgesOfView anotherView: UIView, excludingEdge excludedEdge: ESLEdge, withInset inset: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• If you need to customize the insets based on the edge, use pinEdges(toSameEdgesOfView:excludingEdge:withInsets:usingRelation:priority:).
• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

Another view must be in the same view hierarchy as this view.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the edge of the view using the specified type of relation to the given edge of guide with the inset and priority of the constraint.

Declaration

func pinEdge(_ edge: ESLEdge, toEdge pinningEdge: ESLEdge, ofGuide guide: ESLGuide, withInset inset: CGFloat = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Consider, accordingly to Apple's documentation, you cannot pin edges with different axis, otherwise it will throw fatal error.

• To make Auto-Layout works properly, it automatically sets view’s property translatesAutoresizingMaskIntoConstraints to false.

Precondition

Pin edges with same axis or method will throw fatal error.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the given edge of the view using the specified type of relation to the corresponding margin of guide with the inset and priority of the constraint.

Declaration

func pinEdge(_ edge: ESLEdge, toSameEdgeOfGuide guide: ESLGuide, withInset inset: CGFloat = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view’s property translatesAutoresizingMaskIntoConstraints to false.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the given edges of the view using the specified type of relation to the corresponding margins of guide with the insets and priority of the constraints.

Declaration

func pinEdges(_ edges: [ESLEdge] = ESLEdge.all, toSameEdgesOfGuide guide: ESLGuide, withInsets insets: UIEdgeInsets = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• If you need to customize the insets based on the edge, use pinEdges(_:toSameEdgesOfGuide:withInset:usingRelation:priority:).

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the given edges of the view using the specified type of relation to the corresponding margins of guide with the equal insets and priority of the constraints.

Declaration

func pinEdges(_ edges: [ESLEdge] = ESLEdge.all, toSameEdgesOfGuide guide: ESLGuide, withInset inset: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• If you don’t need to customize the insets based on the edge, use pinEdges(_:toSameEdgesOfGuide:withInsets:usingRelation:priority:).

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins edges of the view of the given group using the specified type of relation to the corresponding margins of guide with the equal insets and priority of the constraints.

Declaration

func pinEdges(ofGroup edgeGroup: ESLEdgeGroup, toSameEdgesOfGuide guide: ESLGuide, withInset inset: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the edges of the view using the specified type of relation to the corresponding margins of guide with the insets and priority of the constraints, excluding one edge.

Declaration

func pinEdges(toSameEdgesOfGuide guide: ESLGuide, excludingEdge excludedEdge: ESLEdge, withInsets insets: UIEdgeInsets = .zero, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• If you don’t need to customize the insets based on the edge, use pinEdges(toSameEdgesOfGuide:excludingEdge:withInset:usingRelation:priority:).
• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Summary

Pins the edges of the view using the specified type of relation to the corresponding margins of guide with the equal inset and priority of the constraints, excluding one edge.

Declaration

func pinEdges(toSameEdgesOfGuide guide: ESLGuide, excludingEdge excludedEdge: ESLEdge, withInset inset: CGFloat, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• If you need to customize the inset based on the edge, use pinEdges(toSameEdgesOfGuide:excludingEdge:withInsets:usingRelation:priority:).
• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin.swift

Pin to Superview Methods

Just to remind, let's say you have a view called MyView, which has a UIButton(loginButton) over it. In this case, MyView is a superview for loginButton and loginButton is a subview of MyView.

Summary

Pins the edge of the view using the specified type of relation to the given edge of its superview with the inset and priority of the constraint. Optionally respects one of pre-defined Apple's layout guides.

Declaration

func pinEdge(_ edge: ESLEdge, toSuperviewEdge superviewEdge: ESLEdge, withInset inset: CGFloat = .zero, respectingGuide guide: ESLSuperviewGuide = .none, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

• Consider, accordingly to Apple's documentation, you cannot pin edges with different axis, otherwise it will throw fatal error.

• Use this method only if you want to pin the edge of the view to the opposite margin of its superview, in other cases pinEdgeToSuperview(_:withInset:usingRelation:priority:) would be a better approach.

• To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

• The view should have the superview, otherwise method will have no effect.

• Pin edges with same axis or method will throw fatal error.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin(Superview).swift

Summary

Pins the given edge of the view using the specified type of relation to the corresponding margin of its superview with the inset and priority of the constraint. Optionally respects one of pre-defined Apple's layout guides.

Declaration

func pinEdgeToSuperview(_ edge: ESLEdge, withInset inset: CGFloat = .zero, respectingGuide guide: ESLSuperviewGuide = .none, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

The view should have the superview, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin(Superview).swift

Summary

Pins the given edges of the view using the specified type of relation to the corresponding margins of its superview with the insets and priority of the constraints. Optionally respects one of pre-defined Apple's layout guides.

Declaration

func pinEdgesToSuperview(_ edges: [ESLEdge] = ESLEdge.all, withInsets insets: UIEdgeInsets = .zero, respectingGuide guide: ESLSuperviewGuide = .none, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

1. If you don't need to customize the insets based on the edge, use pinEdgesToSuperview(_:withInset:usingRelation:priority:).

2. To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

The view should have the superview, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin(Superview).swift

Summary

Pins the given edges of the view using the specified type of relation to the corresponding margins of its superview with the equal insets and priority of the constraints. Optionally respects one of pre-defined Apple's layout guides.

Declaration

func pinEdgesToSuperview(_ edges: [ESLEdge] = ESLEdge.all, withInset inset: CGFloat, respectingGuide guide: ESLSuperviewGuide = .none, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

1. If you need to customize the insets based on the edge, use pinEdgesToSuperview(_:withInsets:usingRelation:priority:).

2. To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

The view should have the superview, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin(Superview).swift

Summary

Pins edges of the view of the given group using the specified type of relation to the corresponding margins of its superview with the equal insets and priority of the constraints. Optionally respects one of pre-defined Apple's layout guides.

Declaration

func pinEdgesToSuperview(ofGroup group: ESLEdgeGroup, withInset inset: CGFloat = .zero, respectingGuide guide: ESLSuperviewGuide = .none, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

The view should have the superview, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin(Superview).swift

Summary

Pins the edges of the view using the specified type of relation to the corresponding margins of its superview with the insets and priority of the constraints, excluding one edge. Optionally respects one of pre-defined Apple's layout guides.

Declaration

func pinEdgesToSuperview(excludingEdge excludedEdge: ESLEdge, withInsets insets: UIEdgeInsets = .zero, respectingGuide guide: ESLSuperviewGuide = .none, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

1. If you don't need to customize the insets based on the edge, use pinEdgesToSuperview(excludingEdge:withInset:usingRelation:priority:).

2. To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

The view should have the superview, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin(Superview).swift

Summary

Pins the edges of the view using the specified type of relation to the corresponding margins of its superview with the equal inset and priority of the constraints, excluding one edge. Optionally respects one of pre-defined Apple's layout guides.

Declaration

func pinEdgesToSuperview(excludingEdge excludedEdge: ESLEdge, withInset inset: CGFloat, respectingGuide guide: ESLSuperviewGuide = .none, usingRelation relation: NSLayoutConstraint.Relation = .equal, priority: UILayoutPriority = .required) -> Self

Discussion

1. If you need to customize the insets based on the edge, use pinEdgesToSuperview(excludingEdge:withInset:usingRelation:priority:).

2. To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false.

Precondition

The view should have the superview, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Pin(Superview).swift

Center Methods

Summary

Centers the view in another view with the offset and priority of the constraint.

Declaration

func centerInView(_ anotherView: UIView, withOffset offset: UIOffset = .zero, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

Another view must be in the same view hierarchy as this view.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Center.swift

Summary

Centers the axis of this view in another view with the offset and priority of the constraint.

Declaration

func centerInView(_ anotherView: UIView, axis: ESLAxis, withOffset offset: CGFloat = .zero, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

Another view must be in the same view hierarchy as this view.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Center.swift

Summary

Centers the view in its superview view with the offset and priority of the constraint.

Declaration

func centerInSuperview(withOffset offset: UIOffset = .zero, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

The view should have the superview, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Center.swift

Summary

Centers the axis of this view in its superview with the offset and priority of the constraint.

Declaration

func centerInSuperview(axis: ESLAxis, withOffset offset: CGFloat = .zero, priority: UILayoutPriority = .required) -> Self

Discussion

To make Auto-Layout works properly, it automatically sets view property translatesAutoresizingMaskIntoConstraints to false

Precondition

The view should have the superview, otherwise this method will have no effect.

Parameters

Returns

self with attribute @discardableResult.

Declared In

UIView + Center.swift

License

EasySwiftLayout is released under the MIT license. See LICENSE for details.