UIImageView+Letters
An easy, helpful UIImageView category that generates letter initials as a placeholder for user profile images, with a randomized background color
Installation
CocoaPods
Add this spec to your podfile:
pod "UIImageView-Letters"
Check out the official guide for getting started with CocoaPods.
Manual
- Drag the
UIImageView+Letters.{h,m}
files into your project - Enjoy!
Usage
In the file where you want to use the category, be sure to import the file.
#import "UIImageView+Letters.h"
Methods
Call the following methods on any UIImageView
instance to set the image:
- (void)setImageWithString:(NSString *)string
- (void)setImageWithString:(NSString *)string color:(UIColor *)color
- (void)setImageWithString:(NSString *)string color:(UIColor *)color circular:(BOOL)isCircular
string
is the string used to generate the initials. This should be a user's full name if available.
color
is an optional parameter that sets the background color of the image. Pass in nil
to have a color automatically generated for you.
isCircular
is a boolean parameter that will automatically clip the image to a circle if enabled.
Example
NSString *userName = @"Michael Bluth";
UIImageView *myImgView = [[UIImageView alloc] initWithFrame:CGRectMake(10, 10, 50, 50)];
[myImgView setImageWithString:userName color:nil circular:YES];
Saying Thanks
If you like this tool, show your support by downloading the free Reach Contact List app that inspired it!
License
Using the MIT license. See license file for details.