Skip to content
FontAwesome 5 Swift implementation for iOS, tvOS & macOS
Swift Other
  1. Swift 98.4%
  2. Other 1.6%
Branch: master
Clone or download
rafiki270 Merge pull request #44 from ghowen/master
Removed deprecated .swift-version file
Latest commit 3d6ae1c May 28, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Assets - Update for Swift 5 Apr 2, 2019
AwesomeEnum-iOS new project structure Apr 5, 2018
AwesomeEnum-macOS
AwesomeEnum-tvOS new project structure Apr 5, 2018
AwesomeEnum-watchOS Adds watchOS support Jul 8, 2018
AwesomeEnum.xcodeproj
Classes - Update for Swift 5 Apr 2, 2019
Generator - Update for Swift 5 Apr 2, 2019
.gitignore Codes should be ok Oct 14, 2017
AwesomeEnum.podspec Update AwesomeEnum.podspec Apr 3, 2019
LICENSE Create LICENSE Apr 5, 2018
README.md

README.md

Awesome

Font Awesome Slack Version License Platform

Super easy to use library containing the brand new Font Awesome 5, completely redesigned for Swift 4

Slack

Get help using and installing this product on our Slack, channel #help-awesome

Installation

Awesome is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'AwesomeEnum'

for Carthage just add:

github "LiveUI/Awesome"

Usage

Import will be slightly different for Cocoapods/Carthage. Sorry for the confusion of names but some unreasonable fellow has already registered an Awesome pod before us :).

Cocoapods

import AwesomeEnum

Carthage

import Awesome

All icons are available through autogenerated enums like this:

let image = Awesome.solid.handScissors.asImage(size: 40.0)
// or
let image = Awesome.brand.android.asImage(size: CGSize(width: 40, height: 40), color: .red, backgroundColor: .blue) // :trollface:
// or
let attributedText = Awesome.regular.envelopeOpen.asAttributedText(fontSize: 17, color: .red, backgroundColor: .blue)

Font Awesome Pro

The Font Awesome Free files are included and loaded for you out of the box. Font Awesome Pro licensing terms don't allow to publish the font files however, so we can't add those for you. As such you will need to manually add the fonts to your project and register them before using them:

// AppDelegate application(_:didFinishLaunchingWithOptions:)

// Load all fonts
AwesomePro.loadFonts(from: Bundle.main)

// Load only some fonts
AwesomePro.loadFonts(from: Bundle.main, only: [.brand, .solid])

The filenames have to match Font Awesome's naming scheme (fa-brands-400.ttf, fa-light-300.ttf, fa-regular-400.ttf, fa-solid-900.ttf). You only have to include the fonts you are using.

Once the fonts are registered you can use the AwesomePro enum just as you'd use the Awesome enum, except that you now have access to all Font Awesome Pro icons.

Contributors

License

Awesome is available under the MIT license. See the LICENSE for more info. All fonts are property of Font Awesome!

You can’t perform that action at this time.