Trong SwiftUI, một thay đổi state có thể làm cả giao diện nhảy sang trạng thái mới chỉ sau một lần render. Chuyển động SwiftUI không phải lớp trang trí thêm vào cuối dự án: dùng đúng, nó cho bạn biết điều gì vừa thay đổi, phần tử nào đang được liên kết và thao tác nào đã được ghi nhận. Dùng quá tay, nó che mất phản hồi thật, gây rối mắt và làm tăng chi phí layout.
Bài này cập nhật theo iOS 27.2 và Xcode 27.2. Bạn sẽ đi từ withAnimation, animation(value:) và transition đến các công cụ cho giao diện giàu trạng thái như PhaseAnimator, KeyframeAnimator, matchedGeometryEffect, symbol effects, scroll transitions và content transitions. Mục tiêu là chọn đúng công cụ cho đúng thay đổi, không phải biến mọi view thành một màn trình diễn.
Mục lục
Cập nhật 2026: bắt đầu từ state, không bắt đầu từ hiệu ứng
- Stack thực hành hiện tại là iOS 27.2, Xcode 27.2 và SwiftUI đi kèm SDK iOS 27. SwiftUI không có số phiên bản độc lập để pin.
.animation(_:value:)vẫn là lựa chọn có phạm vi rõ ràng; tránh modifier.animation()không theo dõi value.- SwiftUI có các công cụ chuyên biệt cho phase, keyframe, shared element, symbol, scroll và thay đổi nội dung. Chọn theo loại biến đổi thay vì gom tất cả vào một spring.
- Liquid Glass có từ iOS 26. Hãy dùng hệ thống glass và chuyển động tiết chế; đừng coi blur, phản chiếu hoặc haptic là bằng chứng duy nhất rằng một thao tác thành công.
Mô hình mental: state đổi, SwiftUI nội suy phần có thể animate
SwiftUI dựng lại mô tả view khi state thay đổi rồi so sánh trạng thái cũ và mới. Nếu một thuộc tính như opacity, offset, scale, màu hoặc kích thước có thể nội suy, một animation sẽ tạo ra các giá trị trung gian. Transition thì khác: nó mô tả cách một view được thêm vào hoặc gỡ khỏi hierarchy. Vì vậy, một view đang tồn tại cần animation; một view xuất hiện hoặc biến mất cần transition, thường được kích hoạt cùng withAnimation.
Hãy tách ba lớp khi thiết kế: state trả lời “đang ở trạng thái nào”, identity trả lời “đây có phải cùng một phần tử không”, còn animation trả lời “đi giữa hai trạng thái bằng nhịp nào”. Nếu dùng animation để bù cho state mơ hồ hoặc ID không ổn định, lỗi sẽ xuất hiện dưới dạng view nhấp nháy, teleport hoặc transition sai phần tử.
withAnimation và animation(value:)
Dùng withAnimation khi một hành động của người dùng làm nhiều phần giao diện đổi cùng lúc. Bạn đặt việc thay đổi state vào trong closure; SwiftUI truyền transaction animation đến các view bị ảnh hưởng. Có thể chọn spring cho tương tác vật lý hoặc timing curve cho chuyển cảnh có nhịp cố định.
struct FavoriteButton: View {
@State private var isFavorite = false
var body: some View {
Button {
withAnimation(.spring(response: 0.32, dampingFraction: 0.78)) {
isFavorite.toggle()
}
} label: {
Label(isFavorite ? "Đã lưu" : "Lưu", systemImage: "bookmark")
.symbolEffect(.bounce, value: isFavorite)
}
.buttonStyle(.borderedProminent)
}
}
Ngược lại, .animation(_:value:) thích hợp khi chỉ một nhánh view cần phản ứng với một giá trị cụ thể. Đặt modifier gần thuộc tính cần animate và chọn value hẹp nhất có thể. Ví dụ, theo dõi isExpanded cho chiều cao của một card, thay vì đặt animation lên cả màn hình nơi nhiều state khác cũng thay đổi.
VStack(alignment: .leading, spacing: 12) {
Text(title)
.font(.headline)
if isExpanded {
Text(summary)
.transition(.opacity.combined(with: .move(edge: .top)))
}
}
.animation(.easeInOut(duration: 0.25), value: isExpanded)
withAnimation(.timingCurve(0.2, 0.8, 0.2, 1.0, duration: 0.45)) {
isExpanded.toggle()
}
Transition và tương đương AnimatedContent trong SwiftUI
SwiftUI không có một API tên AnimatedContent tương đương trực tiếp. Mẫu tương đương là một nhánh điều kiện với identity ổn định, gắn .transition, rồi thay đổi state trong withAnimation. Dùng .asymmetric khi hướng vào và hướng ra cần nhịp khác nhau; dùng AnyTransition khi muốn đóng gói transition để tái sử dụng.
private var cardTransition: AnyTransition {
.asymmetric(
insertion: .opacity.combined(with: .move(edge: .bottom)),
removal: .opacity.combined(with: .scale(scale: 0.96))
)
}
if showDetails {
DetailsView()
.transition(cardTransition)
}
// Khi đóng/mở:
withAnimation(.spring(response: 0.38, dampingFraction: 0.86)) {
showDetails.toggle()
}
Nếu chỉ nội dung trong cùng một view thay đổi, không nhất thiết phải xóa view và tạo view mới. .contentTransition(.opacity) hoặc .contentTransition(.numericText()) phù hợp cho text, số và biểu tượng có cùng vị trí. Mẫu này tránh làm mất focus hoặc accessibility focus không cần thiết. Nếu hai trạng thái có bố cục khác hẳn, hãy dùng conditional branches và transition; nếu là cùng một object đổi container, cân nhắc matched geometry.
Expandable card với ID ổn định
Một expandable card tốt có một state tối giản: ID card đang mở, hoặc một Boolean cục bộ nếu màn hình chỉ có một card. Với danh sách, model phải có ID ổn định; không dùng index làm identity nếu thứ tự có thể đổi. Khi SwiftUI nhận đúng cùng một card trước và sau thao tác, nó có thể giữ state cục bộ, animation và accessibility context.
struct RoadmapCard: Identifiable {
let id: UUID
let title: String
let detail: String
}
struct ExpandableCards: View {
let cards: [RoadmapCard]
@State private var expandedID: RoadmapCard.ID?
var body: some View {
LazyVStack(spacing: 12) {
ForEach(cards) { card in
VStack(alignment: .leading, spacing: 8) {
HStack {
Text(card.title).font(.headline)
Spacer()
Image(systemName: "chevron.down")
.rotationEffect(.degrees(expandedID == card.id ? 180 : 0))
}
if expandedID == card.id {
Text(card.detail)
.contentTransition(.opacity)
.transition(.opacity.combined(with: .move(edge: .top)))
}
}
.padding()
.background(.thinMaterial, in: .rect(cornerRadius: 16))
.contentShape(Rectangle())
.onTapGesture {
withAnimation(.spring(response: 0.34, dampingFraction: 0.82)) {
expandedID = expandedID == card.id ? nil : card.id
}
}
}
}
.padding()
}
}
matchedGeometryEffect: nối hai bố cục thành một câu chuyện
matchedGeometryEffect phù hợp khi cùng một thành phần chuyển từ thumbnail sang card lớn, từ tab bar sang header hoặc từ grid sang detail. Hai view dùng cùng namespace và ID trong các nhánh trạng thái khác nhau. ID phải duy nhất trong namespace tại thời điểm chuyển; nếu có hai phần tử cùng ID, kết quả là không xác định.
struct ExpandableCard: View {
let card: RoadmapCard
@Namespace private var cardNamespace
@State private var isExpanded = false
var body: some View {
ZStack {
if isExpanded {
VStack(alignment: .leading, spacing: 16) {
Text(card.title).font(.title2.bold())
Text(card.detail)
Spacer()
}
.padding(24)
.frame(maxWidth: .infinity, maxHeight: .infinity)
.background(.regularMaterial, in: .rect(cornerRadius: 24))
.matchedGeometryEffect(id: "surface-\(card.id)", in: cardNamespace)
.onTapGesture { close() }
} else {
VStack(alignment: .leading, spacing: 8) {
Text(card.title).font(.headline)
Text("Chạm để mở")
.font(.caption)
.foregroundStyle(.secondary)
}
.padding(16)
.frame(maxWidth: .infinity, alignment: .leading)
.background(.thinMaterial, in: .rect(cornerRadius: 16))
.matchedGeometryEffect(id: "surface-\(card.id)", in: cardNamespace)
.onTapGesture { open() }
}
}
}
private func open() {
withAnimation(.spring(response: 0.42, dampingFraction: 0.86)) {
isExpanded = true
}
}
private func close() {
withAnimation(.spring(response: 0.42, dampingFraction: 0.86)) {
isExpanded = false
}
}
}
Trong danh sách thật, namespace nên ở view sở hữu màn hình và ID kết hợp từ ID model, không phải vị trí mảng. Hạn chế thay đổi layout cha trong cùng transaction nếu không cần, vì matched geometry chỉ có thể nội suy tốt khi điểm đầu và điểm cuối đo được rõ ràng.
Phase, keyframe, symbol và scroll transitions
PhaseAnimator phù hợp chuỗi trạng thái lặp theo phase, chẳng hạn icon tải gồm ba bước scale và opacity. KeyframeAnimator phù hợp một timeline nhiều đoạn khi bạn cần kiểm soát từng thuộc tính theo thời gian. Đây là công cụ cho choreography, không phải lý do để biến mọi loading indicator thành animation vô hạn.
Image(systemName: "arrow.triangle.2.circlepath")
.phaseAnimator([false, true]) { content, phase in
content
.scaleEffect(phase ? 1.12 : 0.92)
.opacity(phase ? 1.0 : 0.55)
} animation: { _ in
.easeInOut(duration: 0.7)
}
Symbol effects như .bounce, .pulse hoặc .scale nên diễn đạt một sự kiện nhỏ: lưu thành công, có thông báo mới hoặc nút vừa được chọn. Chúng bổ sung chứ không thay thế label, màu trạng thái, VoiceOver hoặc haptic phù hợp. Với danh sách cuộn, .scrollTransition cho phép làm mờ hoặc scale nhẹ item khi đi vào và ra khỏi viewport; giữ biên độ nhỏ để việc đọc vẫn ổn định.
ScrollView {
LazyVStack(spacing: 16) {
ForEach(cards) { card in
CardRow(card: card)
.scrollTransition(.animated(.easeOut(duration: 0.25))) { view, phase in
view
.opacity(phase.isIdentity ? 1 : 0.7)
.scaleEffect(phase.isIdentity ? 1 : 0.96)
}
}
}
}
Liquid Glass, haptic và phản hồi đa kênh
Trên iOS 27.2, nếu app hỗ trợ iOS 26 trở lên, bạn có thể dùng system Liquid Glass như .glassEffect(.regular, in: .rect(cornerRadius: 16)) và GlassEffectContainer cho nhóm phần tử liên quan. Chuyển động nên cho thấy quan hệ giữa các control và nội dung; đừng animate blur, highlight và độ trong suốt liên tục chỉ để tạo cảm giác “premium”.
Haptic cũng cần có chủ đích. Một tap xác nhận hoặc hoàn tất có thể đi cùng feedback nhẹ, nhưng thao tác kéo liên tục không nên phát haptic ở mọi frame. Luôn cung cấp tín hiệu trực quan và accessibility label; người tắt âm thanh, dùng VoiceOver hoặc không cảm nhận haptic vẫn phải hiểu kết quả.
Completion, Reduce Motion và các pitfall khó thấy
Animation là cách trình bày thay đổi, không phải nơi đặt business logic. withAnimation trả quyền điều khiển cho code ngay sau khi state đổi; đừng giả định closure kết thúc nghĩa là pixel cuối đã hiển thị. Nếu cần biết một state machine đã vào trạng thái mới, quan sát state bằng onChange hoặc phát sự kiện hoàn tất từ model. Với hiệu ứng thuần trình bày, có thể dùng thời lượng đã biết để điều phối, nhưng tránh dùng timer làm nguồn sự thật.
Kiểm tra Environment accessibilityReduceMotion và giảm quãng đường, bỏ spring, hoặc thay bằng fade khi người dùng bật Reduce Motion. “Tắt animation” không đồng nghĩa bỏ feedback: vẫn giữ thay đổi nội dung, focus, màu trạng thái và nhãn rõ ràng. Test cả Dynamic Type, VoiceOver, Reduce Motion và Reduce Transparency trên thiết bị thật.
- Animate mọi state: sửa bằng cách chỉ animate thay đổi giúp người dùng hiểu quan hệ nhân quả.
- Identity không ổn định: dùng model ID lâu dài, không dùng array index hoặc UUID tạo lại mỗi lần render.
- Layout quá lớn: đo Instruments và thử thiết bị thật; ưu tiên opacity, transform và drawing nhẹ khi phù hợp, tránh tính lại cả cây layout mỗi frame.
- Animation vô hạn: dừng khi view không còn visible, tôn trọng Reduce Motion và tránh giữ CPU/GPU hoạt động khi app không cần.
- Chóng mặt hoặc xung đột gesture: giảm parallax, tránh nhiều gesture cạnh tranh trong một card và xác định rõ vùng tap, drag, scroll.
- Animation là feedback duy nhất: thêm text, icon, màu, accessibility announcement hoặc trạng thái disabled tùy tình huống.
Layout, drawing và hiệu năng
Không phải animation nào cũng có chi phí như nhau. Thay đổi opacity hoặc transform thường dễ tối ưu hơn việc liên tục đổi kích thước làm toàn bộ parent layout lại. Tuy nhiên, đừng suy đoán từ tên modifier: hãy bật Animation Hitches trong Instruments, kiểm tra render loop, số view con và việc decode ảnh trong lúc chuyển cảnh. Lazy container giúp giới hạn nội dung, nhưng không biến một layout nặng thành miễn phí.
Animation kéo theo gesture cần dùng giá trị liên tục của gesture để phản hồi trực tiếp, rồi “settle” về trạng thái cuối bằng spring khi nhả tay. Đừng bọc mọi thay đổi trong withAnimation trong onChanged; điều đó có thể tạo cảm giác trễ và tranh chấp với ScrollView. Hãy để drag cập nhật offset tạm thời, còn onEnded quyết định state bền vững.
Chọn công cụ nào?
| Nhu cầu | Công cụ | Lưu ý |
|---|---|---|
| Đổi thuộc tính sau một action | withAnimation |
Phạm vi rộng, dễ phối với state machine. |
| Một view theo dõi một value | animation(_:value:) |
Đặt gần thuộc tính cần animate. |
| Thêm hoặc gỡ view | AnyTransition |
Cần identity và transaction đúng. |
| Đổi text, số, symbol cùng vị trí | contentTransition |
Không cần tạo lại cả layout. |
| Cùng phần tử qua hai container | matchedGeometryEffect |
ID duy nhất, namespace ổn định. |
| Chuỗi phase hoặc timeline | PhaseAnimator / KeyframeAnimator |
Dùng có mục đích, tránh loop không cần. |
| Item đi qua viewport | scrollTransition |
Giữ scale và opacity vừa phải. |
Thực hành và nối với lộ trình iOS
Bạn nên nắm state, identity và modifier trước khi viết choreography. Nếu cần ôn mô hình declarative và cách SwiftUI phản ánh state, xem lại bài về Declarative UI với SwiftUI. Các view, modifier và điều hướng cơ bản là nền của mọi ví dụ trong bài; phần đó nằm ở bài SwiftUI cơ bản.
Để quyết định motion có phục vụ HIG hay không, đối chiếu với bài về Human Interface Guidelines. Và nếu bạn muốn đặt kỹ năng này trong thứ tự học lớn hơn, roadmap iOS Developer giúp nối animation với architecture, testing và phát hành.
Checklist trước khi gửi code review
- State chuyển động có tên rõ ràng và identity có ổn định không?
- Bạn đã chọn đúng giữa property animation, transition, content transition và matched geometry chưa?
- Animation có truyền thông tin, phản hồi thao tác hoặc giữ ngữ cảnh không?
- Đã kiểm tra Reduce Motion, VoiceOver, Dynamic Type, gesture conflict và thiết bị hiệu năng thấp chưa?
- Đã đo hitch/layout/drawing thay vì chỉ nhìn Simulator chưa?
- Motion có dừng đúng lúc, không lặp vô hạn và không thay thế feedback văn bản hoặc accessibility không?
Triển vọng tiếp theo là motion có ngữ cảnh: state rõ, identity bền, phản hồi đa kênh và hiệu năng đo được. Những nguyên tắc này giúp thiết kế thích nghi với thiết bị, cài đặt trợ năng và các bản SDK sau.



