LinkLabel

UILabel with custom hyperlink styling, optional interaction delegate, minimal setup

What’s up

Creating a UILabel with attributed text, links appear blue and underlined, and in most cases you don’t want them to be. It’s pretty awkward and a time-kill to try and make them simply be styled the way you desire.

LinkLabel makes this all easy. Without any extra code, links appear the same colour as the rest of your text, but underlined. It’s what the default should be.

If you want to add custom styling, that’s super simple, too. Same as you would specify attributes for your attributedText, any attributes you want to be different about your links, you add to LinkLabel’s linkTextAttributes, and highlightedLinkTextAttributes.

Install with CocoaPods

pod 'LinkLabel'

Install Manually

1. Drag contents of Source folder into your Xcode project.
2. Add #import "UIKit/UIGestureRecognizerSubclass.h" to Bridging Header file.

Usage

Create a label using LinkLabel, instead of UILabel.

let myLabel = LinkLabel()

Setup attributed text, including NSLinkAttributeName, as normal.

let text = "This is some text, which includes a url link and a string link."
let fullRange = NSMakeRange(0, (text as NSString).length)
let urlRange = (text as NSString).range(of: "url link")
let stringRange = (text as NSString).range(of: "string link")

let attributedString = NSMutableAttributedString(string: text)
attributedString.addAttribute(.font, value: UIFont.systemFont(ofSize: 15), range: fullRange)
attributedString.addAttribute(.foregroundColor, value: UIColor.black, range: fullRange)
attributedString.addAttribute(.link, value: URL(string: "https://google.com")!, range: urlRange)
attributedString.addAttribute(.link, value: "string_link", range: stringRange)

If you wish to customise the link appearance:

let linkTextAttributes: [NSAttributedString.Key: Any] = [
    .underlineStyle: NSUnderlineStyle.styleSingle.rawValue,
    .foregroundColor: UIColor.green
]

let highlightedLinkTextAttributes: [NSAttributedString.Key: Any] = [
    .underlineStyle: NSUnderlineStyle.styleSingle.rawValue,
    .foregroundColor: UIColor.red
]

label.linkTextAttributes = linkTextAttributes
label.highlightedLinkTextAttributes = highlightedLinkTextAttributes

To make it easier to respond to link taps, set a closure on the onSelectLink property:

label.onSelectLink = { value in
    switch value {
    case .url(let url):
        print("did select link: \(url)")
    case .string(let string):
        print("did select link: \(string)")
    }
}

Credit

Created by Andrew Hart, for TwIM.

ProjectDent.com

@ProjectDent