Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bachonk/uiimageview-letters
UIImageView category for using initials as a placeholder image, written in Objective-C. For a Swift implementation, see https://github.com/bachonk/InitialsImageView
https://github.com/bachonk/uiimageview-letters
category cocoapods objective-c placeholder uiimageview uiimageview-category uiimageview-letters
Last synced: 7 days ago
JSON representation
UIImageView category for using initials as a placeholder image, written in Objective-C. For a Swift implementation, see https://github.com/bachonk/InitialsImageView
- Host: GitHub
- URL: https://github.com/bachonk/uiimageview-letters
- Owner: bachonk
- License: mit
- Created: 2014-06-17T22:21:50.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-09-11T00:54:45.000Z (over 6 years ago)
- Last Synced: 2025-01-08T14:26:43.590Z (14 days ago)
- Topics: category, cocoapods, objective-c, placeholder, uiimageview, uiimageview-category, uiimageview-letters
- Language: Objective-C
- Homepage:
- Size: 115 KB
- Stars: 685
- Watchers: 26
- Forks: 70
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
UIImageView+Letters
===================
An easy, helpful UIImageView category that generates letter initials as a placeholder for user profile images, with a randomized background color
*Note: Looking for a Swift 3 compatible version? Check out the new [InitialsImageView](https://github.com/bachonk/InitialsImageView) extension, rewritten entirely in Swift!*
### Installation
##### CocoaPods
Add this spec to your podfile:
`pod "UIImageView-Letters"`
Check out the [official guide](http://guides.cocoapods.org/using/index.html) 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`
+ `- (void)setImageWithString:(NSString *)string color:(UIColor *)color circular:(BOOL)isCircular`
+ `- (void)setImageWithString:(NSString *)string color:(UIColor *)color circular:(BOOL)isCircular fontName:(NSString *)fontName`
+ `- (void)setImageWithString:(NSString *)string color:(UIColor *)color circular:(BOOL)isCircular textAttributes:(NSDictionary *)textAttributes`
`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.
`fontName` is a string that specifies a custom font. Pass in `nil` to use the system font by default. The list of provided font identifiers can be found [here](http://iosfonts.com).
`textAttributes` is an NSDictionary that allows you to specify font, text color, shadow properties, etc., for the letters text, using the keys found in `NSAttributedString.h`.
##### 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 [Turnout](https://itunes.apple.com/us/app/turnout-make-plans-w-friends/id1393733205?mt=8) app that inspired it!
### License
Using the MIT license. See license file for details.