Add percent margins

Author: vandyshev

Sources/Impl/PinLayoutImpl.swift

@@ -818,47 +818,99 @@ class PinLayoutImpl: PinLayout {
         return self
     }
 
+    @discardableResult
+    func marginTop(_ percent: Percent) -> PinLayout {
+        func context() -> String { return "marginTop(\(percent.description))" }
+        guard let layoutSuperviewRect = layoutSuperviewRect(context) else { return self }
+        marginTop = percent.of(layoutSuperviewRect.height)
+        return self
+    }
+
     @discardableResult
     func marginLeft(_ value: CGFloat) -> PinLayout {
         marginLeft = value
         return self
     }
 
+    @discardableResult
+    func marginLeft(_ percent: Percent) -> PinLayout {
+        func context() -> String { return "marginLeft(\(percent.description))" }
+        guard let layoutSuperviewRect = layoutSuperviewRect(context) else { return self }
+        marginLeft = percent.of(layoutSuperviewRect.width)
+        return self
+    }
+
     @discardableResult
     func marginBottom(_ value: CGFloat) -> PinLayout {
         marginBottom = value
         return self
     }
 
+    @discardableResult
+    func marginBottom(_ percent: Percent) -> PinLayout {
+        func context() -> String { return "marginBottom(\(percent.description))" }
+        guard let layoutSuperviewRect = layoutSuperviewRect(context) else { return self }
+        marginBottom = percent.of(layoutSuperviewRect.height)
+        return self
+    }
+
     @discardableResult
     func marginRight(_ value: CGFloat) -> PinLayout {
         marginRight = value
         return self
     }
+
+    @discardableResult
+    func marginRight(_ percent: Percent) -> PinLayout {
+        func context() -> String { return "marginRight(\(percent.description))" }
+        guard let layoutSuperviewRect = layoutSuperviewRect(context) else { return self }
+        marginRight = percent.of(layoutSuperviewRect.width)
+        return self
+    }
 
     @discardableResult
     func marginStart(_ value: CGFloat) -> PinLayout {
         return isLTR() ? marginLeft(value) : marginRight(value)
     }
+
+    @discardableResult
+    func marginStart(_ percent: Percent) -> PinLayout {
+        return isLTR() ? marginLeft(percent) : marginRight(percent)
+    }
 
     @discardableResult
     func marginEnd(_ value: CGFloat) -> PinLayout {
         return isLTR() ? marginRight(value) : marginLeft(value)
     }
 
+    @discardableResult
+    func marginEnd(_ percent: Percent) -> PinLayout {
+        return isLTR() ? marginRight(percent) : marginLeft(percent)
+    }
+
     @discardableResult
     func marginHorizontal(_ value: CGFloat) -> PinLayout {
         marginLeft = value
         marginRight = value
         return self
     }
 
+    @discardableResult
+    func marginHorizontal(_ percent: Percent) -> PinLayout {
+        return marginLeft(percent).marginRight(percent)
+    }
+
     @discardableResult
     func marginVertical(_ value: CGFloat) -> PinLayout {
         marginTop = value
         marginBottom = value
         return self
     }
