This is a simple utility for turning strings containing markup into NSAttributedStrings.
Building NSAttributedStrings can be cumbersome, often involving constructing and concatenating a bunch of small strings together in a way that's hard to parse. For example
NSMutableAttributedString *const string = [NSMutableAttributedStringnew];
NSDictionary *const textAttributes = @{NSFontAttributeName: [UIFont systemFontOfSize:18.0]};
NSDictionary *const boldTextAttributes = @{NSFontAttributeName: [UIFont boldSystemFontOfSize:18.0]};
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"Here's to the "attributes:textAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"crazy ones.\n"attributes:boldTextAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"The "attributes:textAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"misfits.\n"attributes:boldTextAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"The "attributes:textAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"troublemakers.\n"attributes:boldTextAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"The "attributes:textAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"round pegs"attributes:boldTextAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"in the "attributes:textAttributes]];
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"square holes.\n\n"attributes:boldTextAttributes]];
NSDictionary *const byLineTextAttributes = @{NSFontAttributeName: [UIFont italicSystemFontOfSize:16.0], NSForegroundColorAttributeName: [UIColor grayColor]};
[string appendAttributedString:[[NSAttributedStringalloc] initWithString:@"‒ Steve Jobs"attributes:byLineTextAttributes]];Concatenation isn't great for localization since other languages often order things differently.
This library lets you convert plain strings into attributed strings using arbitrary markup and styling of your choosing. To recreate the above text you'd do something like the following.
NSString *const markupString = @"Here's to the <b>crazy ones</b>.\nThe <b>misfits</b>.\nThe <b>troublemakers</b>.\nThe <b>round pegs</b> in the <b>square holes</b>.\n\n<i>‒ Steve Jobs</i>";
NSDictionary *const textAttributes = @{NSFontAttributeName: [UIFont systemFontOfSize:18.0]};
NSAttributedString *const string = [NSAttributedStringattributedStringWithMarkupString:markupString
attributes:textAttributes
customizerBlock:^NSDictionary *(NSString *tag, NSDictionary *attributes) {
if ([tag isEqualToString:@"b"]) {
return @{NSFontAttributeName: [UIFont boldSystemFontOfSize:18.0]};
} elseif ([tag isEqualToString:@"i"]) {
return @{NSFontAttributeName: [UIFont italicSystemFontOfSize:16.0],
NSForegroundColorAttributeName: [UIColor grayColor]};
}
returnnil;
}];The attributes text attributes are applied to the string passed in. The customization block is called for each <...>/</...> markup tag identified in the string and the attributes you return from that block are applied on top of the span enclosed in that tag. Simple as that!
By default this method handles nested pairs of tags, but this has some small performance drawbacks. If you know your markup won't contain any nested tags and you're concerned about performance you can use the variant of the method that includes the supportNesting: param and pass NO.
I built this when localizing Opener, and I've since used it in Burst as well. I find this to be a pretty sensible, uncomplicated way of building attributed strings. Hope you find it useful!