RSFontSizes
What is it?
RSFontSize allows you to manage different font sizes for every device screen size in a flexible manner.
- No more family name and styles typing/guessing every time you use a font.
- Flexible size configurations(Fixed, Proportional to screen size and user specific).
- Smart size estimation for vague specifications.
- Save your font configurations for different UIFontTextStyle(.body, .headline, etc).
Installation
Cocoapods
RSFontSizes is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "RSFontSizes"
Carthage
- Add the following sources to your Cartfile:
github "rootstrap/RSFontSizes" ~> 1.2.0
-
Run the
carthage update
command in the terminal. -
Link the resulting RSFontSizes.framework and Device.framework to your project.
Quick peek
From poorly managed font sizes:
Fonts are set directly from IB.
To readable texts:
Fonts using RSFontSizes.
Start using RSFontSizes
Just link your font assets to the project. Very detailed guide here.
If there are too many font files to add, FontBlaster pod is strongly recommended. It's a simple solution to load your assets automatically instead of manually adding every file to the Info.plist.
Optionally add shortcuts to your favourite fonts.
extension Font {
//Your Custom font family names
static let raleway = "Raleway".font()!
}
Perks
There are different types to get your fonts correctly sized:
-Fixed: The consumer sets the font point size or uses one of the provided classes(.small, .medium, etc).
let font = Font.raleway.small
No magic here :)
-Proportional: The consumer will specify a base font size asociated with a device screen size.
let font = Font.raleway.proportional(to: (.screen3_5Inch, 10))
The result will be a font resized accordingly for the current device screen size.
-Screen Specific: The consumer defines a set of font sizes linked to an specific screen size.
let font = Font.raleway.specific(values: [.screen4Inch: 12,
.screen4_7Inch: 13.5,
.screen5_5Inch: 16,
.screen9_7Inch: 20.2]))
If a screen size is not specified the library will try to estimate the correct value for the font size.
You can also...
Use a String as the Font family name
let font = "Raleway".font(withWeight: .bold,
size: .fixed(20))
Save your 'templates' to reuse
Font.save(font: someFont, forClass: .body)
And then use it elsewhere:
let label.font = Font.with(class: .body)
Example
To run the example project, clone the repo, and run pod install
from the Example directory first.
Author
Rootstrap Inc., [email protected]
License
RSFontSizes is available under the MIT license. See the LICENSE file for more info.