Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ashikahmad/SugarAnchor
A simpler way to work with NSLayoutAnchor
https://github.com/ashikahmad/SugarAnchor
anchor constraints ios layout swift3
Last synced: 3 months ago
JSON representation
A simpler way to work with NSLayoutAnchor
- Host: GitHub
- URL: https://github.com/ashikahmad/SugarAnchor
- Owner: ashikahmad
- License: mit
- Created: 2017-05-09T14:37:58.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-06-12T09:31:17.000Z (over 7 years ago)
- Last Synced: 2024-11-26T12:35:19.489Z (3 months ago)
- Topics: anchor, constraints, ios, layout, swift3
- Language: Swift
- Size: 53.7 KB
- Stars: 20
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - SugarAnchor - Same native NSLayoutAnchor & NSLayoutConstraints; but with more natural and easy to read syntactic sugar. Typesafe, concise & readable. (Layout / Other Hardware)
- awesome-ios-star - SugarAnchor - Same native NSLayoutAnchor & NSLayoutConstraints; but with more natural and easy to read syntactic sugar. Typesafe, concise & readable. (Layout / Other Hardware)
README
# 
[](https://travis-ci.org/ashikahmad/SugarAnchor)
[](http://cocoapods.org/pods/SugarAnchor)
[](http://cocoapods.org/pods/SugarAnchor)
[](http://cocoapods.org/pods/SugarAnchor)
SugarAnchor is syntactic sugar on `NSLayoutAnchor` to help us write more compact, readable and easy layout code. It wraps up all of `NSLayoutXAxisAnchor`, `NSLayoutYAxisAnchor` and `NSLayoutDimension` functionalities under some easy to use operators to reduce verbosity.
## Features
- Simple, concise, native[1]. Almost zero learning curve
- Typesafe, similar to NSLayoutAnchor
- Unit tested
- Small codebase (less than 300 LOC)
> [1] Same NSLayoutAnchor/NSLayoutConstraints, just syntactic sugar on it
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Requirements
- [x] Xcode 8.3 or above
- [x] Swift 3.1
- [x] iOS 9.0 or above
## Installation
SugarAnchor is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "SugarAnchor"
```
## Operator Summary
Let's looks at a simple NSLayoutAnchor code:
```swift
(redView.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 20)).isActive = true
```
With SugarAnchor, it become:
```swift
redView.leadingAnchor =*= view.leadingAnchor + 20
```
Think `*` as **Active constraint** and `~` as **Inactive constraint**. Then with `=*=`, you'll create an active constraint directly or with `=~=` you may create an inactive constraint which you can activate later.
```swift
view1.leftAnchor =*= view2.leftAnchor + 10
// Or
let leftConstraint = (view1.leftAnchor =~= view2.leftAnchor + 10)
leftConstraint.isActive = true
```
In each case, you'll get the constraint to keep or just ignore. For example, for an active one:
```swift
self.heightConstraint = (v1.heightAnchor =*= 200)
// Later somewhere
self.heightConstraint.constant = 100
```
## Operator list
Operator | Description | Example
--- | --- | ---
=*= | Equal
(Active) | ❖ `v1.leadingAnchor =*= v2.leadingAnchor`
❖ `v1.leftAnchor =*= v2.leftAnchor + 20`
❖ `v1.widthAnchor =*= v2.widthAnchor / 2 + 10`
❖ `v1.heightAnchor =*= 200`
<*= | LessThanOrEqual
(Active) | ❖ `v1.bottomAnchor <*= container.bottomAnchor - 8`
>*= | GreaterThanOrEqual
(Active) | ❖ `v2.leadingAnchor >*= v1.trailingAnchor + 5`
=~= | Equal
(Inactive) | ❖ `(v1.widthAnchor =~= 200).isActive = true`
<~= | LessThanOrEqual
(Inactive) | ❖ `(v1.bottomAnchor <~= container.bottomAnchor - 8).isActive = true`
>~= | GreaterThanOrEqual
(Inactive) | ❖ `(v2.leadingAnchor >~= v1.trailingAnchor + 5).isActive = true`
## Author
ashikahmad, [email protected]
## License
SugarAnchor is available under the MIT license. See the LICENSE file for more info.