SwiftIconFont: A Swift repository from rdougan

Installation

Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate SwiftIconFont into your Xcode project using Carthage, specify it in your Cartfile:

github "0x73/SwiftIconFont"

Cocoapods

CocoaPods is a dependency manager for Cocoa projects.

You can install it with the following command:

$ gem install cocoapods

To integrate SwiftIconFont into your Xcode project using CocoaPods, specify it in your Podfile:

use_frameworks!

pod 'SwiftIconFont'

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Prefixes

Font	Prefix	Cheat Sheet
Font Awesome	fa:	List
Ion Icons	io:	List
Octicons	oc:	List
Open Iconic	ic:	List
Material Icon	ma:	List
Themify	ti:	List
Map Icons	mi:	List

Fonts

public enum Fonts: String {
    case FontAwesome = "FontAwesome"
    case Iconic = "open-iconic"
    case Ionicon = "Ionicons"
    case Octicon = "octicons"
    case Themify = "themify"
    case MapIcon = "map-icons"
    case MaterialIcon = "MaterialIcons-Regular"
}

Runtime Structure

###< Prefix >:< Icon >

##Usage

In your UILabel, UIButton or UITextField, set a text containing a placeholder anywhere you want the icon to be. Somethink like this

oc:logo-github

Then you can choose between 3 ways you can use SwiftIconFont.

####1. No Custom Class

Simply import SwiftIconFont and call processIcons on any UILabel, UIButton or UITextField that has a placeholder.

label.parseIcon()

####2. Custom Class

The lazy way, just set your UILabel, UITextField, UIButton, UITextView, UIBarButtonItem class as SwiftIconLabel, SwiftIconTextField, SwiftIconButton, SwiftIconTextView, SwiftBarButtonItem, and thats it, your icons will be processed at runtime.

####3. Programmatically

import SwiftIconFont

label.font = UIFont.icon(from: .FontAwesome, ofSize: 50.0)
label.text = String.fontAwesomeIcon(code: "twitter")

####UIBarButtonItem (No Custom Class)

import SwiftIconFont

twitterBarButton.icon(from: .FontAwesome, code: "twitter", ofSize: 20)

####UITabBarItem (No Custom Class)

import SwiftIconFont

twitterTabBarButton.icon(from: .FontAwesome, code: "twitter", imageSize: CGSizeMake(20, 20), ofSize: 20)

Author

Sedat Gokbek CIFTCI, me@sedat.ninja
Jose Quintero, @josejuanqm

License

SwiftIconFont is available under the MIT license. See the LICENSE file for more info.

Contributing

Fork it (http://github.com/0x73/SwiftIconFont/fork)
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

rdougan/SwiftIconFont