You can either run pod try Font from your command line or clone the repo and run pod install from the Example directory followed by loading up the Example workspace.
Font is Swift 4.2 ready. If you need builds for previous versions of Swift try the swift3 or swift2.3 branches. While these are available they will not receive updates except for the occasional bugfix.
Changes required by the 4.0 change:
fromUIFontwas removed. There will be no replacement until1.0ships with an entirely new API.
First step, you need to make a Font extension to properly describe how your custom font responds to various weights and styles. Here's an example for Adobe’s Source Sans Pro. Note that the function SourceSansPro’s name and signature are entirely fabricated. You could name it StandardFont or BodyFont. You could withhold options for italic or size. Entirely up to you and the flexibility of your font.
extension Font {
private static func sourceSansProWeight(weight:FontWeight) -> String {
switch weight {
case .Ultralight:
return "ExtraLight"
case .Thin:
fallthrough
case .Light:
return "Light"
case .Regular:
fallthrough
case .Medium:
return "Regular"
case .Semibold:
return "Semibold"
case .Heavy:
return "Bold"
case .Black:
return "Black"
}
}
private static func name(weight:FontWeight, style:FontStyle) -> String {
let base = "SourceSansPro"
let weightNumber = sourceSansProWeight(weight)
let weightAndStyle:String
switch style {
case _ where style == .Italic && (weight == .Regular || weight == .Medium):
weightAndStyle = "It"
case .Italic:
weightAndStyle = "\(weightNumber)It"
default:
weightAndStyle = weightNumber
}
return "\(base)-\(weightAndStyle)"
}
static func SourceSansPro(size:CGFloat = 16, weight:FontWeight = .Medium, style:FontStyle = .None) -> Font {
let fontName = name(weight, style:style)
return Font(fontName: fontName, size: size)
}
}Great! Now use your custom font. Create an instance of your Font and generate a UIFont to assign to some UILabel. Then, configure your view controller (or what have you) to pay attention to when the user changes the Dynamic Type size. You don't have to worry about what size the user has picked, Font will take care of that.
class ViewController: UIViewController {
@IBOutlet weak var exampleLabel:UILabel!
var headlineFont:Font!
override func viewDidLoad() {
super.viewDidLoad()
headlineFont = Font.SourceSansPro(36, style: .Italic)
exampleLabel.font = headlineFont.generate()
}
extension ViewController: DynamicTypeListener {
// Subscribe to UIContentSizeCategoryDidChangeNotification notifications
override func viewWillAppear(animated: Bool) {
super.viewWillAppear(animated)
listenForDynamicTypeChanges()
}
// Unsubscribe from UIContentSizeCategoryDidChangeNotification notifications
override func viewWillDisappear(animated: Bool) {
super.viewWillDisappear(animated)
ignoreDynamicTypeChanges()
}
// Do something when UIContentSizeCategoryDidChangeNotification notifications come in
func respondToDynamicTypeChanges(notification:NSNotification) {
exampleLabel.font = headlineFont.generate()
}
}
Want more control over exactly what point size is chosen for the Dynamic Type size the user has set? Define your own parser and pass it to the generate() function when creating a UIFont instance.
…
func restrainedSizes(sizeClass:String) -> CGFloat {
let adjustedSize:CGFloat
switch sizeClass {
case UIContentSizeCategoryExtraSmall:
fallthrough
case UIContentSizeCategorySmall:
fallthrough
case UIContentSizeCategoryMedium:
fallthrough
case UIContentSizeCategoryLarge:
adjustedSize = size //16
case UIContentSizeCategoryExtraLarge:
adjustedSize = floor(size * 1.15) //18
case UIContentSizeCategoryExtraExtraLarge:
adjustedSize = floor(size * 1.25) //20
case UIContentSizeCategoryExtraExtraExtraLarge:
adjustedSize = floor(size * 1.4) //22
case UIContentSizeCategoryAccessibilityMedium:
fallthrough
case UIContentSizeCategoryAccessibilityLarge:
fallthrough
case UIContentSizeCategoryAccessibilityExtraLarge:
fallthrough
case UIContentSizeCategoryAccessibilityExtraExtraLarge:
fallthrough
case UIContentSizeCategoryAccessibilityExtraExtraExtraLarge:
adjustedSize = floor(size * 1.65) //26
default:
adjustedSize = 16
}
return adjustedSize
}
func updateFonts() {
someLabel.font = yourFont.generate(resizer:restrainedSizes)
}
…- Swift
- Licensed font
Font is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "Font"- Did you add your fonts to your
Info.plist? - Did you create an extension for
Fontwith your custom font rules? - Does your font support the weights you want? Unless it’s a full family you might not have ultralight or black weights.
- Does your extension correctly name the font? Use Font Book (
/Applications/Font Book.app) to check the PostScript name of the font.
- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
- Fork the project and submit a pull request from a feature or bugfix branch.
- Please include tests. This is important so we don't break your changes unintentionally in a future version.
- Please don't modify the podspec, version, or changelog. If you do change these files, please isolate a separate commit so we can cherry-pick around it.
Adam Yanalunas, [email protected]
Font is available under the MIT license. See the LICENSE file for more info.