LFLDarkModeKit 3.5.0

LFLDarkModeKit 3.5.0

Maintained by dragonLi.



  • By
  • DevDragonli

LFLDarkModeKit

Adapter iOS DarkMode

适配支持 iOS 9.0+ 项目

  • 对于iOS13+ 跟随系统暗黑开关

    • 也支持自定义APP内开关,设置即可【参考下文说明】
  • 对于iOS13以下,则默认Light模式

    • 也可以指定自定义模式,设置即可【参考下文说明】
  • 获取状态切换【模式切换检测】

CI Status Version License Platform

LFLDarkModeKit Detail

  • CGColor并不会动态改变的解决方案
  • 常规项目的暗黑场景处理

Project Adapter By Apple API Description

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

LFLDarkModeKit is available through CocoaPods. To install it, simply add the following line to your Podfile:

  pod 'LFLDarkModeKit', '~> 3.2.0'

LFLDarkModeKit Detail

  • Layout Class
.
├── Core
│   ├── LFLDarkModeManger.h
│   ├── LFLDarkModeManger.m
│   ├── UIColor+LFLDarkMode.h
│   ├── UIColor+LFLDarkMode.m
│   ├── UIView+LFLDarkMode.h
│   └── UIView+LFLDarkMode.m
├── LFLDarkModeKit.h
└── Tool
    ├── NSString+DarkModeKitBlank.h
    └── NSString+DarkModeKitBlank.m
    └── UIWindow+DarkModeKitKeyWondow.h
    └── UIWindow+DarkModeKitKeyWondow.m
  

Project create bundle source

各项目自定义色值字符串映射对应颜色

  • Example:@“PColor0” 在dark和light分别对应不同的真实色值一一映射,后续可支持新增模式

  • Example:darkModeAdapterColor.bundle (Color Set )

    • dark.plist
    • light.plist

configDarkModeColorBundleURL

 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
	 NSURL *darkModeBundleURL = [[NSBundle mainBundle] URLForResource:@"darkModeAdapterColor" withExtension:@"bundle"];
    [[LFLDarkModeManger sharedInstance] configDarkModeColorBundleURL:darkModeBundleURL];
    return YES;	
}

用户自定义模式 【可不跟随系统开关】

	  // 配置开启用户自定义开关模式
    [LFLDarkModeManger.sharedInstance configUserDarkMode:YES];

     // 获取当前用户自定义是否暗黑模式
    [LFLDarkModeManger.sharedInstance isUserDarkMode];

获取状态切换【模式切换检测】

  
  [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(_darkModeNoti:) name:LFLDarkModeChangeNotification object:nil];
    
- (void)_darkModeNoti:(NSNotification *)noti {
NSDictionary *darkModeDic = noti.object;
NSLog(@"\n通知:暗黑模式切换检测%@",darkModeDic);
}

Use Example

// view
self.exampleLabel.textColor = [UIColor ColorAdpterWithHex:@"DEMO"];
  
// Imageview 
self.adapterImageView.image = [UIImage imageAdapterNamed:@"exampleImage"];

// Layer 
self.customView.layerBorderColorHex = @"DEMO";
	    

Project Adapter By Apple API Description

全局关闭暗黑模式:在Info.plist文件中,添加UIUserInterfaceStyle key 名字为 User Interface Style 值为String,将UIUserInterfaceStyle key 的值设置为Light

images adapter

  • 如果项目中有需要适配暗黑模式的图片,可以在Assets.xcassets中设置,具体需要什么样式自己根据项目情况设置
    • any dark

UIColor

  • iOS13 API (当系统切换模式的时候,自动触发这两个方法来动态修改控件颜色)

+ (UIColor *)colorWithDynamicProvider:(UIColor * (^)(UITraitCollection *traitCollection))dynamicProvider API_AVAILABLE(ios(13.0), tvos(13.0)) API_UNAVAILABLE(watchOS);

- (UIColor *)initWithDynamicProvider:(UIColor * (^)(UITraitCollection *traitCollection))dynamicProvider API_AVAILABLE(ios(13.0), tvos(13.0)) API_UNAVAILABLE(watchos);

CGColor

设置的CGColor并不会动态改变,可以通过以下方案处理

如果适配CGColor,一般需要各自自定义view实现此函数再处理,较为麻烦


- (void)traitCollectionDidChange:(UITraitCollection *)previousTraitCollection {
[super traitCollectionDidChange:previousTraitCollection];
    
if ([self.traitCollection hasDifferentColorAppearanceComparedToTraitCollection:previousTraitCollection]) {
// Config  Color Adapter 
	}
}

  • performAsCurrent

- (void)traitCollectionDidChange:(UITraitCollection *)previousTraitCollection {
[super traitCollectionDidChange:previousTraitCollection];
 [self.traitCollection performAsCurrentTraitCollection:^{
    layer.backgroundColor = xxColor.CGColor;
}];
}
	

VC Config Single Style

if (@available(iOS 13.0, *)) {
    
    [self setOverrideUserInterfaceStyle:UIUserInterfaceStyleDark];
    
} else {
    
}

xib / Story

  • color set
    • any dark
    • [UIColor colorNamed:@"customBlueColor"]

NSAttributedString

 NSDictionary * attributeDic = @{NSFontAttributeName:[UIFont systemFontOfSize:16],NSForegroundColorAttributeName:[UIColor xxColor]};
	

UIActivityIndicatorView

typedef NS_ENUM(NSInteger, UIActivityIndicatorViewStyle) {
	
    UIActivityIndicatorViewStyleMedium,
	
    UIActivityIndicatorViewStyleLarge,
	
    UIActivityIndicatorViewStyleWhiteLarge API_DEPRECATED_WITH_REPLACEMENT("UIActivityIndicatorViewStyleLarge",
	
    UIActivityIndicatorViewStyleWhite API_DEPRECATED_WITH_REPLACEMENT("UIActivityIndicatorViewStyleMedium",
	
    UIActivityIndicatorViewStyleGray API_DEPRECATED_WITH_REPLACEMENT("UIActivityIndicatorViewStyleMedium",
	
};
	

Life Style

  • UIView

    • traitCollectionDidChange(_:)
    • layoutSubviews()
    • draw(_:)
    • updateConstraints()
    • tintColorDidChange()
  • UIViewController

    • traitCollectionDidChange(_:)
    • updateViewConstraints()
    • viewWillLayoutSubviews()
    • viewDidLayoutSubviews()
  • UIPresentationController

    • traitCollectionDidChange(_:)
    • containerViewWillLayoutSubviews()
    • containerViewDidLayoutSubviews()

Author

[email protected]

License

LFLDarkModeKit is available under the MIT license. See the LICENSE file for more info.