RSFontSizes 1.3.2

RSFontSizes 1.3.2

TestsTested
LangLanguage SwiftSwift
License MIT
ReleasedLast Release Aug 2023
SPMSupports SPM

Maintained by German Lopez, Camila Moscatelli.




RSFontSizes

CI Status Carthage compatible Version License Platform

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

  1. Add the following sources to your Cartfile:
github "rootstrap/RSFontSizes" ~> 1.2.0
  1. Run the carthage update command in the terminal.

  2. Link the resulting RSFontSizes.framework and Device.framework to your project.

Quick peek

From poorly managed font sizes:

Normal Preview

Fonts are set directly from IB.

To readable texts:

Preview With RSFontSizes

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.