SwiftUI Cơ bản: Views, Modifiers và Điều Hướng – Bước Đầu Xây Dựng Giao Diện Hiện Đại

SwiftUI cơ bản trong năm 2026 không chỉ là viết vài dòng Text thay cho một UILabel. Bạn cần hiểu View là value mô tả giao diện, state là nguồn sự thật, modifier tạo ra một View mới, còn navigation là dữ liệu có thể kiểm soát. Khi nắm đúng mental model này, bạn sẽ tránh được những lỗi quen thuộc như mất trạng thái khi điều hướng, danh sách nhấp nháy vì ID không ổn định, hoặc giao diện chỉ đẹp ở kích thước chữ mặc định.

Cập nhật 2026: học SwiftUI trên nền tảng nào?

  • Swift 6.4.2 là bản cài đặt hiện tại; Swift 6.4 phát hành ngày 15/09/2026. Xcode 27.2 và iOS 27.2 là bản ổn định tại thời điểm viết bài.
  • SwiftUI đi cùng iOS SDK, không có một số phiên bản độc lập để pin. Với code mới, ưu tiên NavigationStack, NavigationSplitView, Observation với @Observable và structured concurrency.
  • Liquid Glass được giới thiệu từ iOS 26. Bạn có thể dùng glassEffect và GlassEffectContainer, nhưng vật liệu này là điểm nhấn chứ không phải lớp phủ cho mọi View.
  • Swift 6 language mode bật kiểm tra concurrency nghiêm ngặt. Hãy xem cảnh báo về actor isolation và Sendable là phản hồi thiết kế, không phải thứ cần tắt vội.

Sample trong bài hướng tới Swift 6.4, Xcode 27.2 và iOS 27.2. Nếu project vẫn hỗ trợ iOS 25 trở xuống, bạn cần thay các API mới bằng nhánh availability tương ứng; bài này không quay lại các API đã bị thay thế như NavigationView.

View và body: mô tả thay vì ra lệnh

Mọi thành phần hiển thị trong SwiftUI đều là một View: chữ, ảnh, nút bấm, danh sách, hoặc một container chứa nhiều View khác. Một View thường là struct tuân thủ protocol View. Thuộc tính bắt buộc là body với kiểu trả về some View. Từ khóa some giữ kiểu cụ thể ở phía triển khai nhưng cho compiler biết rằng View này luôn trả về một kiểu xác định.

Bạn không gọi trực tiếp các lệnh kiểu “thêm subview”, “đặt frame”, “reload table” trong body. Bạn mô tả trạng thái giao diện mong muốn. Khi một giá trị mà View đọc bị thay đổi, SwiftUI đánh giá lại phần cây View liên quan và tự đồng bộ rendering. Việc body có thể được chạy nhiều lần là bình thường, vì vậy nó phải nhẹ, không có side effect và không tạo ngẫu nhiên dữ liệu cho mỗi lần đánh giá.

import SwiftUI

struct WelcomeView: View {
    var body: some View {
        VStack(spacing: 12) {
            Image(systemName: "swift")
                .font(.system(size: 48))
                .accessibilityHidden(true)
            Text("Xin chào, SwiftUI")
                .font(.title)
            Text("Một View là mô tả có thể kết hợp.")
                .font(.body)
                .multilineTextAlignment(.center)
        }
        .padding()
    }
}

Text hiển thị nội dung và tự thích ứng Dynamic Type. Image(systemName:) dùng SF Symbols; ảnh trong asset catalog dùng Image("ten-asset"). Button nhận một action và một label, còn TextField cần một binding như $query để cập nhật dữ liệu hai chiều. Các control như Toggle, Picker, Slider cũng hoạt động theo cùng nguyên tắc binding.

Bố cục: stack, frame, grid và list

VStack xếp con theo chiều dọc, HStack theo chiều ngang, còn ZStack xếp theo chiều sâu. Dùng Spacer để phân phối khoảng trống thay vì gán tọa độ tuyệt đối. ScrollView phù hợp với nội dung tự do; List cung cấp hành vi danh sách theo nền tảng; LazyVStack và LazyHStack trì hoãn việc tạo View khi danh sách dài.

