UIImageView-AGCInitials 0.0.2

UIImageView-AGCInitials 0.0.2

测试已测试
语言语言 _objcObjective C
许可证 MIT
发布最新发布2016年4月

Andrea Cipriani维护。




AGCInitials Example screenshot 1 AGCInitials Example screenshot 2

AGCInitials 是一个 Objective C 的 UIImageView 分类,用于使用联系人的首字母和一个自动生成的背景颜色来设置图片占位符。

功能

  • 使用一行代码即可使用它
  • 对于相同的首字母,imageView 生成的背景颜色将相同,因此您可以在您的表格/集合视图中使用它。😎
  • 您可以设置自己的背景颜色调色板
  • 良好的测试覆盖率💪

如何使用它 - 基本用法

导入分类

#import "UIImageView+AGCInitials.h"

然后用联系人的名字调用方法

[_anImageView agc_setImageWithInitialsFromName:@"Mick Jagger"];

图片将包含带有首字母 "MJ" 和生成的背景颜色的占位符。

Mick Jagger initials example

如何使用它 - 详细说明

  • 您可以直接设置首字母,而不指定名字,请注意在此情况下,图片的背景颜色将对于相同的首字母是相同的
- (void)agc_setImageWithInitials:(nonnull NSString*)initials;
  • 对于 @"Mick Jagger" 和 @"Michael Jackson",@"initialsFromName" 方法返回 MJ 作为首字母,但背景颜色将不同,因为它是由名字生成的。

Mick Jagger initials example Michael Jackson initials example

  • 默认情况下,首字母通过 @" " 区分,但您可以使用如下更改分隔符:
- (void)agc_setImageWithInitialsFromName:(nonnull NSString*)name separatedByString:(nonnull NSString*)separator;
  • 您可以通过指定文本属性来**自定义字体**
NSDictionary* initialsTextAttributes = @{ NSFontAttributeName : [UIFont systemFontOfSize:20], NSForegroundColorAttributeName : [UIColor purpleColor] };
[cellImageView agc_setImageWithInitialsFromName:@"Mick Jagger" separatedByString:@" " withTextAttributes:initialsTextAttributes];
  • 您还可以更改用于生成背景颜色的**调色板**
#import "AGCInitialsColors.h"

然后,在使用分类之前设置您的调色板

NSArray<UIColor*>* yourColorPalette; //...
[[AGCInitialsColors sharedInstance] setColorPalette:yourColorPalette];

要求

  • iOS 7+

运行示例

要运行示例项目,首先从仓库克隆,然后在示例目录中首先运行 pod install

您甚至可以在 Appetize 上在线试用示例(点击访问)

作者

Andrea Cipriani,[email protected] - Twitter @AndreaCipriani

许可证

UIImageView-AGCInitials 在 MIT 许可证下提供。有关更多信息,请参阅 LICENSE 文件。