lixiang1994 / Leetheme
Licence: mit
优雅的主题管理库- 一行代码完成多样式切换
Stars: ✭ 762
Projects that are alternatives of or similar to Leetheme
Thememanager
ThemeManager is a lightweight library for application to switching themes. support more attributes and theme extensions. more easy and convenient to use.
Stars: ✭ 165 (-78.35%)
Mutual labels: json, cocoapods, night-mode
Nightnight
Elegant way to integrate night mode to swift projects
Stars: ✭ 771 (+1.18%)
Mutual labels: cocoapods, night-mode, color
Tocropviewcontroller
A view controller for iOS that allows users to crop portions of UIImage objects
Stars: ✭ 4,210 (+452.49%)
Mutual labels: image, cocoapods
Hokusai
A Swift library to provide a bouncy action sheet
Stars: ✭ 431 (-43.44%)
Mutual labels: demo, cocoapods
Agrume
🍋 A lemony fresh iOS image viewer written in Swift.
Stars: ✭ 449 (-41.08%)
Mutual labels: image, cocoapods
Picassopalette
Android Lollipop Palette is now easy to use with Picasso !
Stars: ✭ 366 (-51.97%)
Mutual labels: image, color
Jsonconverter
JSONConverter is a desktop application for Mac OS X which enables you to covert JSON objects preview pretty rich JOSN and model classes
Stars: ✭ 402 (-47.24%)
Mutual labels: json, model
Swiftyjson
The better way to deal with JSON data in Swift.
Stars: ✭ 21,042 (+2661.42%)
Mutual labels: json, cocoapods
Vulcan
Multi image downloader with priority in Swift
Stars: ✭ 291 (-61.81%)
Mutual labels: image, cocoapods
Coolie
Coolie(苦力) helps you to create models (& their constructors) from a JSON file.
Stars: ✭ 508 (-33.33%)
Mutual labels: json, model
Swiftai
SwiftAI, write Swift code smart. SwiftAI can generate Model class from JSON now. Codable and HandyJSON is supported. More features will be add.
Stars: ✭ 470 (-38.32%)
Mutual labels: json, model
Sdwebimage
Asynchronous image downloader with cache support as a UIImageView category
Stars: ✭ 23,928 (+3040.16%)
Mutual labels: image, cocoapods
Theme Ui
Build consistent, themeable React apps based on constraint-based design principles
Stars: ✭ 4,150 (+444.62%)
Mutual labels: style, color
Dknightversion
Manage Colors, Integrate Night/Multiple Themes. (Unmaintained)
Stars: ✭ 3,559 (+367.06%)
Mutual labels: cocoapods, night-mode
Simpleimageviewer
A snappy image viewer with zoom and interactive dismissal transition.
Stars: ✭ 408 (-46.46%)
Mutual labels: image, cocoapods
Maplebacon
🍁🥓 Lightweight and fast Swift library for image downloading, caching and transformations
Stars: ✭ 322 (-57.74%)
Mutual labels: image, cocoapods
Chromacolorpicker
🎨 An intuitive iOS color picker built in Swift.
Stars: ✭ 434 (-43.04%)
Mutual labels: cocoapods, color
Sakurakit
🤡SakuraKit, a lightweight and powerful library for application to switching themes or skins.
Stars: ✭ 682 (-10.5%)
Mutual labels: image, color
Poisson blend
Seamless copy-and-paste of images with Poisson Blending.
Stars: ✭ 277 (-63.65%)
Mutual labels: demo, image
Serpent
A protocol to serialize Swift structs and classes for encoding and decoding.
Stars: ✭ 281 (-63.12%)
Mutual labels: json, cocoapods
LEETheme - 最好用的轻量级主题管理框架
演示
特性
- 链式语法 结构优雅
- 两种设置模式,可根据对象单独添加某一主题中某一属性或方法的设置,可使用标识符模式为某一属性或方法设置标识符,二者可混合使用,满足不同需求的开发者。
- 轻量级设计, 简化文件架构, 全部集合为两个文件中。
- 支持对所有NSObject子类对象进行设置, 并提供了常用视图对象的颜色和图片等属性的快捷设置方法。
- 支持自定义类型对象的自定义属性或方法设置。
- 支持动态添加主题,可实现类似网络主题下载并切换的功能。
- 语法优雅, 高效简洁, OC链式, 一行代码完成对象设置。
- 当前主题记忆功能, 下一次启动自动布置。
- 完善的文档注释和使用教程, 并有众多Demo可供参考。
用法
默认模式
主要适用于固定主题样式的情况下使用
优点:直观 清晰, 编码时可随初始化控件编写完成, 不影响编码思路.
缺点:每个主题的设置固定, 不支持新主题的设置.
// 添加背景颜色
imageView.lee_theme
.LeeAddBackgroundColor(@"red" , [UIColor redColor])
.LeeAddBackgroundColor(@"blue" , [UIColor blueColor]);
// 添加图片
imageView.lee_theme
.LeeAddImage(@"red" , [UIImage imageNamed:@"red.png"])
.LeeAddImage(@"blue" , [UIImage imageNamed:@"blue.png"]);
// 添加自定义设置 (每个主题标签对应一个block , 当触发其中添加的主题后会执行相应的block)
imageView.lee_theme
.LeeAddCustomConfig(@"red" , ^(UIImageView *item){
item.hidden = YES; //简单举例 红色主题启动时 将这个imageview对象隐藏
})
.LeeAddCustomConfig(@"blue" , ^(UIImageView *item){
item.hidden = NO; //或者随便做一些其他羞羞的事
});
LEETheme支持对任何NSObject子类的对象进行其持有属性或方法的设置 , 例如UIImageView类的对象持有image属性 , 那么使用LEETheme就可以为它设置不同主题对应的image属性值, 以此类推 , 当然所有类型的对象都可以添加自定义Block设置.
标识符模式
适用于固定和动态主题样式的情况下使用
优点:对于对象的设置只需要给定标识符即可, 代码较默认模式更加简洁, 可动态增加新主题JSON配置.
JSON标准格式
{
"color": {
"identifier1(唯一标识符)": "十六进制颜色值",
"identifier2": "#000000"
},
"image": {
"identifier3(唯一标识符)": "图片名称",
"identifier4": "lee.png"
},
"other": {
"identifier5(唯一标识符)": "其他值",
"identifier6": "12345"
}
}
这里一般分为3种类型
- 颜色类型 (color) - 适用于颜色属性
- 图片类型 (image) - 适用于图片属性
- 其他类型 (other) - 适用于自定义Block
添加新主题的JSON配置
/**
* 添加json , 设置所属主题标签 , 设置资源路径 所添加过的Json配置会自动存储 无需每次都添加
* 关于资源路径的设置 只需要传入documents目录后的路径即可 如:@"theme_resources/black"
*/
[LEETheme addThemeConfigWithJson:json Tag:@"red" ResourcesPath:nil];
移除某一主题的JSON配置
// 所要移除的主题标签
[LEETheme removeThemeConfigWithTag:@"red"];
对象设置
// 设置背景颜色
imageView.lee_theme.LeeConfigBackgroundColor(@"identifier2");
// 设置图片
imageView.lee_theme.LeeConfigImage(@"identifier4");
// 自定义设置 (如果没有对应的标识符 则不会触发该block执行 , 如果有 则执行)
imageView.lee_theme.LeeCustomConfig(@"identifier6" , ^(id item , id value){
//item 为当前对象
//value 为当前主题的JSON配置中 other 类型下 "identifier6"对应的值
item.alpha = [value floatValue]; //举个例子 设置一下透明度
});
启用主题
启用主题后 , LEETheme会自动保存当前所启用的主题 , APP下一次开启会自动启用上一次的主题.
// 启用主题
[LEETheme startTheme:@"主题标签"];
建议在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
中添加默认主题的设置 , 指定第一次启动APP时默认启用的主题.
// 设置默认主题
[LEETheme defaultTheme:@"主题标签"];
关于添加过渡动画效果
这里提供一个小技巧 可以让过渡更加自然 可根据自身情况调整使用. 切换主题前 获取当前window的快照视图 并覆盖到window上 > 执行主题切换 > 将覆盖的快照视图通过动画隐藏 显示出切换完成的真实window.
// 覆盖截图
UIView *tempView = [weakSelf.window snapshotViewAfterScreenUpdates:NO];
[weakSelf.window addSubview:tempView];
// 切换主题
[LEETheme startTheme:@"tag"];
// 增加动画 移除覆盖
[UIView animateWithDuration:1.0f animations:^{
tempView.alpha = 0.0f;
} completion:^(BOOL finished) {
[tempView removeFromSuperview];
}];
注意事项
- 默认模式与标识符模式可以同时使用.
- 当一个对象同时使用了2种设置模式 那么同主题情况下会优先使用后设置的.
- JSON中的标识符(identifier)要确保在当前JSON中是唯一的.
- 每个主题对应的JSON中 标识符(identifier)要相同.
- 不要忘记设置默认主题, 应用中应该最少会有一个默认的主题.
更多示例Demo
安装
CocoaPods
- 将 cocoapods 更新至最新版本.
- 在 Podfile 中添加
pod 'LEETheme'
。 - 执行
pod install
或pod update
。 - 导入
<LEETheme/LEETheme.h>
。
手动安装
- 下载 LEETheme 文件夹内的所有内容。
- 将 LEETheme 内的源文件添加(拖放)到你的工程。
- 导入
LEETheme.h
。
系统要求
该库最低支持 iOS 7.0
和 Xcode 9.0
。
版本更新
详情请查看更新日志
许可证
LEETheme 使用 MIT 许可证,详情见 LICENSE 文件。
友情链接
个人主页
Note that the project description data, including the texts, logos, images, and/or trademarks,
for each open source project belongs to its rightful owner.
If you wish to add or remove any projects, please contact us at [email protected].