Grid phù hợp với dữ liệu dạng ô có hàng và cột. frame chỉ nên đặt giới hạn khi bạn thật sự có yêu cầu về layout; một frame cố định thường phá vỡ giao diện khi Dynamic Type tăng hoặc iPad chuyển sang kích thước khác. Ưu tiên frame(maxWidth: .infinity, alignment: .leading), containerRelativeFrame và các layout thích ứng khi có thể.

struct StatsView: View {
    let values = ["Views", "State", "Navigation", "Testing"]

    var body: some View {
        ScrollView {
            LazyVGrid(columns: [GridItem(.adaptive(minimum: 130))]) {
                ForEach(values, id: \.self) { value in
                    Label(value, systemImage: "checkmark.circle")
                        .frame(maxWidth: .infinity, alignment: .leading)
                        .padding(.vertical, 8)
                }
            }
            .padding()
        }
    }
}

Trong ví dụ dữ liệu tĩnh, id: \.self chấp nhận được vì các chuỗi là duy nhất và không đổi. Với model thật, hãy dùng khóa định danh ổn định của model thay vì index của mảng hoặc một UUID() mới tạo ngay trong body.

Modifier và thứ tự áp dụng

Modifier là phương thức nhận một View rồi trả về một View khác đã được biến đổi. Chuỗi modifier đọc từ trên xuống: modifier phía sau hoạt động trên kết quả của modifier phía trước. Đây là lý do cùng một tập modifier nhưng đổi thứ tự lại cho ra kích thước nền, vùng chạm và vị trí khác nhau.

Text("Nhãn hành động")
    .padding(12)
    .background(.blue)
    .foregroundStyle(.white)
    .clipShape(.rect(cornerRadius: 12))

Text("Nhãn hành động")
    .background(.blue)
    .padding(12)

Ở đoạn đầu, nền bao quanh cả phần đệm. Ở đoạn sau, nền chỉ ôm phần chữ rồi khoảng đệm nằm bên ngoài. Với control tương tác, hãy đặt contentShape và accessibilityLabel ở vị trí phù hợp, đồng thời kiểm tra vùng tap thực tế. Những modifier như font, foregroundStyle, frame, padding, background, overlay và clipShape nên được xếp theo ý định layout, không theo thói quen sao chép.

Đừng dùng AnyView để che mọi lỗi kiểu. Type erasure có chỗ dùng, nhưng thường làm mất thông tin cấu trúc mà SwiftUI dùng để theo dõi thay đổi. Tách View nhỏ, dùng @ViewBuilder hoặc các nhánh trả về cùng một opaque View trước khi cân nhắc AnyView.

State và data flow: ai sở hữu giá trị?

@State dành cho state cục bộ do View sở hữu, ví dụ text nhập vào, tab đang chọn hoặc sheet đang mở. @Binding là quyền đọc/ghi một giá trị do View cha sở hữu; View con không tạo nguồn sự thật thứ hai. Khi truyền $isPresented hoặc $model.query, bạn đang truyền binding, không phải một bản sao.

Với model dùng chung, @Observable từ framework Observation là lựa chọn ưu tiên cho code mới. Macro này theo dõi các thuộc tính thực sự được đọc bởi View, không cần biến mọi thuộc tính thành @Published. @Environment dành cho dependency hoặc giá trị xuyên qua nhiều tầng View, chẳng hạn dismiss, color scheme, locale và model môi trường. Dùng environment có chủ ý; dependency quan trọng nên thể hiện rõ ở initializer để dễ test.

Quy tắc thực hành: nơi khởi tạo model chịu ownership; nơi chỉ sửa một phần dữ liệu nhận binding; nơi chỉ đọc nhận giá trị hoặc model read-only. Nếu navigation đẩy một View mới và bạn khởi tạo lại model ở destination, state sẽ mất. Đưa model lên owner chung hoặc lưu path/state ở cấp phù hợp với vòng đời màn hình.

Màn hình chạy được: danh sách, state, điều hướng và sheet

Đoạn dưới đây là một màn hình tối giản nhưng có đủ các mảnh thường gặp: model observable, search binding, stable ID, NavigationStack, navigationDestination, sheet, fullScreenCover và tác vụ bất đồng bộ. Tạo file SwiftUI trong project iOS 27.2, dán toàn bộ đoạn code và đặt ContentView làm root view.

