简介

使用MethodSwizzling实现零侵入修改全局主题，无需修改项目旧代码，可随时添加、移除，可快速实现“暗黑模式(黑暗模式、深色模式、换肤)”，兼容xib与纯代码创建的view，兼容所有控件(含第三方控件)

Github地址：https://github.com/SmileZXLee/ZXThemeopen in new window

ZXTheme

open in new window open in new window open in new window open in new window

安装

通过CocoaPods安装

pod 'ZXTheme'

手动导入

将ZXTheme拖入项目中。

导入头文件

#import "ZXTheme.h"

零侵入实现黑暗模式示例

代码参照Appdelegate.m文件

Image text

说明

ZXTheme用于修改全局UI的主题，设置方法与注意点说明以UILabel为例：

示例代码

[ZXTheme defaultTheme].zx_labelThemeBlock = ^ZXLabelTheme * _Nonnull(UILabel * _Nonnull label) {
    ZXLabelTheme *labelTheme = [[ZXLabelTheme alloc]init];
    labelTheme.textColor = [UIColor blueColor];
    labelTheme.textAlignment = NSTextAlignmentCenter;
    return labelTheme;
};

说明：我们需要修改全局label的主题，则书写[ZXTheme defaultTheme].zx_labelThemeBlock
这个block中有一个label对象，代表当前需要设置主题的label
这个block需要一个返回值，在设置label主题的block中，这个返回值是ZXLabelTheme对象，创建这个对象，并更改其中的属性即可更改对应的label主题
下方示例代码实现将所有文字内容为“测试”的label文字颜色设置为绿色，其他label的文字颜色不变

[ZXTheme defaultTheme].zx_labelThemeBlock = ^ZXLabelTheme * _Nonnull(UILabel * _Nonnull label) {
    ZXLabelTheme *labelTheme = [[ZXLabelTheme alloc]init];
    if([label.text isEqualToString:@"测试"]){
        labelTheme.textColor = [UIColor greenColor];
    }
    return labelTheme;
};

下方示例代码实现将所有文字内容为“测试”的label文字颜色设置为绿色，其他label的文字颜色不变，所有label背景色变为红色

[ZXTheme defaultTheme].zx_labelThemeBlock = ^ZXLabelTheme * _Nonnull(UILabel * _Nonnull label) {
    ZXLabelTheme *labelTheme = [[ZXLabelTheme alloc]init];
    if([label.text isEqualToString:@"测试"]){
        labelTheme.textColor = [UIColor greenColor];
    }
    labelTheme.backgroundColor = [UIColor redColor];
    return labelTheme;
};

下方示例代码实现将所有文字内容为“测试”的label文字颜色设置为绿色并且背景色变为红色，其他label主题不变

[ZXTheme defaultTheme].zx_labelThemeBlock = ^ZXLabelTheme * _Nonnull(UILabel * _Nonnull label) {
    ZXLabelTheme *labelTheme = [[ZXLabelTheme alloc]init];
    if([label.text isEqualToString:@"测试"]){
        labelTheme.textColor = [UIColor greenColor];
        labelTheme.backgroundColor = [UIColor redColor];
        return labelTheme;
    }else{
        return nil;
    }
};

由上方三段示例代码可以得出以下规律：
1.themeblock返回值为nil，则代表当前label对象不设置主题
2.ZXLabelTheme对象中属性没有设置，则代表当前label对象中对应属性不设置主题
3.ZXLabelTheme对象中属性有值，则当前label对象中对应属性用ZXLabelTheme对象的对应属性值，例如labelTheme.textColor有值，则label的textColor为labelTheme.textColor，否则label的textColor为label本身的textColor
注意：ZXTheme中设置的主题拥有最高的管理权限，也就意味着，若您在ZXTheme中设置了对应UI控件的主题，则您在其他地方都无法更改对应UI控件的主题

以上是相关注意点和使用技巧说明，设置其他UI控件主题同理，因此下方不再赘述

所有UI控件主题设置

通用工具函数

UIView(Extension)

/**
 获取view所属的控制器

 @return view所属的控制器
 */
- (UIViewController*)zx_getViewController;

