FHConstraints

2.2.0

Extension for UIView with useful constraint methodes.
FelixHerrmann/FHConstraints

What's New

2.2.0

2021-08-15T01:25:56Z

CI workflow added

FHConstraints

GitHub version GitHub license Twitter

FHConstraints is an extension for the UIView class with usefull constraint methods. Theses methods simplify the build-in constraint methods.

Requirements

  • macOS 10.11
  • macOS 10.15+ (Catalyst)
  • iOS 9.0+
  • tvOS 9.0+

Installation

Add the following to the dependencies of your Package.swift:

.package(url: "https://github.com/FelixHerrmann/FHConstraints.git", from: "x.x.x")

Manual

Download the files in the Sources folder and drag them into you project.

Usage

If you are using Swift Package Manager, you have to import FHConstraints to your file with import FHConstraints. You can also import it globally with @_exported import FHConstraints. (e.g. in AppDelegate.swift)


Instead of:

subview.translatesAutoresizingMaskIntoConstraints = false
subview.leadingAnchor.constraint(equalTo: view.leadingAnchor).isActive = true
subview.trailingAnchor.constraint(lessThanOrEqualTo: view.trailingAnchor, constant: -10).isActive = true
subview.centerYAnchor.constraint(equalTo: view.centerYAnchor, constant: 5).isActive = true
subview.heightAnchor.constraint(greaterThanOrEqualTo: view.heightAnchor, multiplier: 1.5, constant: 20).isActive = true

you will use:

subview.constraint(.leading(to: view.leadingAnchor))
subview.constraint(.trailing(to: view.trailingAnchor, .lessThanOrEqual(to: -10)))
subview.constraint(.centerY(to: view.centerYAnchor, .equal(to: 5)))
subview.constraint(.height(to: view.heightAnchor, .greaterThanOrEqual(to: FHLayoutAnchor.DimensionConstant(multiplier: 1.5, constant: 20))))

All of these methods will return the created constraint.

Convenience Methods

Combined constraining method:

subview.constraint([
    .leading(to: view.leadingAnchor),
    .trailing(to: view.trailingAnchor, .lessThanOrEqual(to: -10)),
    .centerY(to: view.centerYAnchor, .equal(to: 5)),
    .height(to: view.heightAnchor, .greaterThanOrEqual(to: FHLayoutAnchor.DimensionConstant(multiplier: 1.5, constant: 20)))
])

Shortcut methods:

subview.constraint(.inside(of: view, insets: .equal(to: EdgeInsets(top: 0, left: 0, bottom: 0, right: 0))))
subview.constraint(.toCenter(of: view, offset: .equal(to: FHConvenienceAnchors.Offset(horizontal: 0, vertical: 0))))
subview.constraint(.size(.equal(to: CGSize(width: 0, height: 0)))

Constraint creation (but not activation) method:

let leadingConstraint = subview.createConstraint(from: .leading(to: view.leadingAnchor))

License

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

Description

  • Swift Tools 5.2.0
View More Packages from this Author

Dependencies

  • None
Last updated: Tue Mar 19 2024 17:41:53 GMT-0900 (Hawaii-Aleutian Daylight Time)