import Observation
import SwiftUI

enum Route: Hashable {
    case detail(UUID)
}

struct RoadmapItem: Identifiable, Hashable {
    let id: UUID
    let title: String
    let summary: String
}

@MainActor
@Observable
final class RoadmapModel {
    var query = ""
    var isShowingSettings = false
    var isShowingWelcome = false
    var items = [
        RoadmapItem(id: UUID(), title: "Views", summary: "Mô tả giao diện bằng value type."),
        RoadmapItem(id: UUID(), title: "State", summary: "Giữ nguồn sự thật và binding."),
        RoadmapItem(id: UUID(), title: "Navigation", summary: "Điều hướng bằng route có kiểu."),
    ]

    var filteredItems: [RoadmapItem] {
        guard !query.isEmpty else { return items }
        return items.filter { $0.title.localizedCaseInsensitiveContains(query) }
    }

    func refresh() async {
        try? await Task.sleep(for: .milliseconds(150))
        if !items.contains(where: { $0.title == "Async" }) {
            items.append(RoadmapItem(id: UUID(), title: "Async", summary: "Tải dữ liệu với .task."))
        }
    }
}

struct ContentView: View {
    @State private var model = RoadmapModel()
    @State private var path: [Route] = []

    var body: some View {
        @Bindable var model = model

        NavigationStack(path: $path) {
            List(model.filteredItems) { item in
                NavigationLink(value: Route.detail(item.id)) {
                    Label(item.title, systemImage: "swift")
                        .accessibilityHint("Mở nội dung chi tiết")
                }
            }
            .navigationTitle("SwiftUI 2026")
            .searchable(text: $model.query, prompt: "Tìm chủ đề")
            .toolbar {
                ToolbarItem(placement: .topBarTrailing) {
                    Button("Cài đặt", systemImage: "gear") {
                        model.isShowingSettings = true
                    }
                    .accessibilityLabel("Mở cài đặt")
                }
            }
            .navigationDestination(for: Route.self) { route in
                switch route {
                case .detail(let id):
                    DetailView(item: model.items.first { $0.id == id })
                }
            }
            .sheet(isPresented: $model.isShowingSettings) {
                SettingsView()
                    .presentationDetents([.medium])
            }
            .fullScreenCover(isPresented: $model.isShowingWelcome) {
                WelcomeView()
            }
            .task {
                await model.refresh()
            }
        }
    }
}

struct DetailView: View {
    let item: RoadmapItem?

    var body: some View {
        ContentUnavailableView(
            item?.title ?? "Không tìm thấy",
            systemImage: "questionmark.folder",
            description: Text(item?.summary ?? "ID không còn tồn tại.")
        )
        .navigationTitle(item?.title ?? "Chi tiết")
    }
}

struct SettingsView: View {
    @Environment(\.dismiss) private var dismiss

    var body: some View {
        NavigationStack {
            Form { Text("Cài đặt mẫu") }
                .navigationTitle("Cài đặt")
                .toolbar {
                    Button("Đóng") { dismiss() }
                }
        }
    }
}

#Preview {
    ContentView()
}

Trong code, các UUID được tạo khi model khởi tạo và giữ nguyên trong suốt vòng đời model. Đó là điểm khác với việc đặt id: UUID() trong ForEach. NavigationLink(value:) chỉ đẩy route; destination được quyết định tập trung bởi navigationDestination, dễ mở rộng hơn khi app có nhiều màn hình.

NavigationStack, NavigationSplitView và modal

NavigationStack phù hợp với luồng push/pop trên iPhone. Dùng NavigationStack(path:) khi route cần được khôi phục, deep link hoặc kiểm thử bằng dữ liệu. Path nên chứa enum Hashable có kiểu rõ ràng; NavigationPath hữu ích khi stack cần nhiều loại route type-erased, nhưng đừng chọn nó chỉ vì ngắn hơn.

Trên iPad hoặc giao diện nhiều cột, NavigationSplitView biểu diễn sidebar, danh sách và detail. Nó cho phép cùng một mô hình navigation thích ứng theo kích thước, thay vì bạn tự kiểm tra mọi breakpoint. sheet dành cho tác vụ bổ trợ có thể đóng; fullScreenCover dành cho flow cần chiếm toàn màn hình như onboarding hoặc xác thực. Đừng dùng modal để thay thế navigation hierarchy.

