/UIImageView-Letters

UIImageView category for using initials as a placeholder image

Primary LanguageObjective-CMIT LicenseMIT

UIImageView+Letters

An easy, helpful UIImageView category that generates letter initials as a placeholder for user profile images, with a randomized background color

Example screenshot

Installation

CocoaPods

Add this spec to your podfile:

pod "UIImageView-Letters"

Check out the official guide for getting started with CocoaPods.

Manual
  1. Drag the UIImageView+Letters.{h,m} files into your project
  2. 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

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.

Example
NSString *userName = @"Michael Bluth";
UIImageView *myImgView = [[UIImageView alloc] initWithFrame:CGRectMake(10, 10, 50, 50)];
[myImgView setImageWithString:userName];

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.