/**
 判断当前view是否是目标view类的子类(包含子类递归)

 @param cls 目标view的类
 @return 当前view是否是目标view类的子类(包含子类递归)
 */
- (BOOL)zx_inViewClass:(Class)cls;
/**
 是否是控制器的self.view

 @return 是否是控制器的self.view
 */
- (BOOL)zx_isControllerView;

UILabel(Extension)

/**
 是否属于UIButton
 */
@property(assign, nonatomic,readonly) BOOL zx_belongsToBtn;

/**
 是否属于UITextField中的placeholder
 */
@property(assign, nonatomic,readonly) BOOL zx_belongsToTextFieldPlaceholder;

UIImage(Extension)

/**
 将UIImage渲染为指定颜色

 @param color 渲染颜色
 @return 渲染之后的UIImage
 */
- (UIImage*)renderColor:(UIColor *)color;

ZXTheme支持设置全局主题的View

ZXTheme

UIView

设置view主题

[ZXTheme defaultTheme].zx_viewThemeBlock = ^ZXViewTheme * _Nonnull(UIView * _Nonnull view) {
    ZXViewTheme *viewTheme = [[ZXViewTheme alloc]init];
    if([view.nextResponder isKindOfClass:[UIViewController class]]){
        viewTheme.backgroundColor = [self getControllerBacViewColor];
    }
    return viewTheme;
};

ZXViewTheme所有属性

属性	描述
backgroundColor	设置view背景颜色

UILabel

设置label主题

[ZXTheme defaultTheme].zx_labelThemeBlock = ^ZXLabelTheme * _Nonnull(UILabel * _Nonnull label) {
    ZXLabelTheme *labelTheme = [[ZXLabelTheme alloc]init];
    labelTheme.textColor = [UIColor redColor];
    labelTheme.font = [UIFont systemFontOfSize:14];
    labelTheme.textAlignment = NSTextAlignmentCenter;
    labelTheme.lineBreakMode = NSLineBreakByCharWrapping;
    labelTheme.backgroundColor = [UIColor redColor];
    return labelTheme;
};

ZXLabelTheme所有属性

属性	描述
textColor	设置文字颜色
font	设置文字字体
textAlignment	设置文字对齐方式
lineBreakMode	设置文字换行模式
highlighted	设置文字是否高亮
highlightedTextColor	设置文字高亮时候的颜色
adjustsFontSizeToFitWidth	设置文字是否根据宽度自动调整字体
numberOfLines	设置文字最大行数
backgroundColor	设置文字背景颜色

UIButton

设置button主题

[ZXTheme defaultTheme].zx_buttonThemeBlock = ^ZXButtonTheme * _Nonnull(UIButton * _Nonnull button) {
    ZXButtonTheme *buttonTheme = [[ZXButtonTheme alloc]init];
    [buttonTheme setTitleColor:[UIColor yellowColor] forState:UIControlStateNormal];
    [buttonTheme setBackgroundImage:[UIImage imageNamed:@"kanjia"] forState:UIControlStateNormal];
    buttonTheme.backgroundColor = [UIColor yellowColor];
    return buttonTheme;
};

ZXButtonTheme所有属性/方法

属性/方法	描述
tintColor	设置按钮tintColor
setTitleColor:forState:	根据状态设置按钮文字颜色
setTitleShadowColor:forState:	根据状态设置按钮文字阴影颜色
setImage:forState	根据状态设置按钮图片
setBackgroundImageColor::forState	根据状态设置按钮背景图片
backgroundColor	设置按钮背景颜色

UISegmentedControl

设置segmentedControl主题

[ZXTheme defaultTheme].zx_segmentedControlThemeBlock = ^ZXSegmentedControlTheme * _Nonnull(UISegmentedControl * _Nonnull segmentedControl) {
    ZXSegmentedControlTheme *segmentedControlTheme = [[ZXSegmentedControlTheme alloc]init];
    segmentedControlTheme.tintColor = [UIColor redColor];
    return segmentedControlTheme;
};

ZXSegmentedControlTheme所有属性

属性	描述
tintColor	设置SegmentedControl的tintColor
backgroundColor	设置SegmentedControl的背景颜色

UITextField

设置textField主题

