项目来由
工作项目中,产品需要给 APP 加上主题切换,也就是通常黑夜白天切换功能。本着不重复制造轮子的想法,第一件事就是 google 看有没有开源的实现,结果查看一圈悲哀的发现,确实有这样的项目,只是扩展性,易用性都显得比较单薄,无法满足项目的需求,好不尴尬。于是准备自己造轮子,经过不断的修改和完善,把该功能单独的提起出来,使得更为通用。最终 **ChameleonSwift **诞生了。欢迎使用,指正,提出您意见。
大概过了下需求,主题切换涉及各种颜色,文字大小,图片等等,总得来说主题的切换的核心都是围绕着 view 来完成的,具体的也就是 UIView,UIViewController 来完成的。只是给 UIView 或者其子类添加几个属性显然是无法满足需求的,考虑到情况的复杂性和扩展性,显然使用方法是一个更好的方法。继承一个通用的 class 是一个不错的方法。不过Swift 的 extension(oc 的 category) 给了我们一个更好的选择。
优点:
- 简单。其他库在使用的时候,不同的View添加不同的属性,类型太多使用起来不容易
- 易于扩展。本库并没有单独的属性用于处理不同主题/皮肤下的表现,而是采用闭包的方式来实现,具有更大的灵活行和自主性
- 高度解耦:本扩展一个简单的配置,你可以专注与业务逻辑,而不需要考虑皮肤/主题支持使得你的代码变得丑陋不堪
balabala,这些都是我自卖自夸哈~
原理:
就如前面提到的主题切换的核心在于视觉,具体而言也就是 UIView。所以本文的出发点就是扩展 UIView 来实现。 app 控制显示的主要是 UIView 和 UIViewController,通过遍历的调用 app 的 UIView, UIViewController 就可以实现相关功能
使用:
假设
假设你使用默认的 ThemeStyle(枚举类型,由Day, Night), 下面代码中使用 ThemeStyle 作为你使用的主题类型; 当然在实际使用中, 可以完成你自己定义的主题类型,可以是枚举,数字,类,可以是任意类型
1,只需要实现给你想切换主题的 UIView/UIViewController 实现 ch_switchTheme(_:pre:)方法或者设置回调ch_switchThemeBlock ,在回调中想做你做的事情,修改文字颜色,背景图片,字体等等。这样你的 app 已经支持 主题切换功能
let label = UILabel()
label.ch_switchThemeBlock = { (now:Any, pre:Any?) -> Void in
// 你修改主题的代码
if let now = ThemeSwitchHelper<你定义的主题类型>.parseTheme(now) { // 获取 真正的主题
label.text = "\(now)"
...
}
}
或者
override func ch_switchTheme(now: Any, pre: Any?) {
// 你修改主题的代码
if let now = ThemeSwitchHelper<你定义的主题类型>.parseTheme(now) { // 获取 真正的主题
label.text = "\(now)"
...
}
}
2,配置你的初始数据: 在程序启动的时候配置(默认是nil)
ThemeServiceConfig.instance.initThemeData(data: ThemeStyle.Day)
3,最后,你只需要调用
UIApplication.ch_switchTheme(ThemeStyle.Night)
就可以完成了
有用的帮助函数
ThemeSwitchHelper定义了一些有用的函数
- 获取当前的主题: ThemeSwitchHelper<你定义的主题类型>.current
- 解析参数获取当前主题: ThemeSwitchHelper<你定义的主题类型>.parseTheme()
- 当前主题的图片: ThemeSwitchHelper<你定义的主题类型>.image()
- 当前主题的颜色: ThemeSwitchHelper<你定义的主题类型>.color()
- 当前主题的配置(如果图片,颜色不满足你的需求,你可以使用这个): ThemeSwitchHelper<你定义的主题类型>.currentData()
关于如何使用更多更详细的说明,请参见 ChameleonSwift