Initial commit for pin.readableMargins

Author: Luc Dion

Example/PinLayoutSample.xcodeproj/project.pbxproj

@@ -51,8 +51,12 @@
 		DF4C1AAA205AF10900DED50B /* RoundedButton.swift in Sources */ = {isa = PBXBuildFile; fileRef = DF4C1AA7205AF10900DED50B /* RoundedButton.swift */; };
 		DF4C1AAE205AF78A00DED50B /* SafeAreaCornersViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = DF4C1AAC205AF78A00DED50B /* SafeAreaCornersViewController.swift */; };
 		DF4C1AAF205AF78A00DED50B /* SafeAreaCornersView.swift in Sources */ = {isa = PBXBuildFile; fileRef = DF4C1AAD205AF78A00DED50B /* SafeAreaCornersView.swift */; };
+		DFBCAEFB213012930025F7BF /* MethodReadableInsetsGroupHeader.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFBCAEF9213012930025F7BF /* MethodReadableInsetsGroupHeader.swift */; };
+		DFBCAEFC213012930025F7BF /* MethodReadableInsetsCell.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFBCAEFA213012930025F7BF /* MethodReadableInsetsCell.swift */; };
 		DFD27841211B1A710056BD93 /* UINavigationController+Orientation.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFD27840211B1A700056BD93 /* UINavigationController+Orientation.swift */; };
 		DFD27848211B1D090056BD93 /* UITabBarController+Orientation.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFD27847211B1D090056BD93 /* UITabBarController+Orientation.swift */; };
+		DFD31BA0212EE4F200566CA4 /* TableViewReadableContentView.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFD31B9E212EE4F100566CA4 /* TableViewReadableContentView.swift */; };
+		DFD31BA1212EE4F200566CA4 /* TableViewReadableContentViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFD31B9F212EE4F200566CA4 /* TableViewReadableContentViewController.swift */; };
 		DFEAF74A20C9648A00E33147 /* WrapContentView.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFEAF74920C9648A00E33147 /* WrapContentView.swift */; };
 		DFEAF74C20C9649F00E33147 /* WrapContentViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFEAF74B20C9649F00E33147 /* WrapContentViewController.swift */; };
 /* End PBXBuildFile section */
@@ -185,8 +189,12 @@
 		DF4C1AA7205AF10900DED50B /* RoundedButton.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = RoundedButton.swift; sourceTree = "<group>"; };
 		DF4C1AAC205AF78A00DED50B /* SafeAreaCornersViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SafeAreaCornersViewController.swift; sourceTree = "<group>"; };
 		DF4C1AAD205AF78A00DED50B /* SafeAreaCornersView.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SafeAreaCornersView.swift; sourceTree = "<group>"; };
+		DFBCAEF9213012930025F7BF /* MethodReadableInsetsGroupHeader.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MethodReadableInsetsGroupHeader.swift; sourceTree = "<group>"; };
+		DFBCAEFA213012930025F7BF /* MethodReadableInsetsCell.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MethodReadableInsetsCell.swift; sourceTree = "<group>"; };
 		DFD27840211B1A700056BD93 /* UINavigationController+Orientation.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "UINavigationController+Orientation.swift"; sourceTree = "<group>"; };
 		DFD27847211B1D090056BD93 /* UITabBarController+Orientation.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = "UITabBarController+Orientation.swift"; sourceTree = "<group>"; };
+		DFD31B9E212EE4F100566CA4 /* TableViewReadableContentView.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = TableViewReadableContentView.swift; sourceTree = "<group>"; };
+		DFD31B9F212EE4F200566CA4 /* TableViewReadableContentViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = TableViewReadableContentViewController.swift; sourceTree = "<group>"; };
 		DFEAF74920C9648A00E33147 /* WrapContentView.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = WrapContentView.swift; sourceTree = "<group>"; };
 		DFEAF74B20C9649F00E33147 /* WrapContentViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = WrapContentViewController.swift; sourceTree = "<group>"; };
 /* End PBXFileReference section */
@@ -258,11 +266,12 @@
 				DF4C1A9F205AEDFC00DED50B /* SafeArea */,
 				DFEAF71520C840F300E33147 /* WrapContent */,
 				DF3908912118FFF20049FD56 /* Animations */,
