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>