lisp>> AnchorChain>> 返回
项目作者： Gillfrost

项目描述 ：
A fluent API for constraint-based iOS layout.
高级语言： Swift
项目地址: git://github.com/Gillfrost/AnchorChain.git
创建时间： 2018-10-27T14:26:08Z
项目社区：https://github.com/Gillfrost/AnchorChain
开源协议：MIT License
下载


⚠️ This repository is no longer maintained

AnchorChain

Build Status
codecov
Version
Platform
License

A wrapper around the NSLayoutAnchor system, driven by the following set of design goals / trade-offs:

  • Ease of expression should be proportional to frequency of use. In other words: constraining a view to its superview’s edges should be trivial, and indeed it is: view.anchor()

  • Intuitiveness at the point of use. Constraining a view’s top to the bottom of another view should probably be expressed as: view.anchor(.top, to: .bottom, of: anotherView), and indeed it is.

    • Trade-off: autocompletion will be of limited use, as the anchor method is heavily overloaded.

  • Chainability to promote a little more declarative layout code. Constraining a view at its declaration point should be as easy as let view = UIView().anchoring(.width, to: 100), and indeed it is.

  • Proactiveness with the view hierarchy. When constraining anchors to match another view, such as this: UIActivityIndicatorView().anchor(.centerX, .centerY, to: view), it could be assumed that the receiver, if it is without superview, should be added as subview to the other view, and indeed it is.

    • Trade-off: it’s a pretty severe side effect, but it makes sense, since creating (activated) constraints between two views with no common ancestor constitutes a programmer error anyway.

Usage

Matching attributes

…to superview

  1. // All edges
  2. view.anchor()
  4. // Some edges
  5. view.anchor(.top, .left, .right)
  7. // To safe area
  8. view.anchor(to: .safeArea)
  10. // With insets
  11. view.anchor(with: UIEdgeInsets(top: 10, left: 20, bottom: 10, right: 20))
  13. // Save constraint for later use
  14. let constraint = view.anchor(.top)
  16. // Inactive constraint
  17. let constraint = view.anchor(.top, isActive: false)
  19. // Prioritized like a complete refactoring in your backlog
  20. view.anchor(.top, priority: .defaultLow)

…to other view

  1. // All edges
  2. view.anchor(to: otherView)
  4. // Some edges
  5. view.anchor(.top, .left, .right, to: otherView)
  7. // To safe area
  8. view.anchor(to: .safeArea, of: otherView)
  10. // With insets
  11. view.anchor(to: otherView, with: UIEdgeInsets(top: 10, left: 20, bottom: 10, right: 20))
  13. // Save constraint for later use
  14. let constraint = view.anchor(.top, to: otherView)
  16. // Inactive constraint
  17. let constraint = view.anchor(.top, to: otherView, isActive: false)
  19. // With priority
  20. view.anchor(.top, to: otherView, priority: .defaultLow)

Sizing

  1. view.anchor(.width, to: 100)
  2. view.anchor(.height, to: 100)
  3. // or simply
  4. view.anchor(.size, to: 100)

Alignment

  1. // Top to bottom of other view
  2. view.anchor(.top, to: .bottom, of: otherView)
  4. // Left greater than or equal to right of other view
  5. view.anchor(.left, .greaterThanOrEqual, to: .right, of: otherView)

Requirements

iOS 11

XCode 10

Swift 4.2

Installation

CocoaPods

To integrate AnchorChain to your XCode project using CocoaPods,
add the following to your Podfile:

  1. pod 'AnchorChain'

License

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