[ZXTheme defaultTheme].zx_textFieldThemeBlock = ^ZXTextFieldTheme * _Nonnull(UITextField * _Nonnull textField) {
    ZXTextFieldTheme *textFieldTheme = [[ZXTextFieldTheme alloc]init];
    textFieldTheme.tintColor = [UIColor redColor];
    textFieldTheme.textColor = [UIColor blueColor];
    textFieldTheme.placeholderColor = [UIColor redColor];
    return textFieldTheme;
};

ZXTextFieldTheme所有属性

属性	描述
textColor	设置TextField颜色
font	设置TextField字体
textAlignment	设置TextField对齐方式
tintColor	设置TextField的tintColor
placeholderColor	设置TextField的placeholder颜色
backgroundColor	设置TextField的背景颜色

UISlider

设置slider主题

[ZXTheme defaultTheme].zx_sliderThemeBlock = ^ZXSliderTheme * _Nonnull(UISlider * _Nonnull slider) {
    ZXSliderTheme *sliderTheme = [[ZXSliderTheme alloc]init];
    sliderTheme.minimumTrackTintColor = [UIColor redColor];
    sliderTheme.maximumTrackTintColor = [UIColor blueColor];
    sliderTheme.thumbTintColor = [UIColor yellowColor];
    return sliderTheme;
};

ZXSliderTheme所有属性

属性	描述
minimumTrackTintColor	设置Slider左侧背景颜色
maximumTrackTintColor	设置Slider右侧背景颜色
thumbTintColor	设置Slider滑块颜色
minimumValueImage	设置Slider左侧图片
maximumValueImage	设置Slider右侧图片
backgroundColor	设置Slider背景颜色

UISwitch

设置switch主题

[ZXTheme defaultTheme].zx_switchThemeBlock = ^ZXSwitchTheme * _Nonnull(UISwitch * _Nonnull mySwitch) {
    ZXSwitchTheme *switchTheme = [[ZXSwitchTheme alloc]init];
    switchTheme.onTintColor = [UIColor redColor];
    switchTheme.tintColor = [UIColor redColor];
    return switchTheme;
};

ZXSwitchTheme所有属性

属性	描述
tintColor	设置Switch的tintColor
onTintColor	设置Switch的onTintColor
backgroundColor	设置Switch背景颜色

UIActivityIndicatorView

设置activityIndicatorView主题

[ZXTheme defaultTheme].zx_activityIndicatorViewThemeBlock = ^ZXActivityIndicatorViewTheme * _Nonnull(UIActivityIndicatorView * _Nonnull activityIndicatorView) {
    ZXActivityIndicatorViewTheme *activityIndicatorViewTheme = [[ZXActivityIndicatorViewTheme alloc]init];
    activityIndicatorViewTheme.activityIndicatorViewStyle = UIActivityIndicatorViewStyleWhiteLarge;
    return activityIndicatorViewTheme;
};

ZXActivityIndicatorViewTheme所有属性

属性	描述
activityIndicatorViewStyle	设置ActivityIndicatorView样式
backgroundColor	设置Switch背景颜色

UIProgressView

设置progressView主题

[ZXTheme defaultTheme].zx_progressViewThemeBlock = ^ZXProgressViewTheme * _Nonnull(UIProgressView * _Nonnull progressView) {
    ZXProgressViewTheme *progressViewTheme = [[ZXProgressViewTheme alloc]init];
    progressViewTheme.progressTintColor = [UIColor redColor];
    progressViewTheme.trackTintColor = [UIColor blueColor];
    return progressViewTheme;
};

ZXProgressViewTheme所有属性

属性	描述
progressTintColor	设置ProgressView已加载的进度条颜色
trackTintColor	设置ProgressView未加载的进度条颜色
progressImage	设置ProgressView已加载的进度条图片
trackImage	设置ProgressView未加载的进度条图片

UIPageControl

设置pageControl主题

[ZXTheme defaultTheme].zx_pageControlThemeBlock = ^ZXPageControlTheme * _Nonnull(UIPageControl * _Nonnull pageControl) {
    ZXPageControlTheme *pageControlTheme = [[ZXPageControlTheme alloc]init];
    pageControlTheme.pageIndicatorTintColor = [UIColor redColor];
    pageControlTheme.currentPageIndicatorTintColor = [UIColor blueColor];
    return pageControlTheme;
};

