TTTAttributedLabel
A drop-in replacement for UILabel
that supports attributes, data detectors, links, and more
TTTAttributedLabel
is a drop-in replacement for UILabel
providing a simple way to performantly render attributed strings. As a bonus, it also supports link embedding, both automatically with NSTextCheckingTypes
and manually by specifying a range for a URL, address, phone number, event, or transit information.
Even though UILabel
received support for NSAttributedString
in iOS 6, TTTAttributedLabel
has several unique features:
- Compatibility with iOS >= 4.3
- Automatic data detection
- Manual link embedding
- Label style inheritance for attributed strings
- Custom styling for links within the label
- Long-press gestures in addition to tap gestures for links
It also includes advanced paragraph style properties:
attributedTruncationToken
firstLineIndent
highlightedShadowRadius
highlightedShadowOffset
highlightedShadowColor
lineHeightMultiple
lineSpacing
minimumLineHeight
maximumLineHeight
shadowRadius
textInsets
verticalAlignment
Accessibility
As of version 1.10.0, TTTAttributedLabel
supports VoiceOver through the UIAccessibilityElement
protocol. Each link can be individually selected, with an accessibilityLabel
equal to its string value, and a corresponding accessibilityValue
for URL, phone number, and date links. Developers who wish to change this behavior or provide custom values should create a subclass and override accessibilityElements
.
Communication
- If you need help, use Stack Overflow. (Tag
tttattributedlabel
) - If you'd like to ask a general question, use Stack Overflow.
- If you found a bug, open an issue.
- If you have a feature request, open an issue.
- If you want to contribute, submit a pull request.
Installation
CocoaPods is the recommended method of installing TTTAttributedLabel
. Simply add the following line to your Podfile
:
Podfile
pod 'TTTAttributedLabel'
Usage
TTTAttributedLabel *label = [[TTTAttributedLabel alloc] initWithFrame:CGRectZero];
label.font = [UIFont systemFontOfSize:14];
label.textColor = [UIColor darkGrayColor];
label.lineBreakMode = NSLineBreakByWordWrapping;
label.numberOfLines = 0;
// If you're using a simple `NSString` for your text,
// assign to the `text` property last so it can inherit other label properties.
NSString *text = @"Lorem ipsum dolor sit amet";
[label setText:text afterInheritingLabelAttributesAndConfiguringWithBlock:^ NSMutableAttributedString *(NSMutableAttributedString *mutableAttributedString) {
NSRange boldRange = [[mutableAttributedString string] rangeOfString:@"ipsum dolor" options:NSCaseInsensitiveSearch];
NSRange strikeRange = [[mutableAttributedString string] rangeOfString:@"sit amet" options:NSCaseInsensitiveSearch];
// Core Text APIs use C functions without a direct bridge to UIFont. See Apple's "Core Text Programming Guide" to learn how to configure string attributes.
UIFont *boldSystemFont = [UIFont boldSystemFontOfSize:14];
CTFontRef font = CTFontCreateWithName((__bridge CFStringRef)boldSystemFont.fontName, boldSystemFont.pointSize, NULL);
if (font) {
[mutableAttributedString addAttribute:(NSString *)kCTFontAttributeName value:(id)font range:boldRange];
[mutableAttributedString addAttribute:kTTTStrikeOutAttributeName value:@YES range:strikeRange];
CFRelease(font);
}
return mutableAttributedString;
}];
First, we create and configure the label, the same way you would instantiate UILabel
. Any text properties that are set on the label are inherited as the base attributes when using the -setText:afterInheritingLabelAttributesAndConfiguringWithBlock:
method. In this example, the substring "ipsum dolar", would appear in bold, such that the label would read "Lorem ipsum dolar sit amet", in size 14 Helvetica, with a dark gray color.
The normal setText:
setter accepts both NSString
and NSAttributedString
; in the latter case, the attributed string is directly set, without inheriting the base style of the label.
Links and Data Detection
In addition to supporting rich text, TTTAttributedLabel
can automatically detect links for dates, addresses, URLs, phone numbers, transit information, and allows you to embed your own links.
label.enabledTextCheckingTypes = NSTextCheckingTypeLink; // Automatically detect links when the label text is subsequently changed
label.delegate = self; // Delegate methods are called when the user taps on a link (see `TTTAttributedLabelDelegate` protocol)
label.text = @"Fork me on GitHub! (http://github.com/mattt/TTTAttributedLabel/)"; // Repository URL will be automatically detected and linked
NSRange range = [label.text rangeOfString:@"me"];
[label addLinkToURL:[NSURL URLWithString:@"http://github.com/mattt/"] withRange:range]; // Embedding a custom link in a substring
Demo
pod try TTTAttributedLabel
...or clone this repo and build and run/test the Espressos
project in Xcode to see TTTAttributedLabel
in action. If you don't have CocoaPods installed, grab it with [sudo] gem install cocoapods
.
cd Example
pod install
open Espressos.xcworkspace
Requirements
- iOS 4.3+ (iOS 6+ Base SDK)
- Xcode 6
License
TTTAttributedLabel
is available under the MIT license. See the LICENSE file for more info.