0Pricing
Swift Academy · 강의

사용자 정의 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 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 암시적 애니메이션과 명시적 애니메이션
  2. Hero 전환을 위한 matchedGeometryEffect
  3. 사용자 정의 AnimatableModifier와 Animatable
  4. 고성능 그리기를 위한 TimelineView와 Canvas
← Swift Academy(으)로 돌아가기