Latest 2.1.1
Homepage https://github.com/claudot/Swift-UIImageView-Letters
License MIT
Platforms ios 8.0, requires ARC
Authors

UIImageView + Letters

Inspired by https://github.com/bachonk/UIImageView-Letters

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

Screenshot
Screenshot

Installation

CocoaPods

Add this spec to your podfile:

  • use_frameworks!
  • pod 'Letters'

Check out the official guide for getting started with CocoaPods.

Manual
  1. Drag the UIImageView+Letters.swift files into your project
  2. Enjoy!

Usage

Methods

Call the following method on any UIImageView instance to set the image:

  • func setImage(string: String?, color: UIColor? = nil, circular: Bool = false, textAttributes: [NSAttributedStringKey: Any]? = nil)

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.

circular is a boolean parameter that will automatically clip the image to a circle if enabled.

textAttributes is n dictionary that allows you to specify font, text color, shadow properties, etc., for the letters text, using the keys found in NSAttributedStringKey.

If you want to keep the same color for a given name, you can use the following method from UIColor extension:
static func colorHash(name: String?) -> UIColor

You can get random color using the method static var random: UIColor.

Example
userImageView?.setImage(string: "John DOE", color: .random, circular: true, attributes: [NSAttributedStringKey.font: font.withSize(font.pointSize * 2), NSAttributedStringKey.foregroundColor: UIColor.softBlue])

License

Using the MIT license. See license file for details.

Latest podspec

{
    "name": "Letters",
    "version": "2.1.1",
    "summary": "Extension of UIImageView to set an image with a given name",
    "description": "Excellent placeholder for app user profil photo. This extension of UIImageView can allow you to have a placeholder in one line of code",
    "homepage": "https://github.com/claudot/Swift-UIImageView-Letters",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Paul-Anatole CLAUDOT": "[email protected]"
    },
    "source": {
        "git": "https://github.com/claudot/Swift-UIImageView-Letters.git",
        "tag": "2.1.1"
    },
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "source_files": "Classes/*",
    "pushed_with_swift_version": "4.0"
}

Pin It on Pinterest

Share This