Result Builder — nó là gì, cú pháp và ứng dụng

Result Builder là gì?

Result Builder (trước đây gọi là function builders) là một cơ chế Swift cho phép biến đổi một chuỗi các biểu thức được phân cách bằng dấu xuống dòng thành một giá trị duy nhất. Nó được khai báo bằng thuộc tính @resultBuilder áp dụng cho một cấu trúc triển khai các phương thức chuyển đổi tĩnh.

Trước result builders, cú pháp khai báo của SwiftUI body là không thể. Thay vì một danh sách view nhỏ gọn, các nhà phát triển phải viết thủ công các lời gọi TupleView. Result Builder tự động bọc mỗi biểu thức, hỗ trợ rẽ nhánh và vòng lặp, ẩn đi sự phức tạp của việc kết hợp khỏi nhà phát triển.

Theo Swift Evolution SE-0289, được chấp nhận vào năm 2022, result builder là sự phát triển của ý tưởng function builders (SE-0258, Swift 5.1). Các thay đổi chính: đổi tên từ @_functionBuilder thành @resultBuilder và mở rộng sang tham số hàm, cho phép sử dụng builder cho bất kỳ đối số closure nào, không chỉ phần thân view.

Sử dụng result builders khi bạn cần cung cấp cho người dùng thư viện của mình một cú pháp khai báo để xây dựng các cấu trúc phức tạp — cấu hình, truy vấn, thành phần UI — mà không cần viết mã lắp ráp mệnh lệnh.

Result Builder hoạt động như thế nào

Trình biên dịch Swift biến đổi mỗi khối mã được đánh dấu bằng @resultBuilder thành một chuỗi các lời gọi phương thức tĩnh của builder. Hãy xem một builder đơn giản nối chuỗi:

@resultBuilder
struct StringBuilder {
    static func buildBlock(_ parts: String...) -> String {
        parts.joined(separator: " ")
    }
}

Sử dụng builder này — mỗi chuỗi trên một dòng riêng được nối với một khoảng trắng:

@StringBuilder
func greeting() -> String {
    "Hello"
    "World"
    "from"
    "Swift"
}
// Trình biên dịch biến đổi điều này thành:
// StringBuilder.buildBlock("Hello", "World", "from", "Swift")
// Kết quả: "Hello World from Swift"

Trình biên dịch nhóm các biểu thức liên tiếp và truyền chúng dưới dạng tham số variadic cho buildBlock. Nếu một if xuất hiện giữa các biểu thức, trình biên dịch gọi buildOptional hoặc buildEither để rẽ nhánh. Đối với vòng lặp for-in, nó gọi buildArray. Như vậy, mã Swift thông thường được biến đổi thành một chuỗi các lời gọi xây dựng giá trị cuối cùng.

Các phương thức builder: buildBlock, buildOptional, buildEither

Mỗi result builder định nghĩa một tập hợp các phương thức tĩnh mà trình biên dịch gọi trong quá trình chuyển đổi. Các phương thức chính:

Một triển khai tối thiểu chỉ yêu cầu buildBlock với tham số variadic — đủ cho các khối không có rẽ nhánh. Thêm buildOptional và buildEither bao gồm hỗ trợ cấu trúc điều kiện, và buildArray cho vòng lặp. Theo Tài liệu Swift (2025), nên triển khai tất cả các phương thức để đạt độ linh hoạt tối đa của DSL.

buildExpression cho phép chấp nhận các biểu thức thuộc kiểu khác nhau và chuyển đổi chúng thành một kiểu builder duy nhất. Ví dụ, trong @ViewBuilder, buildExpression chấp nhận Text, Image, Button và chuyển đổi chúng thành kiểu View chung.

Tạo Result Builder tùy chỉnh

Hãy xem xét việc tạo một builder để xây dựng chuỗi HTML. DSL này sẽ cho phép viết HTML khai báo trực tiếp trong Swift:

@resultBuilder
enum HTMLBuilder {
    static func buildBlock(_ components: String...) -> String {
        components.joined()
    }

