LEETheme - 最好用的轻量级主题管理框架

Build Status

演示 ============== 新日间Demo演示新夜间Demo演示

新日间Demo演示新夜间Demo演示

特性 ==============

链式语法结构优雅
两种设置模式,可根据对象单独添加某一主题中某一属性或方法的设置,可使用标识符模式为某一属性或方法设置标识符,二者可混合使用,满足不同需求的开发者。
轻量级设计, 简化文件架构, 全部集合为两个文件中。
支持对所有NSObject子类对象进行设置, 并提供了常用视图对象的颜色和图片等属性的快捷设置方法。
支持自定义类型对象的自定义属性或方法设置。
支持动态添加主题,可实现类似网络主题下载并切换的功能。
语法优雅, 高效简洁, OC链式, 一行代码完成对象设置。
当前主题记忆功能, 下一次启动自动布置。
完善的文档注释和使用教程, 并有众多Demo可供参考。

用法 ==============

默认模式

主要适用于固定主题样式的情况下使用优点:直观清晰, 编码时可随初始化控件编写完成, 不影响编码思路. 缺点:每个主题的设置固定, 不支持新主题的设置.

// 添加背景颜色 imageView.lee_theme .LeeAddBackgroundColor(@"red" , [UIColor redColor]) .LeeAddBackgroundColor(@"blue" , [UIColor blueColor]); // 添加图片 imageView.lee_theme .LeeAddImage(@"red" , [UIImage imageNamed:@"red.png"]) .LeeAddImage(@"blue" , [UIImage imageNamed:@"blue.png"]); // 添加自定义设置 (每个主题标签对应一个block , 当触发其中添加的主题后会执行相应的block) imageView.lee_theme .LeeAddCustomConfig(@"red" , ^(UIImageView *item){ item.hidden = YES; //简单举例红色主题启动时将这个imageview对象隐藏 }) .LeeAddCustomConfig(@"blue" , ^(UIImageView *item){ item.hidden = NO; //或者随便做一些其他羞羞的事 });

LEETheme支持对任何NSObject子类的对象进行其持有属性或方法的设置 , 例如UIImageView类的对象持有image属性 , 那么使用LEETheme就可以为它设置不同主题对应的image属性值, 以此类推 , 当然所有类型的对象都可以添加自定义Block设置.

标识符模式

适用于固定和动态主题样式的情况下使用优点:对于对象的设置只需要给定标识符即可, 代码较默认模式更加简洁, 可动态增加新主题JSON配置.

JSON标准格式

{ "color": { "identifier1(唯一标识符)": "十六进制颜色值", "identifier2": "#000000" }, "image": { "identifier3(唯一标识符)": "图片名称", "identifier4": "lee.png" }, "other": { "identifier5(唯一标识符)": "其他值", "identifier6": "12345" } }

这里一般分为3种类型

颜色类型 (color) - 适用于颜色属性
图片类型 (image) - 适用于图片属性
其他类型 (other) - 适用于自定义Block

添加新主题的JSON配置

/**
 * 添加json , 设置所属主题标签 , 设置资源路径  所添加过的Json配置会自动存储 无需每次都添加
 * 关于资源路径的设置 只需要传入documents目录后的路径即可 如:@"theme_resources/black"
 */
 [LEETheme addThemeConfigWithJson:json Tag:@"red" ResourcesPath:nil];

移除某一主题的JSON配置

// 所要移除的主题标签 [LEETheme removeThemeConfigWithTag:@"red"];

对象设置

// 设置背景颜色 imageView.lee_theme.LeeConfigBackgroundColor(@"identifier2"); // 设置图片 imageView.lee_theme.LeeConfigImage(@"identifier4");

// 自定义设置 (如果没有对应的标识符则不会触发该block执行 , 如果有则执行) imageView.lee_theme.LeeCustomConfig(@"identifier6" , ^(id item , id value){ //item 为当前对象 //value 为当前主题的JSON配置中 other 类型下 "identifier6"对应的值 item.alpha = [value floatValue]; //举个例子设置一下透明度 });

启用主题

启用主题后 , LEETheme会自动保存当前所启用的主题 , APP下一次开启会自动启用上一次的主题.

// 启用主题 [LEETheme startTheme:@"主题标签"]; 建议在- (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions中添加默认主题的设置 , 指定第一次启动APP时默认启用的主题. // 设置默认主题 [LEETheme defaultTheme:@"主题标签"];

关于添加过渡动画效果

这里提供一个小技巧可以让过渡更加自然可根据自身情况调整使用. 切换主题前获取当前window的快照视图并覆盖到window上 > 执行主题切换 > 将覆盖的快照视图通过动画隐藏显示出切换完成的真实window.

// 覆盖截图 UIView *tempView = [weakSelf.window snapshotViewAfterScreenUpdates:NO]; [weakSelf.window addSubview:tempView]; // 切换主题 [LEETheme startTheme:@"tag"]; // 增加动画移除覆盖 [UIView animateWithDuration:1.0f animations:^{ tempView.alpha = 0.0f; } completion:^(BOOL finished) { [tempView removeFromSuperview]; }];