+
+    @discardableResult
+    func marginVertical(_ percent: Percent) -> PinLayout {
+        return marginTop(percent).marginBottom(percent)
+    }
 
     @discardableResult
     func margin(_ insets: UIEdgeInsets) -> PinLayout {
@@ -888,6 +940,11 @@ class PinLayoutImpl: PinLayout {
         return self
     }
 
+    @discardableResult
+    func margin(_ percent: Percent) -> PinLayout {
+        return marginTop(percent).marginLeft(percent).marginBottom(percent).marginRight(percent)
+    }
+
     @discardableResult
     func margin(_ top: CGFloat, _ left: CGFloat, _ bottom: CGFloat, _ right: CGFloat) -> PinLayout {
         marginTop = top
@@ -897,6 +954,11 @@ class PinLayoutImpl: PinLayout {
         return self
     }
 
+    @discardableResult
+    func margin(_ top: Percent, _ left: Percent, _ bottom: Percent, _ right: Percent) -> PinLayout {
+        return marginTop(top).marginLeft(left).marginBottom(bottom).marginRight(right)
+    }
+
     @discardableResult func margin(_ vertical: CGFloat, _ horizontal: CGFloat) -> PinLayout {
         marginTop = vertical
         marginLeft = horizontal
@@ -905,6 +967,11 @@ class PinLayoutImpl: PinLayout {
         return self
     }
 
+    @discardableResult
+    func margin(_ vertical: Percent, _ horizontal: Percent) -> PinLayout {
+        return marginVertical(vertical).marginHorizontal(horizontal)
+    }
+
     @discardableResult func margin(_ top: CGFloat, _ horizontal: CGFloat, _ bottom: CGFloat) -> PinLayout {
         marginTop = top
         marginLeft = horizontal
@@ -913,6 +980,11 @@ class PinLayoutImpl: PinLayout {
         return self
     }
 
+    @discardableResult
+    func margin(_ top: Percent, _ horizontal: Percent, _ bottom: Percent) -> PinLayout {
+        return marginTop(top).marginHorizontal(horizontal).marginBottom(bottom)
+    }
+
     @discardableResult
     func pinEdges() -> PinLayout {
         shouldPinEdges = true

Sources/PinLayout.swift

@@ -404,21 +404,29 @@ public protocol PinLayout {
      Set the top margin.
      */
     @discardableResult func marginTop(_ value: CGFloat) -> PinLayout
+
+    @discardableResult func marginTop(_ percent: Percent) -> PinLayout
 
     /**
      Set the left margin.
      */
     @discardableResult func marginLeft(_ value: CGFloat) -> PinLayout
+
+    @discardableResult func marginLeft(_ percent: Percent) -> PinLayout
 
     /**
      Set the bottom margin.
      */
     @discardableResult func marginBottom(_ value: CGFloat) -> PinLayout
+
+    @discardableResult func marginBottom(_ percent: Percent) -> PinLayout
 
     /**
      Set the right margin.
      */
     @discardableResult func marginRight(_ value: CGFloat) -> PinLayout
+
+    @discardableResult func marginRight(_ percent: Percent) -> PinLayout
 
     // RTL support
     /**
@@ -429,6 +437,8 @@ public protocol PinLayout {
      * In RTL direction, start margin specify the **right** margin.
      */
     @discardableResult func marginStart(_ value: CGFloat) -> PinLayout
+
+    @discardableResult func marginStart(_ percent: Percent) -> PinLayout
 
     /**
      Set the end margin.
@@ -438,17 +448,23 @@ public protocol PinLayout {
      * In RTL direction, end margin specify the **left** margin.
      */
     @discardableResult func marginEnd(_ value: CGFloat) -> PinLayout
+
+    @discardableResult func marginEnd(_ percent: Percent) -> PinLayout
 
     /**
      Set the left, right, start and end margins to the specified value.
      */
     @discardableResult func marginHorizontal(_ value: CGFloat) -> PinLayout
+
+    @discardableResult func marginHorizontal(_ percent: Percent) -> PinLayout
 
     /**
      Set the top and bottom margins to the specified value.
      */
     @discardableResult func marginVertical(_ value: CGFloat) -> PinLayout
 
+    @discardableResult func marginVertical(_ percent: Percent) -> PinLayout
+
     /**
      Set all margins using UIEdgeInsets. 
      This method is particularly useful to set all margins using iOS 11 `UIView.safeAreaInsets`.
@@ -468,22 +484,30 @@ public protocol PinLayout {
      Set all margins to the specified value.
      */
     @discardableResult func margin(_ value: CGFloat) -> PinLayout
+
+    @discardableResult func margin(_ percent: Percent) -> PinLayout
 
     /**
      Set individually vertical margins (top, bottom) and horizontal margins (left, right, start, end).
      */
     @discardableResult func margin(_ vertical: CGFloat, _ horizontal: CGFloat) -> PinLayout
+
+    @discardableResult func margin(_ vertical: Percent, _ horizontal: Percent) -> PinLayout
 
     /**
      Set individually top, horizontal margins and bottom margin.
      */
     @discardableResult func margin(_ top: CGFloat, _ horizontal: CGFloat, _ bottom: CGFloat) -> PinLayout
+
+    @discardableResult func margin(_ top: Percent, _ horizontal: Percent, _ bottom: Percent) -> PinLayout
 
     /**
      Set individually top, left, bottom and right margins.
      */
     @discardableResult func margin(_ top: CGFloat, _ left: CGFloat, _ bottom: CGFloat, _ right: CGFloat) -> PinLayout
 
+    @discardableResult func margin(_ top: Percent, _ left: Percent, _ bottom: Percent, _ right: Percent) -> PinLayout
+
     /// Normally if only either left or right has been specified, PinLayout will MOVE the view to apply left or right margins.
     /// This is also true even if the width has been set.
     /// Calling pinEdges() will force PinLayout to pin the four edges and then apply left and/or right margins, and this without