Splitflap 是一个简单易用的组件,用于展示可变的字母数字文本,常用于机场或火车站的公共交通时刻表或在某些翻牌时钟中。
要求 • 使用方法 • 安装方式 • 贡献 • 联系方式 • 许可协议
要求
- iOS 8.0+ / tvOS 9.0+
- Xcode 9.0+
- Swift 4.2+
用法
Hello World
第一个例子是使用 Splitflap
组件的最简单方式。以下是显示此 “Hello” 文本的方法:
import Splitflap
let splitflapView = Splitflap(frame: CGRect(x: 0, y: 0, width: 370, height: 53))
splitflapView.datasource = self
// Set the text to display by animating the flaps
splitflapView.setText("Hello", animated: true)
// MARK: - Splitflap DataSource Methods
// Defines the number of flaps that will be used to display the text
func numberOfFlapsInSplitflap(_ splitflap: Splitflap) -> Int {
return 5
}
主题化
Splitflap
允许您通过提供 splitflap:builderForFlapAtIndex:
代理方法来个性化每个翻页。
let splitflapView = Splitflap(frame: CGRect(x: 0, y: 0, width: 370, height: 53))
splitflapView.delegate = self
splitflapView.datasource = self
// Set the text with an emoji
splitflap.text = "Cat \u{1F63B}"
// MARK: - Splitflap Delegate Methods
// Configure the appearance for each flaps
func splitflap(_ splitflap: Splitflap, builderForFlapAtIndex index: Int) -> FlapViewBuilder {
return FlapViewBuilder { builder in
builder.backgroundColor = UIColor(red: 251/255, green: 249/255, blue: 243/255, alpha: 1)
builder.cornerRadius = 5
builder.font = UIFont(name: "Avenir-Black", size:45)
builder.textAlignment = .center
builder.textColor = UIColor(red: 0, green: 0, blue: 0, alpha: 0.5)
builder.lineColor = UIColor(red: 0, green: 0, blue: 0, alpha: 0.3)
}
}
// MARK: - Splitflap DataSource Methods
func tokensInSplitflap(_ splitflap: Splitflap) -> [String] {
return " Cat\u{1F63B}".characters.map { String($0) }
}
还有更多...
要了解更多,请查看文档和示例项目。
注意:所有贡献都受欢迎
安装
CocoaPods
如果尚未安装,请安装 CocoaPods
$ [sudo] gem install cocoapods
$ pod setup
转到您的 Xcode 项目的目录,创建并编辑您的 Podfile,并添加 Splitflap
$ cd /path/to/MyProject
$ touch Podfile
$ edit Podfile
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
pod 'Splitflap', '~> 4.1.0'
将 Splitflap 安装到项目中
$ pod install
从 .xcworkspace 文件(而不是常规的项目文件)打开您的项目
$ open MyProject.xcworkspace
您现在可以在文件中导入 Splitflap 框架。
Carthage
Carthage 是一个去中心化的依赖关系管理器,它自动化了将框架添加到您的 Cocoa 应用程序的过程。
您可以使用以下命令通过 Homebrew 安装 Carthage
$ brew update
$ brew install carthage
要使用 Carthage 将 Splitflap
集成到您的 Xcode 项目中,请在您的 Cartfile
文件中指定它
github "yannickl/Splitflap" >= 4.1.0
Swift Package Manager
您可以使用 Swift Package Manager 在您的 Package.swift
文件中添加适当的描述来安装 Splitflap
import PackageDescription
let package = Package(
name: "YOUR_PROJECT_NAME",
targets: [],
dependencies: [
.Package(url: "https://github.com/yannickl/Splitflap.git", versions: "4.1.0" ..< Version.max)
]
)
请注意,Swift Package Manager 尚处于早期设计和开发阶段,更多信息和 GitHub 页面请查看 GitHub Page。
手动
下载 项目,并将 Splitflap
文件夹复制到您的项目中以使用。
贡献
欢迎并鼓励贡献力量 ♡。
联系
Yannick Loriot
许可协议 (MIT)
版权所有(c)2015-present - Yannick Loriot
以下是在遵守以下条件的情况下,免费准许任何由本软件及其关联文档文件(“软件”)的人士复制使用该软件,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售复制件的权限,以及允许向获取该软件的人士提供使用权限:
上述版权声明和本许可声明应包括在软件的全部或实质性部分的复制件中。
本软件按照“现状”提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途和版权侵犯保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,不论是根据合同、侵权或其他方式产生的,均与软件或软件的使用或其他交易有关。