    static func buildOptional(_ component: String?) -> String {
        component ?? ""
    }

    static func buildEither(first component: String) -> String {
        component
    }

    static func buildEither(second component: String) -> String {
        component
    }

    static func buildArray(_ components: [String]) -> String {
        components.joined()
    }
}

Sử dụng builder tùy chỉnh để tạo HTML:

func div(@HTMLBuilder _ content: () -> String) -> String {
    "<div>\(content())</div>"
}

func p(_ text: String) -> String {
    "<p>\(text)</p>"
}

let page = div {
    p("Hello")
    p("World")

    if showFooter {
        p("Chân trang")
    }
}
// Kết quả: <div><p>Hello</p><p>World</p><p>Footer</p></div>

Theo bài viết “Building Custom Result Builders in Swift” từ Swift.org (2025), builder tùy chỉnh được sử dụng trong các thư viện để xây dựng tệp cấu hình, thành phần UI, ánh xạ dữ liệu và thậm chí truy vấn cơ sở dữ liệu — bất cứ nơi nào cần cú pháp khai báo với hỗ trợ rẽ nhánh.

@ViewBuilder trong SwiftUI

@ViewBuilder là một result builder được tích hợp trong SwiftUI, áp dụng cho tham số content của hầu hết các view chứa: VStack, HStack, ZStack, Group, List và thuộc tính body. Nó cho phép viết nhiều view trên các dòng riêng biệt mà không cần dấu phẩy hay trình bao bọc.

@ViewBuilder triển khai tất cả các phương thức result builder, bao gồm hỗ trợ if-else, switch và for-in. Khi điều kiện đúng, buildEither(first:) trả về một view; khi sai, buildEither(second:) trả về một view khác. Cả hai nhánh phải trả về cùng kiểu, nhưng SwiftUI sử dụng AnyView nội bộ hoặc xóa kiểu thông qua ConditionalContent.

struct GreetingView: View {
    let isLoggedIn: Bool

    var body: some View {
        VStack {
            Image(systemName: "person.circle")
            Text("Hồ sơ")
                .font(.title)

            if isLoggedIn {
                Text("Chào mừng trở lại!")
                    .foregroundColor(.green)
            } else {
                Button("Đăng nhập") { }
            }
        }
    }
}

Nếu không có @ViewBuilder, cùng một mã sẽ yêu cầu Group cho mỗi phần có điều kiện hoặc sử dụng AnyView, làm giảm hiệu suất. @ViewBuilder tự động chọn biểu diễn hiệu quả nhất — ConditionalContent hoặc TupleView — cho mỗi tổ hợp.

Hạn chế của Result Builder

Hạn chế đầu tiên là số lượng biểu thức tối đa trong buildBlock. Thư viện chuẩn Swift định nghĩa các nạp chồng buildBlock cho 2–10 biểu thức. Nếu một khối có hơn 10 biểu thức, trình biên dịch sẽ đưa ra lỗi. Giải pháp là nhóm qua Group hoặc VStack để chia thành các khối con.

Hạn chế thứ hai là thiếu hỗ trợ cho biến và phép gán bên trong khối builder. Bạn không thể khai báo let x = 5 bên trong @ViewBuilder. Tất cả biểu thức phải là biểu thức trả về giá trị kiểu builder. Đối với tính toán trung gian, hãy sử dụng tính toán bên ngoài builder hoặc buildExpression hỗ trợ các kiểu khác nhau.

Hạn chế thứ ba là sự phức tạp khi gỡ lỗi. Lỗi biên dịch bên trong result builder thường tạo ra thông báo khó hiểu, đặc biệt khi kiểu không khớp trong các nhánh if/else. Sử dụng kiểu trả về rõ ràng và AnyView để gỡ lỗi, mặc dù cái sau làm giảm hiệu suất. Theo Hacking with Swift (2025), mẹo thực tế — hãy bắt đầu với một builder đơn giản không rẽ nhánh và dần dần thêm hỗ trợ cấu trúc điều kiện.