QMUI_Theme

使用步骤

首先,请先确认你希望以什么样的形式封装你的主题对象,以 QMUI Demo 为例,每个主题对应一个配置表,每个配置表均为一个 NSObject<QDThemeProtocol> * 类型。
然后,在尽量早的时机初始化 QMUIThemeManager,以保证其他使用颜色、图片的地方能获取到正确的值。
QMUI Demo 中选择的时机是:application:didFinishLaunchingWithOptions:。

  1. 先注册主题监听,在回调里将主题持久化存储(存到数据库或者 NSUserDefaults),避免启动过程中主题发生变化时读取到错误的值
[[NSNotificationCenter defaultCenter] 
addObserver:self 
selector:@selector(handleThemeDidChangeNotification:) 
name:QMUIThemeDidChangeNotification 
object:nil];
  1. 然后设置用于生成主题的 block,在需要的时候 QMUIThemeManager 会通过这个 block 得到一个主题对象
QMUIThemeManager.sharedInstance.themeGenerator = ^__kindof NSObject * _Nonnull(NSString * _Nonnull identifier) {    
if ([identifier isEqualToString:@"Default"]) return QMUIConfigurationTemplate.new;    
if ([identifier isEqualToString:@"Dark"]) return QMUIConfigurationTemplateDark.new;    
return nil;
};
  1. 再针对 iOS 13 开启自动响应系统的 Dark Mode 切换// 如果不需要兼容 iOS 13 Dark Mode,则不需要这一段代码
if (@available(iOS 13.0, *)) {    
// 先通过这个 block 来决定当系统的 Dark Mode 发生切换时,要如何映射到业务的主题    
QMUIThemeManager.sharedInstance.identifierForTrait = ^__kindof NSObject<NSCopying> * _Nonnull(UITraitCollection * _Nonnull trait) {        
if (trait.userInterfaceStyle == UIUserInterfaceStyleDark) {            
return @"Dark";// 表示当检测到系统开启了 Dark Mode 时,将主题自动切换到 Dark       
 }        
return @"Default";    
};    
// 然后让 QMUIThemeManager 自动响应系统的 Dark Mode 切换    
QMUIThemeManager.sharedInstance.respondsSystemStyleAutomatically = YES;
}

做完以上的初始化配置后,剩下的就是业务界面的适配了,按照上文提到的,将 color、image、effect 都换成对应的动态对象。

view.backgroundColor = [UIColor qmui_colorWithThemeProvider:^UIColor * _Nonnull(__kindof QMUIThemeManager * _Nonnull manager, NSString * _Nullable identifier, __kindof NSObject * _Nullable theme) {    return [identifier isEqualToString:@"Dark"] ? UIColor.blackColor : UIColor.whiteColor;}];

layer.backgroundColor = [UIColor qmui_colorWithThemeProvider:^UIColor * _Nonnull(__kindof QMUIThemeManager * _Nonnull manager, NSString * _Nullable identifier, __kindof NSObject * _Nullable theme) {    return [identifier isEqualToString:@"Dark"] ? UIColor.blackColor : UIColor.whiteColor;}].CGColor;

imageView.image = [UIImage qmui_imageWithThemeProvider:^UIImage * _Nonnull(__kindof QMUIThemeManager * _Nonnull manager, NSString * _Nullable identifier, NSObject<QDThemeProtocol> *theme) {    return [UIImage imageNamed:[identifier isEqualToString:@"Dark"] ? @"image_dark" : @"image_default"];}];

visualEffectView.effect = [UIVisualEffect qmui_effectWithThemeProvider:^UIVisualEffect * _Nonnull(__kindof QMUIThemeManager * _Nonnull manager, NSString * _Nullable identifier, NSObject<QDThemeProtocol> *theme) {    return [UIBlurEffect effectWithStyle:[identifier isEqualToString:@"Dark"] ? UIBlurEffectStyleDark : UIBlurEffectStyleLight];}];

通常来说,一个项目里的颜色、模糊效果一般都只有可枚举的固定的几个,建议将这些颜色、模糊效果缓存起来(使用 static 变量,或者用一个单例去保存,可参考 QDThemeManager),这样可以大大减少代码量,也不需要去记住创建动态对象的语法。

// 适当做一些抽取,就可以减少大量的代码
view.backgroundColor = UIColor.qd_backgroundColor;
layer.backgroundColor = UIColor.qd_separatorColor.CGColor;
visualEffectView.effect = UIVisualEffect.qd_standardBlurEffect;

到此大部分界面已经可以兼容,而对于自定义的 View 组件,它们的自定义属性需要在主题切换时被刷新,则可参照下方来注册属性给 QMUIThemeManager。

@implementation CustomView
- (instancetype)initWithFrame:(CGRect)frame {   
 if (self = [super initWithFrame:frame]) {        
// ...               
 // 将组件里的样式定义为 property,然后通过 qmui_registerThemeColorProperties: 注册给 QMUIThemeManager,这样当主题发生变化时,会遍历整个界面的所有 view,重新设置被注册的属性        
[self qmui_registerThemeColorProperties:@[NSStringFromSelector(@selector(borderColor)),                                                  
NSStringFromSelector(@selector(contentImage)),        
NSStringFromSelector(@selector(backgroundEffect))]];   
 }    
return self;
}
@end

如果上述提供的功能仍未能满足业务的需求,也可直接重写
UIView/UIViewController 的 qmui_themeDidChangeByManager:identifier:theme: 方法,在内部写自己的逻辑。
至此整个 App 的主题实现和 Dark Mode 兼容工作就全部完成了。
至于主题的切换,如果 App 只是兼容 iOS 13 Dark Mode,则不需要理会这一点,如果 App 里有提供主动切换主题的操作给用户,则可参照以下代码:

QMUIThemeManager.sharedInstance.currentThemeIdentifier = @"Dark";
// 切换到名为 Dark 的主题// 或
QMUIThemeManager.sharedInstance.currentTheme = darkTheme;
// 切换到 darkTheme 主题对象
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,117评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,963评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,897评论 0 240
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,805评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,208评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,535评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,797评论 2 311
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,493评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,215评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,477评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,988评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,325评论 2 252
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,971评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,055评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,807评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,544评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,455评论 2 266