Swiftpack.co - bachonk/InitialsImageView as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by bachonk.
bachonk/InitialsImageView 0.8.0
A simple UIImageView extension for using initials as a profile image, written in swift
⭐️ 212
🕓 1 week ago
iOS
.package(url: "https://github.com/bachonk/InitialsImageView.git", from: "0.8.0")

InitialsImageView

An easy, helpful UIImageView extension 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 "InitialsImageView"

Check out the official guide for getting started with CocoaPods.

Swift Package Manager

You can use the Swift Package Manager to install InitialsImageView by adding it to the dependencies value of your Package.swift:

dependencies: [
    .package(url: "https://github.com/bachonk/InitialsImageView.git", .upToNextMajor(from: "0.0.0"))
]
Manual
  1. Drag the InitialsImageView.swift file into your project
  2. Enjoy!

Usage

Methods

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

  • setImageForName(string: String, backgroundColor: UIColor?, circular: Bool, textAttributes: [String: AnyObject]?)

string is the string used to generate the initials. This should be a user's full name if available.

backgroundColor 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 an optional dictionary of predefined character attributes for text. You can find the list of available keys in NSAttributedString

Example
let randomImage: UIImageView = UIImageView.init(frame: CGRect(x: self.view.bounds.midX - 40, y: self.view.bounds.midY - 80 - 40, width: 80, height: 80))
randomImage.setImageForName(string: "Michael Bluth", backgroundColor: nil, circular: true, textAttributes: nil)

Saying Thanks

If you like this tool, show your support by downloading the free Turnout app that inspired it!

License

Using the MIT license. See license file for details.

GitHub

link
Stars: 212
Last commit: 1 week ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

InitialsImageView: 0.7.0
2 years ago

Fixes:

  • Safely unwrap optionals to avoid crashes

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics