Tribute 
let string = NSMutableAttributedString().add("Hello ") {
$0.font = .systemFontOfSize(20)
$0.color = .redColor()
$0.underline = .StyleSingle
}.add("world ") {
$0.stroke = .Filled(width: 2)
$0.strokeColor = .orangeColor()
}.add("of Swift "){
$0.font = .systemFontOfSize(12)
$0.underline = nil
$0.URL = NSURL(string: "http://swift.org")!
}.add(UIImage(named: "swift")!)
Not bad comparing to
let string2 = NSMutableAttributedString()
string2.appendAttributedString(NSAttributedString(string: "Hello ", attributes: [
NSFontAttributeName: UIFont.systemFontOfSize(20),
NSUnderlineStyleAttributeName: NSUnderlineStyle.StyleSingle.rawValue,
NSForegroundColorAttributeName: UIColor.redColor()
]))
string2.appendAttributedString(NSAttributedString(string: "world ", attributes: [
NSFontAttributeName: UIFont.systemFontOfSize(20),
NSUnderlineStyleAttributeName: NSUnderlineStyle.StyleSingle.rawValue,
NSForegroundColorAttributeName: UIColor.redColor(),
NSStrokeColorAttributeName: UIColor.orangeColor(),
NSStrokeWidthAttributeName: -2
]))
string2.appendAttributedString(NSAttributedString(string: "of Swift ", attributes: [
NSFontAttributeName: UIFont.systemFontOfSize(12),
NSForegroundColorAttributeName: UIColor.redColor(),
NSStrokeColorAttributeName: UIColor.orangeColor(),
NSStrokeWidthAttributeName: -2
]))
let attachment = NSTextAttachment()
attachment.image = UIImage(named: "swift")
string2.appendAttributedString(NSAttributedString(attachment: attachment))
Design Goals
- Word processor logic: appending a string should inherit last attributes.
- Allow for easy customization of common properties, including toggle bold or change the font size.
- Flatten paragraph style and attributes, no more 5 lines of code if all you wanted is to change text alignment.
- Replace weird attributes with more reasonable versions (for example
Attribute.Strokevs NSStrokeWidthAttributeName). - Minimal overhead: produce only required attributes.
- Have an attributed string ready to use every time you leave the configuration block.
- Replace string constants with strongly typed enums where possible.
Notes
Playground
Playgrounds do not always render NSAttributesString correctly (font variations and attachments are few of the problematic I noticed).
Workaround: Use a UILabel as a live view instead: XCPlaygroundPage.currentPage.liveView = label.
Font variations
Not all fonts have both italic and bold variations
Workaround: Use obliqueness property as a poor man italic, and expansion as a bold respectively.
Closure with one statement
When the configuration closure includes only one statement, compiler gets confused
Workaround: Specify closure type explicitly like so
string.add("text") { (inout a: Attributes) in
a.color = .redColor()
}
If you know a better way, please open a PR, I'd love to learn from it!
Roadmap
- Objective-C compatibility
- Moar attributes (PRs are welcome)
This is just a tribute
1 Feb 4, 2022
1 Jul 18, 2022
4.6k Dec 26, 2022
860 Dec 18, 2022
753 Jan 2, 2023
2 Jun 16, 2022
1 Nov 5, 2021
11 Dec 17, 2021
0 Dec 4, 2021
4 Feb 8, 2022
49 Oct 2, 2022
257 Dec 6, 2022
44 Dec 27, 2022
49 Jan 2, 2023
12 Apr 15, 2022
5 Dec 3, 2022
6.9k Dec 8, 2022
232 Dec 20, 2022
75 Nov 11, 2022
1 Feb 4, 2022
1 Jul 18, 2022
94 Feb 28, 2022
1.1k Dec 26, 2022