https://github.com/devdragonli/lfldarkmodekit
暗黑模式 iOS Dark Mode Adapter Kit (Layer Color Auto Changed)
https://github.com/devdragonli/lfldarkmodekit
Last synced: 10 months ago
JSON representation
暗黑模式 iOS Dark Mode Adapter Kit (Layer Color Auto Changed)
- Host: GitHub
- URL: https://github.com/devdragonli/lfldarkmodekit
- Owner: DevDragonLi
- License: mit
- Created: 2020-05-05T09:10:36.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2021-08-23T07:49:34.000Z (almost 5 years ago)
- Last Synced: 2025-04-13T07:47:24.471Z (about 1 year ago)
- Language: Objective-C
- Homepage:
- Size: 3.03 MB
- Stars: 12
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LFLDarkModeKit
> Adapter iOS DarkMode
### 适配支持 **iOS 9.0+** 项目
### Support:ObjC/Swift项目(纯OC/Swift/混编)均可使用
- 对于iOS13+ 跟随系统暗黑开关
- 也支持自定义APP内开关，设置即可【参考下文说明】
- 对于iOS13以下，则默认Light模式
- 也可以指定自定义模式，设置即可【参考下文说明】
- 获取状态切换【模式切换检测】
[](https://travis-ci.org/DevdragonLi/LFLDarkModeKit)
[](https://cocoapods.org/pods/LFLDarkModeKit)
[](https://cocoapods.org/pods/LFLDarkModeKit)
[](https://cocoapods.org/pods/LFLDarkModeKit)
### **[LFLDarkModeKit Detail](#use)**
- CGColor并不会动态改变的解决方案
- 常规项目的暗黑场景处理
### **[Project Adapter By Apple API Description](#darkMode)**
## Example
To run the example project, clone the repo, and run `pod install` from the
Example directory first.
## Installation
LFLDarkModeKit is available through [CocoaPods](https://cocoapods.org). To install it, simply add the following line to your Podfile:
```ruby
pod 'LFLDarkModeKit', '~> 3.2.0'
```
- 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
> Dragonli_52171@163.com
## License
LFLDarkModeKit is available under the MIT license. See the LICENSE file for more info.