0.12.0

Author: Geri-Borbas

CHANGELOG.md

@@ -4,6 +4,10 @@
 
 	+ (May) lookup baseline reset issue with overflowing text
 
+* 0.12.0
+
+	+ Update `README.md`
+
 * 0.10.0 - 0.11.0
 
 	+ Added `MarsViewController` 

Documentation/UILabel_Line_Height_NSAttributedString_BaselineOffset.png

@@ -1,23 +1,34 @@
 # UILabel Typography Extensions 📐
-Set line height, letter spacing (and more) directly on `UILabel`.
+Set `UILabel` line height, letter spacing (and more).
 
 ```Swift
-let label = UILabel()
-label.text = "Hello World!"
-label.textColor = .label
-label.font = .preferredFont(forTextStyle: .largeTitle)
-// 🎉
-label.lineHeight = 100
-label.letterSpacing = 10
-label.underline = .double
-label.strikethrough = .patternDash
+let headerLabel = UILabel()
+headerLabel.text = "Mars"
+headerLabel.textColor = label
+headerLabel.font = UIFont(name: "HelveticaNeue-CondensedBlack", size: 100)
+headerLabel.lineHeight = 80
+headerLabel.letterSpacing = 100 * -0.02
 ```
 
-A single extension on `UILabel` that adds some typographic property (see above) using [**Objective-C Runtime**] (for stored properties on a Swift extension), [`NSAttributedString`] (for manage typographic properties), and [`NSKeyValueObservation`] (to be able to use the regular `text` property to manage text content).
+<p align="center"><img src="UILabel_Typography_Extensions/Documentation/UlLabel_Line_Height_Letter_Spacing_Extension.png" width="900"></p>
 
 See the complementary article at [**UILabel line height, letter spacing and more** UILabel typography extensions].
 
-> 🚧  **Work in progress**. I have high hopes to add leading and trailing image feature, as well as support for `UIButton`.
+<p align="center"><img src="UILabel_Typography_Extensions/Documentation/UILabel_Line_Height_Simulator_Figma_Overlay.png" width="900"></p>
+
+## How it works
+
+It is an extension on `UILabel` that adds some typographic properties using [**Objective-C Runtime**] (for stored properties on a Swift extension), [`NSAttributedString`] (for manage typographic properties), and [`NSKeyValueObservation`] (to be able to use the regular `text` property to manage text content).
+
+<p align="center"><img src="UILabel_Typography_Extensions/Documentation/UILabel_Line_Height_NSAttributedString_BaselineOffset.png" width="900"></p>
+
+It also takes care of `baselineOffset` values to keep the text content in the vertical center (right). By default, :NSAttributedString: sticks multiline label content to the top of the container view (left), which makes it hard to 
+match the UI with the design specifications.
+
+<p align="center"><img src="UILabel_Typography_Extensions/Documentation/UILabel_Line_Height_Xcode_Figma.png" width="900"></p>
+
+Using this extension you can build screens that 100% match design specifications. More on that in the article at [**UILabel line height, letter spacing and more** UILabel typography extensions].
+
 
 ## License
 

Documentation/UILabel_Line_Height_Simulator_Figma_Overlay.png

@@ -16,6 +16,10 @@
 		5558DA4627DA1FA900A4A178 /* MockupViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5558DA4527DA1FA900A4A178 /* MockupViewController.swift */; };
 		55722E1E27DB6167002DE7DC /* MarsViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 55722E1D27DB6167002DE7DC /* MarsViewController.swift */; };
 		55722E1F27DB63BC002DE7DC /* PlanetViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 559E70FC27D90D0E00C00AD7 /* PlanetViewController.swift */; };
+		557D5F8227DE08EB00A7DE15 /* UILabel_Line_Height_Simulator_Figma_Overlay.png in Resources */ = {isa = PBXBuildFile; fileRef = 557D5F8027DE08EB00A7DE15 /* UILabel_Line_Height_Simulator_Figma_Overlay.png */; };
+		557D5F8327DE08EB00A7DE15 /* UlLabel_Line_Height_Letter_Spacing_Extension.png in Resources */ = {isa = PBXBuildFile; fileRef = 557D5F8127DE08EB00A7DE15 /* UlLabel_Line_Height_Letter_Spacing_Extension.png */; };
+		557D5F8527DE09BB00A7DE15 /* UILabel_Line_Height_NSAttributedString_BaselineOffset.png in Resources */ = {isa = PBXBuildFile; fileRef = 557D5F8427DE09BB00A7DE15 /* UILabel_Line_Height_NSAttributedString_BaselineOffset.png */; };
+		557D5F8727DE0AAC00A7DE15 /* UILabel_Line_Height_Xcode_Figma.png in Resources */ = {isa = PBXBuildFile; fileRef = 557D5F8627DE0AAC00A7DE15 /* UILabel_Line_Height_Xcode_Figma.png */; };
 		559795E525A259E400A757A3 /* UIColor+Styles.swift in Sources */ = {isa = PBXBuildFile; fileRef = 559795E425A259E400A757A3 /* UIColor+Styles.swift */; };
 		559FB34E25A4B1A200CE795D /* LineHeightViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 559FB34D25A4B1A200CE795D /* LineHeightViewController.swift */; };
 		55A3EECE27D7F24C0002193A /* UIFont+Inspection.swift in Sources */ = {isa = PBXBuildFile; fileRef = 55A3EECD27D7F24C0002193A /* UIFont+Inspection.swift */; };
