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

[](http://cocoapods.org/?q= LEETheme) [](http://cocoapods.org/?q= LEETheme)

演示

特性

两种设置模式,可根据对象单独添加设置,可通过JSON配置统一设置,也可混合使用,满足不同风格的开发者。
轻量级设计,整个框架只有2个文件构成。
支持所有NSObject子类对象,包含所有常用视图对象的颜色和图片等属性的快捷设置方法。
支持自定义类型对象的自定义属性设置。
支持动态添加主题,可实现网络主题切换功能。
语法优雅,高效简洁,一行代码完成对象设置。
当前主题记忆功能,下一次启动自动布置。
异步切换主题样式，避免主线程阻塞。
完善的文档注释和使用教程。

用法

独立设置模式

主要适用于固定主题样式的情况下使用

优点:直观清晰 , 编码时可随初始化控件编写完成 , 不影响编码思路.

缺点:位于代码中 , 修改可能会不方便些

// 添加背景颜色
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中 , 方便统一管理 , 可动态增加新主题JSON配置.

缺点:手写JSON会耗些时间

JSON标准格式

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

这里一般分为3种类型

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

添加JSON配置

//添加json , 设置所属主题标签 , 设置资源路径 
[LEETheme addThemeConfigJson:json WithTag:@"red" WithResourcesPath:nil];

对象设置

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

// 设置图片
imageView.lee_theme.LeeConfigImage(@"identifier4");

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

启用主题

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

//启用主题
[LEETheme startTheme:@"主题标签"];

建议在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions中添加默认主题的设置 , 指定第一次启动APP时默认启用的主题.

//设置默认主题
[LEETheme defaultTheme:@"主题标签"];

设置改变主题的动画时长

设置一个默认的主题改变时动画时长如果不设置默认为0秒

//设置默认改变主题的动画时长 (建议和默认主题 一起设置)
[LEETheme defaultChangeThemeAnimationDuration:0.1f];

如果单独为某个对象设置了动画时长那么该对象在更改主题样式时会以单独设置的为准 , 例如:

// 设置背景颜色 并设置动画时长
imageView.lee_theme.LeeConfigBackgroundColor(@"identifier2")
.LeeChangeThemeAnimationDuration(1.0f);

原理展示图

注意事项

独立设置模式与JSON设置模式可以同时使用.
当一个对象同时使用了2种设置模式那么同主题设置JSON模式优先级高于独立模式.
JSON中的标识符(identifier)要确保在当前JSON中是唯一的.
每个主题对应的JSON中标识符(identifier)要相同.
不要忘记设置默认主题 , 否则会导致第一次启动无效果.

安装

CocoaPods

将 cocoapods 更新至最新版本.
在 Podfile 中添加 pod 'LEETheme'。
执行 pod install 或 pod update。
导入 <LEETheme/LEETheme.h>。

手动安装

下载 LEETheme 文件夹内的所有内容。
将 LEETheme 内的源文件添加(拖放)到你的工程。
导入 LEETheme.h。

系统要求

该库最低支持 iOS 7.0 和 Xcode 7.0。

许可证

LEETheme 使用 GPL V3 许可证，详情见 LICENSE 文件。

友情链接

高效的自动布局库 - SDAutoLayout

一行代码搞定Alert - LEEAlert

一行代码搞定ActionSheet - LEEActionSheet

个人主页

我的简书

wangxiaolin1025/LEETheme