ZXPageControlTheme所有属性

属性	描述
pageIndicatorTintColor	设置PageControl其他页的颜色
currentPageIndicatorTintColor	设置PageControl当前页的颜色

UIStepper

设置stepper主题

[ZXTheme defaultTheme].zx_stepperThemeBlock = ^ZXStepperTheme * _Nonnull(UIStepper * _Nonnull stepper) {
    ZXStepperTheme *stepperTheme = [[ZXStepperTheme alloc]init];
    stepperTheme.tintColor = [UIColor whiteColor];
    return stepperTheme;
};

ZXStepperTheme所有属性

属性	描述
tintColor	设置Stepper的tintColor
backgroundColor	设置Stepper背景颜色

UIImageView

设置imageView主题

[ZXTheme defaultTheme].zx_imageViewThemeBlock = ^ZXImageViewTheme * _Nonnull(UIImageView * _Nonnull imageView) {
    if(imageView.frame.size.width == 50){
        ZXImageViewTheme *imageViewTheme = [[ZXImageViewTheme alloc]init];
        imageViewTheme.imageColor = [UIColor redColor];
        imageViewTheme.backgroundColor = [UIColor yellowColor];
        return imageViewTheme;
    }else{
        return nil;
    }
};

ZXImageViewTheme所有属性

属性	描述
image	设置ImageView的image
imageColor	设置ImageView的image颜色
highlightedImage	设置ImageView的highlightedImage
highlightedImageColor	设置ImageView的highlightedImage颜色
animationImages	设置ImageView的动画image数组
animationImagesColor	设置ImageView的image数组的颜色
highlightedAnimationImages	设置ImageView的动画highlightedImage数组
highlightedAnimationImagesColor	设置ImageView的highlightedAnimationImages数组的颜色
tintColor	设置ImageView的tintColor
backgroundColor	设置ImageView背景颜色

UITextView

设置textView主题

[ZXTheme defaultTheme].zx_textViewThemeBlock = ^ZXTextViewTheme * _Nonnull(UITextView * _Nonnull textView) {
    ZXTextViewTheme *textViewTheme = [[ZXTextViewTheme alloc]init];
    textViewTheme.textColor = [UIColor redColor];
    textViewTheme.backgroundColor = [UIColor blueColor];
    return textViewTheme;
};

ZXTextViewTheme所有属性

属性	描述
textColor	设置TextView的文字颜色
font	设置TextView的文字字体
textAlignment	设置TextView的文字对齐方式
backgroundColor	设置TextView的背景颜色

UITabBar

设置tabBar主题

[ZXTheme defaultTheme].zx_tabBarThemeBlock  = ^ZXTabBarTheme * _Nonnull(UITabBar * _Nonnull tabBar) {
    ZXTabBarTheme *tabBarTheme = [[ZXTabBarTheme alloc]init];
    tabBarTheme.translucent = NO;
    tabBarTheme.barTintColor = [self getTabbarTintColor];
    return tabBarTheme;
};

ZXTabBarTheme所有属性

属性	描述
tintColor	设置Tabbar的tintColor
translucent	设置Tabbar是否透明
barTintColor	设置Tabbar的背景色
backgroundImage	设置Tabbar的背景图片
selectionIndicatorImage	设置Tabbar的selectionIndicatorImage
shadowImage	设置Tabbar的shadowImage

UITabBarItem

设置tabBarItem主题

[ZXTheme defaultTheme].zx_tabBarItemThemeBlock = ^ZXTabBarItemTheme * _Nonnull(UITabBarItem * _Nonnull tabBarItem) {
    ZXTabBarItemTheme *tabBarItemTheme = [[ZXTabBarItemTheme alloc]init];
    tabBarItemTheme.selectedImageColor = [UIColor redColor];
    [tabBarItemTheme setTitleTextAttributes:[NSDictionary dictionaryWithObjectsAndKeys:[UIFont systemFontOfSize:11],NSFontAttributeName, [UIColor redColor],NSForegroundColorAttributeName, nil] forState:UIControlStateSelected];
    return tabBarItemTheme;
};

