Need help with PYTheme?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
ko1o

Description

An easy way to change theme through NSObject's category for iOS.

422 Stars 93 Forks MIT License 16 Commits 6 Opened issues

Services available

Need anything else?

PYTheme

Build Status Pod Version Pod Platform Pod License

  • An easy way to change theme through NSObject's category for iOS.
  • 通过NSObject的分类实现使用简单的主题更换。

Features

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

Requirements

  • iOS 7.0 or later
  • Xcode 7.0 or later

Architecture

  • NSObject+PYThemeExtension

Renderings

Usage

  • 使用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 *objects) {
     // 根据控件类型完成相关设置
}

使用注意

  • 对象不能是
    UIAppearance
    ,否则将无法添加到主题池中 如下:将导致navigationBar无法添加到主题色池中
// 获取全局navBar
UINavigationBar *navBar = [UINavigationBar appearance];
// 添加背景色到主题色池中        
[navBar py_addToThemeColorPool:@"barTintColor"];

  • 使用

    py_addToThemeColorPoolWithSelector:objects:
    设置参数数组时注意:
    • 方法参数必须按顺序一一对应,如果涉及到的主题色设置使用 PYTHEMETHEMECOLOR 宏定义代替
    • 如果数组中某个参数为nil,需包装为 [NSNull null] 对象再添加到数组中
  • 如果要使图片随着主题色变化而渲染成主题颜色,需要设置

    RenderingMode
    为:UIImageRenderingModeAlwaysTemplate

期待

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

Licenses

All source code is licensed under the MIT License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.