The Wayback Machine - https://web.archive.org/web/20201028060929/https://github.com/ysoftware/appendAttributedString
Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

README.md

append(attributedString, with: ease)

Swift 5

An extension that adds a way for easier work with NSMutableAttributedString.

Supports dynamic fonts, colors, underlines, strike through, images and you can chain append calls. And with the AttributesBuilder class it's easy to create attribute sets for Attributed String.

Install with Cocoapods:

pod 'appendAttributedString'

Here's an example:

let label = UILabel()
label.numberOfLines = 0
view.backgroundColor = .darkGray

let string = NSMutableAttributedString()

.appendHeadline("Life can rise,\n")

// call chaining
.appendFootnote("it can fall.\n\n")

// color, underline, strike through, superscript and others
.append("But in the end\nit's just carried ", color: .white)
.append("with the wind\n",
        color: .yellow,
        font: .dynamic(.systemFont(ofSize: 10)),
        baselineOffset: 5)
.append("and one day everything you do will simply cease to be…\n\n",
        color: .green,
        underlineStyle: .double)
.append("Like a child's ", color: .white)

// even images
.append(image: UIImage(named: "balloon")!,
        // (the image will not auto-adjust its height)
        height: UIFontMetrics.default.scaledValue(for: 20))

.append("\n\n")

// In specal cases use AttributesBuilder class for easier attributes set up
.append("when it's lost,\nit's a tragic affair\n",
        with: AttributesBuilder()
            .color(.white)
            .shadow(offset: CGSize(width: -7, height: 3),
                    blurRadius: 5, color: .yellow)
            .outline(width: -2, color: .red)
            .lineSpacing(30)
            .align(.center))

.append("- but it is quickly forgotten.", with:
    AttributesBuilder()
        .strikeThrough(.double, color: .white)
        .align(.right))

textView.attributedText = string

result

Breaking changes in 1.2:

Removed:

AttributesBuilder().paragraph(style: _)

Added:

AttributesBuilder().paragraphStyle(_)

To ensure paragraph style to always be a mutable instance, the old method accepting a non-mutating instance was removed.

The new method also reads better.

You can’t perform that action at this time.