ZXTabBarItemTheme所有属性

属性/方法	描述
image	设置TabBarItem的image
imageColor	设置TabBarItem的image颜色
selectedImage	设置TabBarItem的selectedImage
selectedImageColor	设置TabBarItem的selectedImage颜色
setTitleTextAttributes:forState:	根据状态设置TabBarItem文字属性

UINavigationBar

设置navigationBar主题

[ZXTheme defaultTheme].zx_navigationBarThemeBlock = ^ZXNavigationBarTheme * _Nonnull(UINavigationBar * _Nonnull navigationBar) {
    ZXNavigationBarTheme *navigationBarTheme = [[ZXNavigationBarTheme alloc]init];
    navigationBarTheme.translucent = NO;
    navigationBarTheme.barTintColor = UIColorFromRGB(0x1c1c1c);
    navigationBarTheme.titleTextAttributes = @{NSForegroundColorAttributeName:[UIColor redColor],NSFontAttributeName:[UIFont boldSystemFontOfSize:20]};
    return navigationBarTheme;
};

ZXNavigationBarTheme所有属性

属性	描述
tintColor	设置NavigationBar的tintColor
translucent	设置NavigationBar是否透明
barTintColor	设置NavigationBar的barTintColor
shadowImage	设置NavigationBar的shadowImage
titleTextAttributes	设置NavigationBar的titleTextAttributes

UIBarButtonItem

设置barButtonItem主题

[ZXTheme defaultTheme].zx_barButtonItemThemeBlock = ^ZXBarButtonItemTheme * _Nonnull(UIBarButtonItem * _Nonnull barButtonItem){
    ZXBarButtonItemTheme *barButtonItemTheme = [[ZXBarButtonItemTheme alloc]init];
    barButtonItemTheme.tintColor = [UIColor redColor];
    return barButtonItemTheme;
};

ZXBarButtonItemTheme所有属性

属性	描述
style	设置BarButtonItem的style
tintColor	设置BarButtonItem的tintColor
customView	设置BarButtonItem的customView

UITableView

设置tableView主题

[ZXTheme defaultTheme].zx_tableViewThemeBlock = ^ZXTableViewTheme * _Nonnull(UITableView * _Nonnull tableView) {
    ZXTableViewTheme *tableViewTheme = [[ZXTableViewTheme alloc]init];
    tableViewTheme.separatorStyle = UITableViewCellSeparatorStyleNone;
    tableViewTheme.backgroundColor = [self getTableViewBacColor];
    tableViewTheme.viewForHeaderInSection = ^UIView * _Nonnull(UIView * _Nonnull headerView, NSUInteger section) {
        headerView.backgroundColor = [self getTableViewHeaderViewBacColor];
        for (UIView *view in headerView.subviews) {
            if([view isKindOfClass:[UILabel class]]){
                ((UILabel *)view).textColor = [self getTableViewHeaderViewLabelTextColor];
            }
            
        }
        return headerView;
    };
    tableViewTheme.cellForRowAtIndexPath = ^UITableViewCell * _Nonnull(UITableViewCell * _Nonnull cell, NSIndexPath * _Nonnull indexPath) {
        cell.backgroundColor = [self getTableViewCellBacColor];
        for (UIView *view in cell.contentView.subviews) {
            if([view isKindOfClass:[UILabel class]]){
                ((UILabel *)view).textColor = [self getTableViewCellLabelTextColor];
            }
            if([view isKindOfClass:[UIImageView class]]){
                ((UIImageView *)view).image = [((UIImageView *)view).image renderColor:[self getTableViewCellImageViewRenderColor]];
            }
        }
        return cell;
    };
    return tableViewTheme;
};

ZXTableViewTheme所有属性

