Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rootstrap/rsfontsizes
RSFontSizes pod repository. Allows you to customize fonts and sizes in different screen sizes.
https://github.com/rootstrap/rsfontsizes
carthage cocoapod font font-size fonts helper library pod screen-size swift utility
Last synced: 3 months ago
JSON representation
RSFontSizes pod repository. Allows you to customize fonts and sizes in different screen sizes.
- Host: GitHub
- URL: https://github.com/rootstrap/rsfontsizes
- Owner: rootstrap
- License: mit
- Created: 2017-08-01T14:33:01.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-08-08T17:04:34.000Z (over 1 year ago)
- Last Synced: 2024-10-31T16:12:39.431Z (3 months ago)
- Topics: carthage, cocoapod, font, font-size, fonts, helper, library, pod, screen-size, swift, utility
- Language: Swift
- Homepage: https://rootstrap.com/
- Size: 1.21 MB
- Stars: 27
- Watchers: 9
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RSFontSizes
[](https://travis-ci.org/rootstrap/RSFontSizes)
[](https://github.com/Carthage/Carthage)
[](http://cocoapods.org/pods/RSFontSizes)
[](http://cocoapods.org/pods/RSFontSizes)
[](http://cocoapods.org/pods/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
### Swift Package Manager
```
https://github.com/rootstrap/RSFontSizes
```
- In XCode 11, go to File -> Swift Packages -> Add Package Dependency.
- Enter the repo URL (https://github.com/rootstrap/RSFontSizes) and click Next.
- Select the version rule desired (you can specify a version number, branch, or commit) and click Next.
- Finally, select the target where you want to use the framework.
**Note:** It is always recommended to lock your external libraries to a specific version.
### Cocoapods
RSFontSizes is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "RSFontSizes"
```
### Carthage
1. Add the following sources to your Cartfile:
```
github "rootstrap/RSFontSizes" ~> 1.3.3
```
2. Run the `carthage update` command in the terminal.
3. 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](http://codewithchris.com/common-mistakes-with-adding-custom-fonts-to-your-ios-app/).
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.
```swift
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).
```swift
let font = Font.raleway.small
```
No magic here :)
-Proportional: The consumer will specify a base font size asociated with a device screen size.
```swift
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.
```swift
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
```swift
let font = "Raleway".font(withWeight: .bold,
size: .fixed(20))
```
#### Save your 'templates' to reuse
```swift
Font.save(font: someFont, forClass: .body)
```
And then use it elsewhere:
```swift
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.
## Credits
**RSFontSizes** is maintained by [Rootstrap](http://www.rootstrap.com) and [German López](https://github.com/glm4) with the help of our [contributors](https://github.com/rootstrap/RSFontSizes/contributors).
## License
RSFontSizes is available under the MIT license. See the LICENSE file for more info.
[
](http://www.rootstrap.com)