사용자 정의 AnimatableModifier와 Animatable
Animatable과 AnimatableModifier를 준수해 직접 그린 콘텐츠에 애니메이션을 적용합니다.
사용자 정의 AnimatableModifier와 Animatable은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
Animatable 프로토콜
Animatable은 애니메이션 중에 형식을 어떻게 보간할지 SwiftUI에 알려 줍니다. 셰이프는 자동으로 이 프로토콜을 준수합니다.
struct Wave: Shape, Animatable {
var amplitude: Double
var animatableData: Double {
get { amplitude }
set { amplitude = newValue }
}
func path(in rect: CGRect) -> Path { Path() }
}animatableData 속성
SwiftUI는 각 애니메이션 프레임에서 animatableData를 읽고 써서 시작 값과 끝 값 사이를 보간합니다.
struct GrowingCircle: Shape {
var radius: Double
var animatableData: Double {
get { radius }
set { radius = newValue }
}
func path(in rect: CGRect) -> Path {
Path(ellipseIn: CGRect(x: rect.midX-radius, y: rect.midY-radius, width: radius*2, height: radius*2))
}
}여러 값에 AnimatablePair 사용하기
서로 독립적인 두 값을 동시에 애니메이션하려면 AnimatablePair를 사용하세요.
struct Sector: Shape {
var startAngle: Double, endAngle: Double
var animatableData: AnimatablePair<Double, Double> {
get { AnimatablePair(startAngle, endAngle) }
set { startAngle = newValue.first; endAngle = newValue.second }
}
func path(in rect: CGRect) -> Path { Path() }
}ViewModifier + Animatable
ViewModifier가 Animatable을 준수하도록 하면 임의의 시각 효과를 애니메이션할 수 있습니다.
struct Shake: ViewModifier, Animatable {
var animatableData: Double = 0
func body(content: Content) -> some View {
content.offset(x: sin(animatableData * .pi * 4) * 8)
}
}애니메이션 구동하기
withAnimation 안에서 애니메이션 가능한 값을 변경하면 SwiftUI가 animatableData를 통해 보간합니다.
struct ShakeView: View {
@State private var shakes = 0.0
var body: some View {
Text("Hello")
.modifier(Shake(animatableData: shakes))
.onTapGesture {
withAnimation(.linear(duration: 0.5)) { shakes += 1 }
}
}
}사용 중단된 AnimatableModifier와 Animatable + ViewModifier 비교
AnimatableModifier는 이후 SDK에서 사용이 중단되었습니다. 대신 ViewModifier가 직접 Animatable을 준수하도록 하세요.
// Modern approach:
struct MyMod: ViewModifier, Animatable { ... }
// Avoid (deprecated):
// struct MyMod: AnimatableModifier { ... }사용자 지정 숫자 형식을 animatableData로 사용하기
VectorArithmetic을 준수하는 모든 형식을 animatableData로 사용할 수 있습니다. Swift의 CGFloat, Double, AnimatablePair가 모두 이에 해당합니다.
extension MyColor: VectorArithmetic {
static func += (lhs: inout MyColor, rhs: MyColor) { ... }
mutating func scale(by rhs: Double) { ... }
var magnitudeSquared: Double { ... }
}진행률 기반 수정자
일반적인 패턴은 progress 값을 0에서 1까지 애니메이션하고 수정자 내부에서 시각적 속성을 계산하는 것입니다.
struct FillModifier: ViewModifier, Animatable {
var progress: Double
var animatableData: Double { get { progress } set { progress = newValue } }
func body(content: Content) -> some View {
content.overlay(Color.blue.opacity(progress))
}
}.animation으로 연결하기
애니메이션을 연결하면 상태가 변경될 때 애니메이션 가능한 수정자의 progress 값이 자동으로 변경됩니다.
Text("Loading")
.modifier(FillModifier(progress: isLoaded ? 1 : 0))
.animation(.easeInOut(duration: 1.0), value: isLoaded)사용자 지정 셰이프 애니메이션
가장 강력한 활용 방법은 animatableData를 통해 제어점을 보간하여 두 경로 셰이프 사이를 변형하는 것입니다.
struct Blob: Shape, Animatable {
var bulge: Double
var animatableData: Double { get { bulge } set { bulge = newValue } }
func path(in rect: CGRect) -> Path {
// compute bezier with bulge-adjusted control points
Path()
}
}성능
SwiftUI는 모든 애니메이션 프레임에서 수정자의 body를 호출합니다. 부드러운 60/120fps를 유지하려면 body 내부의 계산을 최소화하세요.
// OK: simple math in body
// AVOID: network calls, heavy computation in animated body빠른 확인
사용자 지정 애니메이션 가능 형식을 보간하기 위해 SwiftUI가 모든 애니메이션 프레임에서 읽고 쓰는 것은 무엇인가요?
강의 요약
셰이프나 뷰 수정자가 Animatable을 준수하도록 하고 VectorArithmetic 값인 animatableData를 노출하세요. SwiftUI가 매 프레임 이를 보간합니다. 두 값에는 AnimatablePair를 사용하세요. withAnimation 또는 .animation으로 구동하세요.
자주 묻는 질문
“사용자 정의 AnimatableModifier와 Animatable” 강의는 무료인가요?
네 — “사용자 정의 AnimatableModifier와 Animatable” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“사용자 정의 AnimatableModifier와 Animatable”에서 뭘 배우나요?
Animatable과 AnimatableModifier를 준수해 직접 그린 콘텐츠에 애니메이션을 적용합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Swift Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“사용자 정의 AnimatableModifier와 Animatable” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 암시적 애니메이션과 명시적 애니메이션
- Hero 전환을 위한 matchedGeometryEffect
- 사용자 정의 AnimatableModifier와 Animatable
- 고성능 그리기를 위한 TimelineView와 Canvas