AnchorPal

An AutoLayout library inspired by SnapKit.

Usage

If you are familiar with SnapKit, you already know how to use AnchorPal, just with a little changes.

Install new constraints.

view.anc.installConstraints { make in
    make.xEdges.equalToSuperview()
    // with a optional parameter, you can easily refer to the layoutGuides of superview
    make.yEdges.equalToSuperview(.safeArea)
}

Reinstall constraints.

view.anc.reinstallConstraints { make in
    make.height.equalTo(newValue)
}

Make constraints without installing.

let constaints = view.anc.makeConstraints { make in
    make.edges.equalToSuperview(.safeArea)
}

// Activate them later
constraints.activate()

Inset

Note: We don't use first.relationTo(second).inset(x) format, because it's ambiguous.

When we say first.>=(second).inset(x), it can be "The first item has a greater value than second item insetting x.", but also can be "The inset from second item to first item is greater than x.". We want to be clear about the intent.

view.anc.installConstraints { make in
    make.edges.insetFromSuperview().equalTo(30)
}
// or 
view.anc.installConstraints { make in
    make.edges.insetFrom(otherView).greaterEqualTo(30)
}

Set dynamic constraint constant.

view.anc.installConstraints { make in
    make.width.equalTo { position -> CGFloat in
        // return a CGFloat as the new constant
        // position is the info about the current anchor which is calling this closure
        return newWidth
    }
}

// update constants later
view.anc.updateConstraintConstants()

Custom Dimension (iOS 10+, tvOS 10+, macOS 10.12+)

view1.anc.reinstallConstraints { make in
    let space1 = make.right.spaceBefore(view2.anc.left)
    let space2 = make.bottom.spaceBefore(view3.anc.top)
    space1.equalTo(space2)
}

System Spacing (iOS 11+, tvOS 11+, macOS 11+)

// custom dimension to system spcaing
view1.anc.reinstallConstraints { make in
    make.left.spaceAfter(view2.anc.right).equalToSystemSpacing().multiply(2)
}

// or anchor to anchor 
view1.anc.reinstallConstraints { make in
    make.left.equalToSystemSpacingAfter(view2.anc.right).multiply(2)
}

Install or make constraints within static function.

// Sometimes you just don't want to bind these constraints to any view.
Anc.installConstraints {
    view1.anc.edges.equalToSuperview(.safeArea)
    view2.anc.top.equalTo(view1.anc.bottom).plus(20)
}

Install or make constraints outside the closure.

// make and install
view1.anc.edges.equalToSuperview(.safeArea).active()
view2.anc.top.equalTo(view1.anc.bottom).plus(20).active()

// or just make
let constraint1 = view1.anc.edges.equalToSuperview(.safeArea)
let constraint2 = view2.anc.top.equalTo(view1.anc.bottom).plus(20)

About the relation name.

We change the lessThanOrEqualTo to lessEqualTo, and greaterThanOrEqualTo to greaterEqualTo, just be shorter, but still has no ambiguity.

Closing

AnchorPal is designed to be flexbile and readable, hope you can enjoy it, if don't, please feel free to tell us.