@@ -47,6 +51,10 @@
 		554AF31725961B6200A23E41 /* README.md */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = net.daringfireball.markdown; path = README.md; sourceTree = "<group>"; };
 		5558DA4527DA1FA900A4A178 /* MockupViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MockupViewController.swift; sourceTree = "<group>"; };
 		55722E1D27DB6167002DE7DC /* MarsViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MarsViewController.swift; sourceTree = "<group>"; };
+		557D5F8027DE08EB00A7DE15 /* UILabel_Line_Height_Simulator_Figma_Overlay.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = UILabel_Line_Height_Simulator_Figma_Overlay.png; sourceTree = "<group>"; };
+		557D5F8127DE08EB00A7DE15 /* UlLabel_Line_Height_Letter_Spacing_Extension.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = UlLabel_Line_Height_Letter_Spacing_Extension.png; sourceTree = "<group>"; };
+		557D5F8427DE09BB00A7DE15 /* UILabel_Line_Height_NSAttributedString_BaselineOffset.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = UILabel_Line_Height_NSAttributedString_BaselineOffset.png; sourceTree = "<group>"; };
+		557D5F8627DE0AAC00A7DE15 /* UILabel_Line_Height_Xcode_Figma.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = UILabel_Line_Height_Xcode_Figma.png; sourceTree = "<group>"; };
 		559795E425A259E400A757A3 /* UIColor+Styles.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "UIColor+Styles.swift"; sourceTree = "<group>"; };
 		559E70FC27D90D0E00C00AD7 /* PlanetViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PlanetViewController.swift; sourceTree = "<group>"; };
 		559FB34D25A4B1A200CE795D /* LineHeightViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LineHeightViewController.swift; sourceTree = "<group>"; };
@@ -98,6 +106,17 @@
 			path = Typography;
 			sourceTree = "<group>";
 		};
+		557D5F7F27DE08DC00A7DE15 /* Documentation */ = {
+			isa = PBXGroup;
+			children = (
+				557D5F8627DE0AAC00A7DE15 /* UILabel_Line_Height_Xcode_Figma.png */,
+				557D5F8427DE09BB00A7DE15 /* UILabel_Line_Height_NSAttributedString_BaselineOffset.png */,
+				557D5F8027DE08EB00A7DE15 /* UILabel_Line_Height_Simulator_Figma_Overlay.png */,
+				557D5F8127DE08EB00A7DE15 /* UlLabel_Line_Height_Letter_Spacing_Extension.png */,
+			);
+			path = Documentation;
+			sourceTree = "<group>";
+		};
 		558D107725A15277005DB3DA /* Deprecated */ = {
 			isa = PBXGroup;
 			children = (
@@ -140,6 +159,7 @@
 			children = (
 				554AF31725961B6200A23E41 /* README.md */,
 				554A2DCF27D67B66008A4AE4 /* CHANGELOG.md */,
+				557D5F7F27DE08DC00A7DE15 /* Documentation */,
 				55F236A025912BBE0007BC69 /* UILabel_Typography_Extensions */,
 				55F2369F25912BBE0007BC69 /* Products */,
 			);
@@ -237,8 +257,12 @@
 			isa = PBXResourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				557D5F8327DE08EB00A7DE15 /* UlLabel_Line_Height_Letter_Spacing_Extension.png in Resources */,
 				55F236AE25912BC30007BC69 /* LaunchScreen.storyboard in Resources */,
 				554AF31825961B6200A23E41 /* README.md in Resources */,
+				557D5F8727DE0AAC00A7DE15 /* UILabel_Line_Height_Xcode_Figma.png in Resources */,
+				557D5F8527DE09BB00A7DE15 /* UILabel_Line_Height_NSAttributedString_BaselineOffset.png in Resources */,
+				557D5F8227DE08EB00A7DE15 /* UILabel_Line_Height_Simulator_Figma_Overlay.png in Resources */,
 				55F236A825912BC30007BC69 /* Assets.xcassets in Resources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;