+				2439CC631E66606D003326FB /* RelativeView */,
+				2439CC5F1E665F66003326FB /* MultiRelativeView */,
 				2497CFEA1EF40B8100DFD13B /* Form */,
+				DFD31B9D212EE4D600566CA4 /* ReadableMargins */,
 				24D18D181F3DECD6008129EF /* IntroRTL */,
 				2416376F1F8E4BC200EE703A /* IntroObjectiveC */,
-				2439CC5F1E665F66003326FB /* MultiRelativeView */,
-				2439CC631E66606D003326FB /* RelativeView */,
 				24CD1E8D1F8E4B0A00C3A54D /* PinLayoutSample-Bridging-Header.h */,
 			);
 			path = Examples;
@@ -460,6 +469,25 @@
 			path = AutoAdjustingSize;
 			sourceTree = "<group>";
 		};
+		DFBCAEF82130127F0025F7BF /* Cells */ = {
+			isa = PBXGroup;
+			children = (
+				DFBCAEF9213012930025F7BF /* MethodReadableInsetsGroupHeader.swift */,
+				DFBCAEFA213012930025F7BF /* MethodReadableInsetsCell.swift */,
+			);
+			path = Cells;
+			sourceTree = "<group>";
+		};
+		DFD31B9D212EE4D600566CA4 /* ReadableMargins */ = {
+			isa = PBXGroup;
+			children = (
+				DFBCAEF82130127F0025F7BF /* Cells */,
+				DFD31B9E212EE4F100566CA4 /* TableViewReadableContentView.swift */,
+				DFD31B9F212EE4F200566CA4 /* TableViewReadableContentViewController.swift */,
+			);
+			path = ReadableMargins;
+			sourceTree = "<group>";
+		};
 		DFEAF71520C840F300E33147 /* WrapContent */ = {
 			isa = PBXGroup;
 			children = (
@@ -663,6 +691,7 @@
 			files = (
 				DF4C1AAF205AF78A00DED50B /* SafeAreaCornersView.swift in Sources */,
 				24F246141FA8D57100B6332E /* UIImageView+Download.swift in Sources */,
+				DFBCAEFC213012930025F7BF /* MethodReadableInsetsCell.swift in Sources */,
 				24DA374B1EF7F90600D1AB2F /* BaseFormView.swift in Sources */,
 				24F75B5C1EE5644E008DB567 /* IntroViewController.swift in Sources */,
 				241637741F8E4BC200EE703A /* IntroObjectiveCViewController.m in Sources */,
@@ -689,6 +718,8 @@
 				DF4C1AA5205AEDFC00DED50B /* SafeAreaViewController.swift in Sources */,
 				DFEAF74A20C9648A00E33147 /* WrapContentView.swift in Sources */,
 				249EFE431E64FAFE00165E39 /* AppDelegate.swift in Sources */,
+				DFD31BA1212EE4F200566CA4 /* TableViewReadableContentViewController.swift in Sources */,
+				DFBCAEFB213012930025F7BF /* MethodReadableInsetsGroupHeader.swift in Sources */,
 				2497CFEE1EF40B9100DFD13B /* FormViewController.swift in Sources */,
 				24A9C1F31EF0542F00F2CF64 /* TableViewExampleViewController.swift in Sources */,
 				24CB99981F290540004EA7FB /* MethodGroupHeader.swift in Sources */,
@@ -699,6 +730,7 @@
 				241637771F8E4F9100EE703A /* IntroObjectiveCView.m in Sources */,
 				24CB99A01F290664004EA7FB /* ChoiceSelectorView.swift in Sources */,
 				249326891EEEEE3D00BCB814 /* Stylesheet.swift in Sources */,
+				DFD31BA0212EE4F200566CA4 /* TableViewReadableContentView.swift in Sources */,
 				DF39089A211900480049FD56 /* AnimationsViewController.swift in Sources */,
 				2439CC521E665C6B003326FB /* MultiRelativeView.swift in Sources */,
 				24F246101FA8D4D100B6332E /* CollectionViewExampleView.swift in Sources */,

Example/PinLayoutSample/UI/Examples/ReadableMargins/Cells/MethodReadableInsetsCell.swift

@@ -0,0 +1,66 @@
+import Foundation
+
+class MethodReadableInsetsCell: UITableViewCell {
+    static let reuseIdentifier = "MethodReadableInsetsCell"
+
+    private let iconImageView = UIImageView(image: UIImage(named: "method"))
+    private let nameLabel = UILabel()
+    private let descriptionLabel = UILabel()
+    private let margin: CGFloat = 10
+
+    override init(style: UITableViewCellStyle, reuseIdentifier: String?) {
+        super.init(style: style, reuseIdentifier: reuseIdentifier)
+
+        selectionStyle = .none
+        separatorInset = .zero
+        preservesSuperviewLayoutMargins = false
+
+        contentView.addSubview(iconImageView)
+
+        nameLabel.font = UIFont.boldSystemFont(ofSize: 14)
+        nameLabel.lineBreakMode = .byTruncatingTail
+        contentView.addSubview(nameLabel)
+
+        descriptionLabel.font = UIFont.systemFont(ofSize: 12)
+        descriptionLabel.numberOfLines = 0
+        contentView.addSubview(descriptionLabel)
+    }
+
+    required init?(coder aDecoder: NSCoder) {
+        super.init(coder: aDecoder)
+    }
+
+    func configure(method: Method) {
+        nameLabel.text = method.name
+        descriptionLabel.text = method.description
+    }
+
+    override func layoutSubviews() {
+        super.layoutSubviews()
+        layout()
+    }
+
+    private func layout() {
+        // 1) Layout the contentView
+        contentView.pin.top(layoutMargins).horizontally(pin.readableMargins)
+
+        // 2) Layout contentView's childs
+        iconImageView.pin.top().left().size(30)
+        nameLabel.pin.after(of: iconImageView, aligned: .center).right().marginHorizontal(margin).sizeToFit(.width)
+        descriptionLabel.pin.below(of: [iconImageView, nameLabel]).horizontally().marginTop(margin).sizeToFit(.width)
+
+        // 3) Adjust the contentView size to wrap its childs
+        contentView.pin.wrapContent(.vertically)
+    }
+
+    override func sizeThatFits(_ size: CGSize) -> CGSize {
+        // 1) Set the width to the specified size parameter
+        pin.width(size.width)
+
+        // 2) Layout the contentView's controls
+        layout()
+
+        // 3) Returns a size that contains all views
+        return CGSize(width: size.width, height: contentView.frame.maxY + margin + layoutMargins.bottom)
+    }
+}

Example/PinLayoutSample/UI/Examples/ReadableMargins/Cells/MethodReadableInsetsGroupHeader.swift

@@ -0,0 +1,51 @@
+//  Copyright (c) 2017 Luc Dion
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import UIKit
+
+class MethodReadableInsetsGroupHeader: UITableViewHeaderFooterView {
+    static let reuseIdentifier = "MethodReadableInsetsGroupHeader"
+    static let height: CGFloat = 50
+    
+    fileprivate let titleLabel = UILabel()
+    
+    override init(reuseIdentifier: String?) {
+        super.init(reuseIdentifier: reuseIdentifier)
+
+        preservesSuperviewLayoutMargins = false
+        
+        titleLabel.font = .systemFont(ofSize: 20)
+        contentView.addSubview(titleLabel)
+    }
+    
+    required init?(coder aDecoder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+    
+    func configure(title: String) {
+        titleLabel.text = title
+    }
+    
+    override func layoutSubviews() {
+        super.layoutSubviews()
+
+        contentView.pin.horizontally(pin.readableMargins)
+        titleLabel.pin.horizontally().vCenter().sizeToFit(.width)
+    }
+}

Example/PinLayoutSample/UI/Examples/ReadableMargins/TableViewReadableContentView.swift

@@ -0,0 +1,85 @@
+//  Copyright (c) 2017 Luc Dion
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import UIKit
+
+class TableViewReadableContentView: UIView {
+
+    fileprivate let tableView = UITableView()
+    fileprivate let methodCellTemplate = MethodReadableInsetsCell()
+    fileprivate var methods: [Method] = []
+    
+    init() {
+        super.init(frame: .zero)
+        backgroundColor = .white
+
+        tableView.dataSource = self
+        tableView.delegate = self
+        tableView.tableFooterView = UIView()
+        tableView.register(MethodReadableInsetsCell.self, forCellReuseIdentifier: MethodReadableInsetsCell.reuseIdentifier)
+        tableView.register(MethodReadableInsetsGroupHeader.self, forHeaderFooterViewReuseIdentifier: MethodReadableInsetsGroupHeader.reuseIdentifier)
+        addSubview(tableView)
+    }
+    
+    required init?(coder aDecoder: NSCoder) {
+        super.init(coder: aDecoder)
+    }
+    
+    func configure(methods: [Method]) {
+        self.methods = methods
+        tableView.reloadData()
+    }
+    
+    override func layoutSubviews() {
+        super.layoutSubviews()
+        
+        tableView.pin.all()
+    }
+}
+
+// MARK: UITableViewDataSource, UITableViewDelegate
+extension TableViewReadableContentView: UITableViewDataSource, UITableViewDelegate {
+    func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat {
+        return MethodReadableInsetsGroupHeader.height
+    }
+    
+    func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
+        let header = tableView.dequeueReusableHeaderFooterView(withIdentifier: MethodReadableInsetsGroupHeader.reuseIdentifier) as! MethodReadableInsetsGroupHeader
+        header.configure(title: "PinLayout few methods")
+        return header
+    }
+    
+    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
+        return methods.count
+    }
+    
+    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
+        let cell = tableView.dequeueReusableCell(withIdentifier: MethodReadableInsetsCell.reuseIdentifier, for: indexPath) as! MethodReadableInsetsCell
+        cell.configure(method: methods[indexPath.row])
+        
+        return cell
+    }
+    
+    func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
+        // WARNING: 
+        // Configure a MethodReadableInsetsCell and ask its size.
+        methodCellTemplate.configure(method: methods[indexPath.row])
+        return methodCellTemplate.sizeThatFits(CGSize(width: tableView.bounds.width, height: .greatestFiniteMagnitude)).height
+    }
+}

