You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

112 lines
3.4 KiB

# CDDGroupAvatar
[![CocoaPods](https://img.shields.io/cocoapods/v/CDDGroupAvatar.svg)](https://cocoapods.org/pods/CDDGroupAvatar) [![CocoaPods](https://img.shields.io/cocoapods/p/CDDGroupAvatar.svg)](https://github.com/indulgeIn/CDDGroupAvatar) 
#### 这框架的初衷是想使群头像的实现尽可能的能像`SDWebImage`加载一张图片那么简单
#### Swift版本:
[Swift版本传送门](https://github.com/RocketsChen/CDDGroupAvatarSwift)
#### 博客地址:
[iOS 群头像框架 — CDDGroupAvatar](https://www.jianshu.com/p/f1acb0c0fb97)
![GIF](https://github.com/RocketsChen/CDDGroupAvatar/blob/master/CDDGroupAvatar.gif)
#### 安装:
* CocoaPods
1:在 Podfile 中添加 pod '`CDDGroupAvatar`',执行 pod install 或 pod update。
* 如果只需要无缓存版本:pod '`CDDGroupAvatar/NoCache`,更多详情可以查看podspec文件
* 手动导入
1:将demo项目中的 `CDDGroupAvatar` 文件夹所有内容拖入你的工程中。
2:集成 SDWebImage 框架。
* 用法
1:导入`#import <CDDGroupAvatar/DCAvatar.h>`可以拥有全部功能。
2:调用对应控件的类方法。
3:如果有使用上的疑问,可以下载演示demo进行查看。
#### 代码:
```
#import <CDDGroupAvatar/DCAvatar.h>
...
// UIImageView
[self.avImageViewW8 dc_setImageAvatarWithGroupId:@"avImageViewW8" Source:_groupNum8];
// UIButton
// Image
[self.avaButton dc_setImageAvatarWithGroupId:@"avaButton" Source:_groupNum9 forState:0];
// Background
[self.avaBgButton dc_setBackgroundImageAvatarWithGroupId:@"avaBgButton" Source:_groupNum4 forState:0];
```
## 版本更新
| version | note |
| :----: | :----: |
| 1.1.0 | Start ~ 🤔|
| 1.2.0 | Add Methods;Fix Bug。|
| 1.3.0 | 支持ImageView和Button,初步完成框架。[博客](https://www.jianshu.com/p/f1acb0c0fb97)|
| 1.4.0 | Add:同步获取所有小头像方法;|
| 1.5.2 | Add:新增无缓存版本,type - NoCache,去除SDWebImage依赖。[博客](https://www.jianshu.com/p/e89dbb49c0ba)|
| 1.5.3 | Remove:SDWebImage默认版本。|
| 1.5.4 | Add:QQ_Type:Image切圈。|
| 1.5.6 | Add:自定义缓存cache |
#### 1.4.0:
```
/**
批量加载群内部小头像(同步-M)
@param groupSource 群头像数据源数组
@param placeholder 占位图 例:@[@"p1",@"p2"] 或者 @[image1,image2] 权重大于 placeholderImage属性
*/
+ (NSArray *)dc_synfetchLoadImageSource:(NSArray *)groupSource itemPlaceholder:(id)placeholder;
/**
批量加载群内部小头像(异步-M)
@param groupSource 群头像数据源数组
@param placeholder 占位图 例:@[@"p1",@"p2"] 或者 @[image1,image2] 权重大于 placeholderImage属性
*/
+ (void)dc_asynfetchLoadImageSource:(NSArray *)groupSource itemPlaceholder:(id)placeholder completedBlock:(AsynFetchImageBlock)completedBlock;
```
#### 1.5.2:
##### 提供NoCache版本,脱离SDWebImage依赖,用户可自行决定加载方式和缓存
```
[self.ncImageViewW4 dc_setNoCacheImageAvatarWithGroupId:@"avImageViewW4" Source:@[[UIImage imageNamed:@"noCache1"],[UIImage imageNamed:@"noCache2"],[UIImage imageNamed:@"noCache3"],[UIImage imageNamed:@"noCache4"]]];
```
#### 关于版本:
目前`iOS`和`Swift`版本均已开源,后续会继续优化完善~
欢迎 Star✨
#### Agreement
* ` CDDGroupAvatar` licensed under the MIT license is used. Refer to [LICENSE](https://opensource.org/licenses/MIT) for more information.