Handle plurals in SwiftUI Text views with inflection

The Foundation framework has a feature called automatic grammar agreement that reduces the number of localized strings we need to provide while making our code simpler. It ensures text follows grammatical rules like pluralization and gender. It works seamlessly with SwiftUI, allowing us to handle plurals directly in Text views without any extra manual logic.

To make text automatically adjust to plural values, we can specify that we want it to use the inflection rule and define the scope for the inflection using the following syntax:

Text("You read ^[\(bookCount) book](inflect: true) this year!")

SwiftUI recognizes this syntax as a custom Markdown attribute and processes it accordingly. When a Text view is created with a string literal, as shown in the example above, SwiftUI treats the string as a LocalizedStringKey and parses the Markdown it contains. It identifies inflection attributes within the string and uses the automatic grammar agreement feature from Foundation to apply the necessary adjustments during rendering.

Here’s how that would look in a complete SwiftUI view:

struct BookReadingTracker: View {
    @State private var bookCount: Int = 0
    
    var body: some View {
        VStack(spacing: 16) {
            Text("""
            You read ^[\(bookCount) book](inflect: true) this year!
            """)

            Button("Add a book") {
                bookCount += 1
            }
        }
    }
}

In this example, tapping the button increases the bookCount value, and the text updates automatically. When bookCount is 1, it uses the singular form book. As the value increases, such as to 2 or higher, the text dynamically switches to the plural form, ensuring grammatical correctness.

Two views showing 'You read 1 book this year!' and 'You read 2 books this year!' with 'Add a book' button below

This integration makes handling plurals in SwiftUI both simple and efficient. The automatic grammar agreement feature and the inflection attribute were introduced in iOS 15 with initial support for English and Spanish. Over the years, the grammar engine was expanded to include additional languages, and as of iOS 18, it also supports German, French, Italian, Portuguese, Hindi, and Korean, making it even more versatile for multilingual apps.

If you have older iOS apps and want to enhance them with modern SwiftUI features, check out my book Integrating SwiftUI into UIKit Apps. It provides detailed guidance on gradually adopting SwiftUI in your UIKit projects. Additionally, if you're eager to enhance your Swift programming skills, my latest book Swift Gems offers over a hundred advanced tips and techniques, including optimizing collections, handling strings, mastering asynchronous programming, and debugging, to take your Swift code to the next level.

If you are enjoying our blog and would like to support us, you can sponsor us on GitHub.

Subscribe to our monthly newsletter to get exclusive Swift and SwiftUI tips, project updates, behind-the-scenes insights, and special discounts on our books.