Latest 0.1.5
Homepage https://github.com/DenisLitvin/Pinner
License MIT
Platforms ios 9.3
Authors

CI Status
Version
License
Platform

Usage

If you you want to see the full example, run the example project, clone the repo, and run pod install from the Example directory first.

Pinner

All constraints are specified as the input parameters. Call the method of UIViewmakeConstraints(for:) which takes one or more instances of CSMConstraintType enumeration, separated with commas.

enum CSMConstraintType {
    case top
    case leading
    case left
    case bottom
    case trailing
    case right

    case height
    case width

    case centerX
    case centerY
}

All calculations are made in the closure. You can easily pin the view to any side of it’s superview with pin(to:), method of the instance of CSMConstraintPinner, or pinAndReturn(to:) if you want to use the constraint later.
Constants are made by using equal(_:) or equalAndReturn(_:) methods.

Input parameters for pin methods (use in that order):

  • _ anchor : NSLayoutAnchor – anchor point.
  • const : CGFloat – constant offset in certain axis.
  • mult : CGFLoat – multiplier, uses only for height and width anchors.
  • options : CSMConstraintOptions – possible options: .equal, .lessOrEqual, .moreOrEqual.

By default you only need to specify the anchor, all constraints are activated and underlying view has it’s property translatesAutoresizingMaskIntoConstraints set to false!

Input parameter for equal methods is only the constant(CGFloat).

You also have an ability to return all anchors within a closure by using returnAll() method on CSMConstraintPinner.
And you can deactivate your constraints using deactivate(_ :) with the index of constraint, or use deactivateAll().

Pinner

Example

someView.makeConstraints(for: .top, .left, .width, .height) { (make) in
    self.someViewTopAnchor = make.pinAndReturn(to: self.view.topAnchor, const: 30)
    make.pin(to: self.view.leftAnchor, const: 10)
    make.pin(to: self.view.widthAnchor, mult: 0.3)
    make.equal(200)
}

Helper functions

  1. Arrange view based on Safe Area Layout Guide that works for all devices and ios versions:

    Pinner

viewController.fillSafeArea(with: someView)
  1. If you want to cover the entire superview:

    someView.fillSuperview()
  2. Anchor to center of a view:
    someView.anchorCenterSuperview()

    or

    someView.anchorCenterXToSuperview(constant: 10)
    someView.anchorCenterYToSuperview(constant: 5)

    Installation

CocoaPods:

Add the line pod "Pinner" to your Podfile

Manual:

Clone the repo and drag the file Pinner.swift into your Xcode project.

Platform support

  • iOS 9.3 and above

Author

DenisLitvin, [email protected]

License

Pinner is available under the MIT license. See the LICENSE file for more info.

Latest podspec

{
    "name": "Pinner",
    "version": "0.1.5",
    "summary": "The Easy To Use Auto-Layout Library",
    "description": "Pinner helps you programmaticaly create all kinds of constraints that are easy to understand and maintain in just few lines of code.",
    "platforms": {
        "ios": "9.3"
    },
    "homepage": "https://github.com/DenisLitvin/Pinner",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "DenisLitvin": "[email protected]"
    },
    "source": {
        "git": "https://github.com/DenisLitvin/Pinner.git",
        "tag": "0.1.5"
    },
    "source_files": "Pinner/Classes/**/*",
    "pushed_with_swift_version": "4"
}

Pin It on Pinterest

Share This