UIView(CompactConstraint)

@interface UIView (CompactConstraint)

UIView (CompactConstraint), a class category from Marco Arment’s CompactConstraint library, is integrated with Cephei. CompactConstraint provides an Auto Layout grammar and methods that are easier to use and understand than UIKit’s built in functions for programmatically adding constraints.

Refer to its readme to learn how to use it. There are two changes to note: most importantly, the methods have an hb_ prefix, and two methods that are marked as deprecated in the original project have been removed.

CompactConstraint is licensed under the MIT License.

  • Add a single constraint with the compact syntax

    Declaration

    Objective-C

    - (NSLayoutConstraint *)
        hb_addCompactConstraint:(NSString *)relationship
                        metrics:(NSDictionary<NSString *, NSNumber *> *)metrics
                          views:(NSDictionary<NSString *, UIView *> *)views;

    Swift

    func hb_addCompactConstraint(_ relationship: String!, metrics: [String : NSNumber]!, views: [String : UIView]!) -> NSLayoutConstraint!
  • Add any number of constraints. Can also mix in Visual Format Language strings.

    Declaration

    Objective-C

    - (NSArray<NSLayoutConstraint *> *)
        hb_addCompactConstraints:(NSArray<NSString *> *)relationshipStrings
                         metrics:(NSDictionary<NSString *, NSNumber *> *)metrics
                           views:(NSDictionary<NSString *, UIView *> *)views;

    Swift

    func hb_addCompactConstraints(_ relationshipStrings: [String]!, metrics: [String : NSNumber]!, views: [String : UIView]!) -> [NSLayoutConstraint]!
  • And a convenient shortcut for what we always end up doing with the visualFormat call.

    Declaration

    Objective-C

    - (void)hb_addConstraintsWithVisualFormat:(NSString *)format
                                      options:(NSLayoutFormatOptions)opts
                                      metrics:
                                          (NSDictionary<NSString *, NSNumber *> *)
                                              metrics
                                        views:(NSDictionary<NSString *, UIView *> *)
                                                  views;

    Swift

    func hb_addConstraints(withVisualFormat format: String!, options opts: NSLayoutConstraint.FormatOptions = [], metrics: [String : NSNumber]!, views: [String : UIView]!)