• 通过 NSObject 的分类实现一个简单且易于使用的方法来更换 iOS 主题。
• 通过 NSObject 的分类实现使用简单的主题更换。

特性

• [x] 轻量级
• [x] 低耦合
• [x] 自动管理内存
• [x] 支持动态更换主题颜色
• [x] 支持动态更换主题图片
• [x] 支持 CocoaPods

要求

• iOS 7.0 或更高版本
• Xcode 7.0 或更高版本

架构

• NSObject+PYThemeExtension

渲染

使用

• 使用 CocoaPods
  • pod "PYTheme"
  • 导入主头文件 #import
• 手动导入：
  • 将 PYTheme 文件夹中的所有文件拖入项目中
  • 导入主头文件 #import "NSObject+PYThemeExtension.h"

具体使用

设置主题色

1. 将控件的属性/方法添加到主题色池中

• 直接通过属性

// 按钮的背景色添加到主题色池中
[button py_addToThemeColorPool:@"backgroundColor"];

• 通过设置方法并传入方法对应的参数数组，参数中直接含有颜色参数

// 设置按钮选中时字体颜色添加到主题色池中
[button py_addToThemeColorPoolWithSelector:@selector(setTitleColor:forState:) objects:@[PYTHEME_THEME_COLOR, @(UIControlStateSelected)]]; 

• 当方法参数中没有直接包含颜色参数，而是经过包装（如使用 NSDictionary 包装）

// 设置tabBar选中时字体颜色添加到主题色池中
NSMutableDictionary *attrSel = [NSMutableDictionary dictionary];
    attrSel[NSForegroundColorAttributeName] = PYTHEME_THEME_COLOR;
    [childController.tabBarItem py_addToThemeColorPoolWithSelector:@selector(setTitleTextAttributes:forState:) objects:@[attrSel, @(UIControlStateSelected)]];

2. 设置主题色

// 设置主题色为红色
[self py_setThemeColor:[UIColor redColor]];

设置主题图片与配色

1. 将相关控件对象添加到主题图片池中

// 添加tabBarItem到主题图片池中
[tabBarItem py_addToThemeImagePool];

2. 根据需求设置控件的相关属性

// 重新加载主题图片，并设置主题色为红色
[self py_reloadThemeImageWithThemeColor:[UIColor redColor] setting:^(const NSArray<id> *objects) {
     // 根据控件类型完成相关设置
}

使用注意事项

• 对象不能是 UIAppearance，否则将无法添加到主题池中，如下：将导致 navigationBar 无法添加到主题色池中

// 获取全局navBar
UINavigationBar *navBar = [UINavigationBar appearance];
// 添加背景色到主题色池中        
[navBar py_addToThemeColorPool:@"barTintColor"];

• 在使用 py_addToThemeColorPoolWithSelector:objects: 设置参数数组时请注意：

  • 方法参数必须按顺序一一对应，如果涉及到的主题色设置使用 PYTHEME_THEME_COLOR 宏定义代替
  • 如果数组中某个参数为 nil，需要将其包装为 [NSNull null] 对象再添加到数组中

• 如果需要使图片随着主题色变化而渲染成主题颜色，需要设置 RenderingMode 为：UIImageRenderingModeAlwaysTemplate

期待

• 如果您在使用过程中有任何问题，欢迎 issue me! 很高兴为您解答任何相关问题!
• 与其给我点star，不如向我狠狠地抛来一个BUG！
• 如果想要参与这个项目的维护或者有好的功能，欢迎pull request！
• 如果您想要更多的接口来自定义或者建议/意见，欢迎issue me！我会根据大家的需求提供更多的接口！
• 如果您在使用中觉得略有不适，欢迎联系我QQ:499491531，希望一起完善此项目，让它变得更强大道能满足大多数用户的需求！

许可证

所有源代码均在MIT许可证下授权。