项目来由

工作项目中,产品需要给 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()

关于如何使用更多更详细的说明,请参见

Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