属性	描述
backgroundColor	设置TableView的backgroundColor
backgroundView	设置TableView的backgroundView
sectionIndexColor	设置TableView的sectionIndexColor
sectionIndexBackgroundColor	设置TableView的sectionIndexBackgroundColor
sectionIndexTrackingBackgroundColor	设置TableView的sectionIndexTrackingBackgroundColor
separatorStyle	设置TableView的separatorStyle
separatorColor	设置TableView的separatorColor
separatorEffect	设置TableView的separatorEffect
tableHeaderView	设置TableView的tableHeaderView
tableFooterView	设置TableView的tableFooterView
cellForRowAtIndexPath	设置TableView的cell
viewForHeaderInSection	设置TableView的headerView
viewForFooterInSection	设置TableView的footerView

UICollectionView

设置collectionView主题

[ZXTheme defaultTheme].zx_collectionViewThemeBlock = ^ZXCollectionViewTheme * _Nonnull(UICollectionView * _Nonnull collectionView) {
    ZXCollectionViewTheme *collectionViewTheme = [[ZXCollectionViewTheme alloc]init];
    collectionViewTheme.backgroundColor = [self getCollectionViewBacColor];
    collectionViewTheme.cellForItemAtIndexPath = ^UICollectionViewCell * _Nonnull(UICollectionViewCell * _Nonnull cell, NSIndexPath * _Nonnull indexPath) {
        cell.backgroundColor = [self getCollectionViewCellBacColor];
        for (UIView *view in cell.contentView.subviews) {
            if([view isKindOfClass:[UILabel class]]){
                ((UILabel *)view).textColor = [self getCollectionViewCellLabelTextColor];
            }
        }
        return cell;
    };
    collectionViewTheme.viewForSupplementaryElement = ^UICollectionReusableView * _Nonnull(UICollectionReusableView * _Nonnull reusableView, NSString * _Nonnull kind, NSIndexPath * _Nonnull indexPath) {
        reusableView.backgroundColor = [self getCollectionViewHeaderViewBacColor];
        for (UIView *view in reusableView.subviews) {
            if([view isKindOfClass:[UILabel class]]){
                ((UILabel *)view).textColor = [self getCollectionViewHeaderViewLabelTextColor];
            }
            
        }
        return reusableView;
    };
    return collectionViewTheme;
};

ZXCollectionViewTheme所有属性

属性	描述
backgroundColor	设置CollectionView的backgroundColor
backgroundView	设置CollectionView的backgroundView
cellForItemAtIndexPath	设置CollectionView的cell
viewForSupplementaryElement	设置CollectionView的headerView和footerView

自定义其他View或属性的主题

例如需要添加UIAlertController的主题设置
创建UIAlertController的分类
在.m文件中实现

#import "UIAlertController+ZXCustomTheme.h"
#import "ZXTheme.h"
@implementation UIAlertController (ZXCustomTheme)
+ (void)load{
    [self zx_handleThemeWithTargetSelector:@selector(addAction:) handleSelector:@selector(zx_addAction:)];
}
- (void)zx_addAction:(UIAlertAction *)action{
    [action setValue:[UIColor redColor] forKey:@"titleTextColor"];
    [self zx_addAction:action];
}
@end

以上代码实现将UIAlertController的actions文字颜色变为红色的效果

# ZXTheme

# 安装

# 通过CocoaPods安装

# 手动导入

# 导入头文件

# 零侵入实现黑暗模式示例

# 说明

# 所有UI控件主题设置

# 通用工具函数

# ZXTheme支持设置全局主题的View

# UIView

# UILabel

# UIButton

# UISegmentedControl

# UITextField

# UISlider

# UISwitch

# UIActivityIndicatorView

# UIProgressView

# UIPageControl

# UIStepper

# UIImageView

# UITextView

# UITabBar

# UITabBarItem

# UINavigationBar

# UIBarButtonItem

# UITableView

# UICollectionView

# 自定义其他View或属性的主题

ZXTheme

安装

通过CocoaPods安装

手动导入

导入头文件

零侵入实现黑暗模式示例

说明

所有UI控件主题设置

通用工具函数

ZXTheme支持设置全局主题的View

UIView

UILabel

UIButton

UISegmentedControl

UITextField

UISlider

UISwitch

UIActivityIndicatorView

UIProgressView

UIPageControl

UIStepper

UIImageView

UITextView

UITabBar

UITabBarItem

UINavigationBar

UIBarButtonItem

UITableView

UICollectionView

自定义其他View或属性的主题