安装
SPM
尚不支持。请使用 Cocoapods 或 Carthage
Carthage
github "0x73/SwiftIconFont"
Cocoapods
CocoaPods 是 Cocoa 项目的依赖管理器。
您可以使用以下命令安装它:
$ gem install cocoapods
要使用 CocoaPods 将 SwiftIconFont 集成到您的 Xcode 项目中,请在您的 Podfile
中指定它。
use_frameworks!
pod 'SwiftIconFont'
示例
要运行示例项目,请克隆存储库,然后从Example目录运行pod install
。
前缀
字体 | 前缀 | 速查表 |
---|---|---|
Font Awesome 5 | fa5 | 列表 |
Font Awesome 5 Brand | fa5b | 列表 |
Font Awesome 5 Solid | fa5s | 列表 |
IonIcons | io | 列表 |
Octicons | oc | 列表 |
Open Iconic | ic | 列表 |
Material Icons | ma | 列表 |
Themify | ti | 列表 |
Map Icons | mi | 列表 |
Segoe MDL2 | sm | 列表 |
Foundation 3 | fo | 列表 |
Elegant Icon | el | 列表 |
Captain | cp | 请检查示例项目。 |
字体
public enum Fonts: String {
case fontAwesome5 = "FontAwesome5Free-Regular"
case fontAwesome5Brand = "FontAwesome5Brands-Regular"
case fontAwesome5Solid = "FontAwesome5Free-Solid"
case iconic = "open-iconic"
case ionicon = "Ionicons"
case octicon = "octicons"
case themify = "themify"
case mapIcon = "map-icons"
case materialIcon = "MaterialIcons-Regular"
case segoeMDL2 = "Segoe mdl2 assets"
case foundation = "fontcustom"
case elegantIcon = "ElegantIcons"
case captain = "captainicon"
}
Storyboard
运行时结构
< Prefix >:< Icon >
使用方法
在你的UILabel、UIButton或UITextField中,设置一个包含占位符的文本,你想要放置图标的位置。例如:
oc:logo-github
然后你可以选择三种使用SwiftIconFont的方法。
1. 无自定义类
简单导入SwiftIconFont,并在具有占位符的任何UILabel、UIButton或UITextField上调用processIcons。
label.parseIcon()
2. 自定义类
懒人方式,只需将你的UILabel、UITextField、UIButton、UITextView、UIBarButtonItem类设为SwiftIconLabel、SwiftIconTextField、SwiftIconButton、SwiftIconTextView、SwiftBarButtonItem,然后运行时就会处理图标。
3. 编程方式
import SwiftIconFont
label.font = UIFont.icon(from: .fontAwesome5, ofSize: 50.0)
label.text = String.fontAwesome5Icon(code: "twitter")
UIBarButtonItem(无自定义类)
import SwiftIconFont
twitterBarButton.icon(from: .fontAwesome5, code: "twitter", ofSize: 20)
UITabBarItem(无自定义类)
import SwiftIconFont
twitterTabBarButton.icon(from: .fontAwesome5, code: "twitter", imageSize: CGSizeMake(20, 20), ofSize: 20)
UIImage
import SwiftIconFont
let githubLogo = UIImage(from: .octicon, code: "logo-github", textColor: .black, backgroundColor: .clear, size: CGSize(width: 150, height: 50))
UIImageView
import SwiftIconFont
let githubLogoImageView: UIImageView = UIImageView(frame: CGRect(x: 120, y: self.view.frame.size.height - 130, width: 150, height: 50))
githubLogoImageView.setIcon(from: .octicon, code: "logo-github", textColor: .black, backgroundColor: .clear, size: nil)
macOS
- NSTextField, NSImage, NSView
- 请检查 ExampleMac 项目
作者
Sedat ÇİFTÇİ - [email protected]
贡献者
许可
SwiftIconFont 可在 MIT 许可下使用。有关更多信息,请参阅 LICENSE 文件。
贡献指南
- 将其分叉 (http://github.com/0x73/SwiftIconFont/fork)
- 创建您的功能分支 (
git checkout -b my-new-feature
) - 提交您的更改 (
git commit -am 'Add some feature'
) - 将更改推送到分支 (
git push origin my-new-feature
) - 创建新的拉取请求