iOS 使用NSObject的分类实现快速切换主题
www527313
8年前
<h2>PYTheme</h2> <ul> <li>An easy way to change theme through NSObject's category for iOS.</li> <li>通过NSObject的分类实现使用简单的主题更换。</li> </ul> <h2>Features</h2> <ul> <li>轻量级</li> <li>低耦合</li> <li>自动管理内存</li> <li>支持动态更换主题颜色</li> <li>支持动态更换主题图片</li> <li>支持CocoaPods</li> </ul> <h2>Requirements</h2> <ul> <li>iOS 7.0 or later</li> <li>Xcode 7.0 or later</li> </ul> <h2>Architecture</h2> <ul> <li>NSObject+PYThemeExtension</li> </ul> <h2>Renderings</h2> <p style="text-align:center"><img src="https://simg.open-open.com/show/287b8f891455353c9590f90b2810d5e2.gif"></p> <h2>Usage</h2> <ul> <li>使用CocoaPods: <ul> <li>pod "PYTheme"</li> <li>导入主头文件 #import <NSObject+PYThemeExtension.h></li> </ul> </li> <li>手动导入: <ul> <li>将 PYTheme 文件夹中的所有文件拽入项目中</li> <li>导入主头文件 #import "NSObject+PYThemeExtension.h"</li> </ul> </li> </ul> <h2>具体使用</h2> <h3>设置主题色</h3> <p>1. 添加控件的属性/方法到主题色池中</p> <ul> <li>直接通过属性</li> </ul> <pre> <code class="language-objectivec">// 按钮的背景色添加到主题色池中 [button py_addToThemeColorPool:@"backgroundColor"];</code></pre> <ul> <li>通过设置方法并且传入方法对应参数数组,参数中直接含有颜色参数</li> </ul> <pre> <code class="language-objectivec">// 设置按钮选中时字体颜色添加到主题色池中 [button py_addToThemeColorPoolWithSelector:@selector(setTitleColor:forState:) objects:@[PYTHEME_THEME_COLOR, @(UIControlStateSelected)]];</code></pre> <ul> <li>当方法参数中没有直接包含颜色参数,而是经过包装(如使用NSDictionary包装)</li> </ul> <pre> <code class="language-objectivec">// 设置tabBar选中时字体颜色添加到主题色池中 NSMutableDictionary *attrSel = [NSMutableDictionary dictionary]; attrSel[NSForegroundColorAttributeName] = PYTHEME_THEME_COLOR; [childController.tabBarItem py_addToThemeColorPoolWithSelector:@selector(setTitleTextAttributes:forState:) objects:@[attrSel, @(UIControlStateSelected)]];</code></pre> <p>2. 设置主题色</p> <pre> <code class="language-objectivec">// 设置主题色为红色 [self py_setThemeColor:[UIColor redColor]];</code></pre> <h3>设置主题图片与配色</h3> <p>1. 添加相关控件对象到主题图片池中</p> <pre> <code class="language-objectivec">// 添加tabBarItem到主题图片池中 [tabBarItem py_addToThemeImagePool];</code></pre> <p>2. 根据需求设置控件的相关属性</p> <pre> <code class="language-objectivec">// 重新加载主题图片,并设置主题色为红色 [self py_reloadThemeImageWithThemeColor:[UIColor redColor] setting:^(const NSArray<id> *objects) { // 根据控件类型完成相关设置 }</code></pre> <h3>使用注意</h3> <ul> <li>对象不能是 UIAppearance ,否则将无法添加到主题池中 如下:将导致navigationBar无法添加到主题色池中</li> </ul> <pre> <code class="language-objectivec">// 获取全局navBar UINavigationBar *navBar = [UINavigationBar appearance]; // 添加背景色到主题色池中 [navBar py_addToThemeColorPool:@"barTintColor"];</code></pre> <ul> <li> <p>使用 py_addToThemeColorPoolWithSelector:objects: 设置参数数组时注意:</p> <ul> <li>方法参数必须按顺序一一对应,如果涉及到的主题色设置使用 PYTHEME_THEME_COLOR 宏定义代替</li> <li>如果数组中某个参数为nil,需包装为 [NSNull null] 对象再添加到数组中</li> </ul> </li> <li> <p>如果要使图片随着主题色变化而渲染成主题颜色,需要设置 RenderingMode 为:UIImageRenderingModeAlwaysTemplate</p> </li> </ul> <h2>期待</h2> <ul> <li>如果您在使用过程中有任何问题,欢迎issue me! 很乐意为您解答任何相关问题!</li> <li>与其给我点star,不如向我狠狠地抛来一个BUG!</li> <li>如果想要参与这个项目的维护或者有好的功能,欢迎pull request!</li> <li>如果您想要更多的接口来自定义或者建议/意见,欢迎issue me!我会根据大家的需求提供更多的接口!</li> <li>如果您在使用中觉得略有不适,欢迎联系我QQ:499491531,希望一起完善此项目,让它变成更强大,能够满足大多数用户的需求!</li> </ul> <p> </p> <p> </p> <p> </p>