Example/PinLayoutSample/UI/Examples/ReadableMargins/TableViewReadableContentViewController.swift

@@ -0,0 +1,55 @@
+//  Copyright (c) 2017 Luc Dion
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import UIKit
+
+class TableViewReadableContentViewController: UIViewController {
+    fileprivate var mainView: TableViewReadableContentView {
+        return self.view as! TableViewReadableContentView
+    }
+
+    init(pageType: PageType) {
+        super.init(nibName: nil, bundle: nil)
+        
+        title = pageType.text
+    }
+    
+    required init?(coder aDecoder: NSCoder) {
+        super.init(coder: aDecoder)
+    }
+    
+    override func loadView() {
+        view = TableViewReadableContentView()
+        mainView.configure(methods: [
+            Method(name: "top(_ value: CGFloat)", description: "The value specifies the top edge distance from the superview's top edge in pixels."),
+            Method(name: "top(_ percent: Percent)", description: "The value specifies the top edge distance from the superview's top edge in percentage of its superview's height."),
+            Method(name: "vCenter(_ value: CGFloat)", description: "The value specifies the distance vertically of the view's center related to the superview's center in pixels."),
+            Method(name: "vCenter(_ percent: Percent)", description: "The value specifies the distance vertically of the view's center related to the superview's center in percentage of its superview's height."),
+            Method(name: "bottom(_ value: CGFloat)", description: "The value specifies the bottom edge distance from the superview's bottom edge in pixels."),
+            Method(name: "bottom(_ percent: Percent)", description: "The value specifies the bottom edge distance from the superview's bottom edge in percentage of its superview's height."),
+            
+            Method(name: "left(_ value: CGFloat)", description: "The value specifies the left edge distance from the superview's left edge in pixels. The value specifies the left edge distance from the superview's left edge in pixels."),
+            Method(name: "left(_ percent: Percent)", description: "The value specifies the left edge distance from the superview's left edge in percentage of its superview's width."),
+            Method(name: "hCenter(_ value: CGFloat)", description: "The value specifies the distance horizontally of the view's center related to the superview's center in pixels."),
+            Method(name: "hCenter(_ percent: Percent)", description: "The value specifies the distance horizontally of the view's center related to the superview's center in percentage of its superview's height."),
+            Method(name: "right(_ value: CGFloat)", description: "The value specifies the right edge distance from the superview's right edge in pixels."),
+            Method(name: "right(_ percent: Percent)", description: "The value specifies the right edge distance from the superview's right edge in percentage of its superview's width.")
+        ])
+    }
+}