Async, identity và accessibility

Đặt tải dữ liệu trong .task khi tác vụ gắn với vòng đời View. SwiftUI sẽ hủy tác vụ khi View rời cây, nên API nên tôn trọng cancellation. Không gọi network, ghi database hoặc tạo timer trực tiếp trong body. Nếu tác vụ cần sống lâu hơn màn hình, đưa nó vào model hoặc một actor có ownership rõ ràng.

Identity quyết định SwiftUI giữ lại state của row nào. Dùng khóa ổn định từ dữ liệu máy chủ hoặc model; không dùng array index cho danh sách có thể chèn, xóa, sắp xếp. Khi ID đổi không cần thiết, row bị xem như View mới, animation và state nhập liệu có thể mất.

Accessibility không phải bước đánh bóng cuối cùng. Dùng Dynamic Type bằng các semantic font như .body và .title, không khóa mọi text vào kích thước cố định. Icon chỉ có nghĩa trang trí nên accessibilityHidden(true); icon là nút cần label và hint rõ ràng. Kiểm tra VoiceOver, contrast, Reduce Motion và kích thước chữ lớn trong Preview và simulator.

Liquid Glass: dùng có chủ đích

Trên iOS 26 trở lên, .glassEffect(.regular, in: .rect(cornerRadius: 16)) tạo bề mặt vật liệu phù hợp với hệ thống. GlassEffectContainer giúp nhóm các phần tử glass có quan hệ với nhau. Chỉ áp dụng cho một control nổi, thanh công cụ hoặc card cần tách khỏi nền; nếu mọi row đều là glass, độ tương phản và thứ bậc thị giác sẽ giảm. Ưu tiên button, material và màu hệ thống trước khi tự vẽ blur.

UIKit interop và các bẫy thường gặp

SwiftUI không loại bỏ UIKit. Camera picker, một số text editor phức tạp, SDK bên thứ ba hoặc màn hình cũ vẫn cần UIViewControllerRepresentable; custom view nhỏ dùng UIViewRepresentable. Ngược lại, bạn có thể nhúng SwiftUI vào UIKit bằng UIHostingController. Giữ ranh giới rõ: UIKit wrapper chuyển input/output, không nên trở thành nơi chứa toàn bộ state của SwiftUI.

  • Sai ownership: tạo lại observable model trong child khiến dữ liệu reset. Hãy khởi tạo ở owner lâu sống nhất và truyền xuống.
  • Lạm dụng AnyView: type erasure che cấu trúc và làm code khó tối ưu. Tách View hoặc dùng @ViewBuilder trước.
  • ID không ổn định: dùng index hoặc UUID mới trong body làm row mất state. Model phải có ID bền vững.
  • Side effect trong body: gọi API hoặc mutate state ở đây có thể lặp vô hạn. Dùng .task, action của Button hoặc layer model.
  • Nhầm thứ tự modifier: padding trước hay sau background tạo vùng nền khác nhau. Kiểm tra bằng preview và vùng tương tác.
  • Thiếu accessibility: một icon không có label, text bị cắt ở Dynamic Type hoặc contrast thấp đều là lỗi sản phẩm.
  • Mất navigation state: path đặt trong một View bị thay thế sẽ reset. Đưa path lên owner phù hợp và dùng route có kiểu.

Checklist thực hành và bước tiếp theo

  • Tạo một màn hình bằng VStack, HStack, Grid và List; thử Dynamic Type trước khi chốt frame.
  • Viết một model @Observable, xác định rõ owner, binding và dependency environment.
  • Đổi navigation tĩnh sang enum route với NavigationStack(path:); thử deep link và khôi phục path.
  • Thêm .task có cancellation, stable IDs và Preview với dữ liệu rỗng, dài, lỗi.
  • Kiểm tra VoiceOver, contrast, Reduce Motion; chỉ thêm Liquid Glass ở nơi có lý do thị giác.

Xem thêm declarative UI, animation SwiftUI, điều hướng UIKit và roadmap iOS. Đừng cố nhớ hàng trăm modifier; hãy xác định ownership, identity, side effect và accessibility.