Skip to content

TextReplacements is a SwiftUI library that extends the Text view with ways to customize the rendering of any parts of its text.

License

Notifications You must be signed in to change notification settings

danielsaidi/TextReplacements

Repository files navigation

Project Icon

Version Swift 6.1 Swift UI Documentation MIT License

TextReplacements

TextReplacements is a SwiftUI library that extends the Text view with ways to customize any parts of its text.

TextReplacements works on all major Apple platforms and is designed to be easy to use.

Installation

TextReplacements can be installed with the Swift Package Manager:

https://github.com/danielsaidi/TextReplacements.git

Usage

TextReplacements let you initialize a Text view with a string and one or multiple text replacements.

The text view in the preview above is created like this:

Text(
    "TextReplacements is a SwiftUI library that extends the Text view with ways to customize any parts of its text. The result is a Text with customized segments that can flow nicely over multiple lines.",
    replacements: [
        "TextReplacements": {
            Text($0)
                .font(.title)
                .fontWeight(.black)
                .fontDesign(.rounded)
                .foregroundColor(.green)
        },
        "SwiftUI": {
            Text($0)
                .font(.headline)
                .fontWeight(.black)
                .fontDesign(.rounded)
                .foregroundColor(.blue)
        },
        "Text": {
            Text($0)
                .fontWeight(.black)
                .fontDesign(.rounded)
                .foregroundColor(.black.opacity(0.6))
        },
        "customize": {
            Text($0)
                .italic()
                .underline()
                .font(.body)
                .fontWeight(.heavy)
                .fontDesign(.monospaced)
                .foregroundColor(.purple)
        },
        "par": {
            Text($0)
                .font(.headline)
                .fontWeight(.black)
                .fontDesign(.rounded)
                .foregroundColor(.red)
        },
        "can flow nicely over multiple lines": {
            Text($0)
                .foregroundColor(.orange)
        }
    ]
)

You can perform any modification that result in new Text views. This brings some limitations, like not being able to apply a background color, but lets you highlight certain parts of a text with very little effort.

Documentation

This package will be documented once it gets more than 100 stars.

Demo Application

This package will get a demo application once it gets more than 100 stars.

Support my work

You can sponsor me on GitHub Sponsors or reach out for paid support, to help support my open-source projects.

Your support makes it possible for me to put more work into these projects and make them the best they can be.

Contact

Feel free to reach out if you have questions or want to contribute in any way:

License

TextReplacements is available under the MIT license. See the LICENSE file for more info.

About

TextReplacements is a SwiftUI library that extends the Text view with ways to customize the rendering of any parts of its text.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project