dot-skills — Airbnb iOS SwiftUI アニメーション ベストプラクティス
iOS 26 / Swift 6.2 の SwiftUI アプリ向けの、意見が反映された厳格なアニメーション作成ガイド。8 つのカテゴリにわたる 50 のルールを含み、影響度で優先順位付けされています。Airbnb Engineering のモーションパターン、Apple WWDC セッション、および Apple Human Interface Guidelines から導出されています。すべてのアニメーションビューに @Equatable、すべてのスプリング/タイミング値にモーショントークン、レイアウトにデザインシステムトークンの使用を必須とします。
必須アーキテクチャの整合性
このスキルは swift-ui-architect および ios-design-system と連携するように設計されています。すべてのコード例は、以下の譲歩できない制約に従います。
- すべてのビューに
@Equatableマクロ(Airbnb は 15% のスクロールヒッチ低減を測定) - ビジネスロジックトリガーを含む複雑なアニメーション状態には
@Observable - ビュー所有のアニメーション状態(トグルブール値、ドラッグオフセット)には
@State - デザインシステムトークン:
Spacing.xs/sm/md/lg、Radius.sm/md/lg— ハードコードされたレイアウト数値はゼロ - モーショントークン:
Motion.standard/responsive/playful— 散在するスプリングリテラルはゼロ - セマンティックカラー:
.backgroundSurface、.accentPrimary— ビュー内に生の Color リテラルはなし - 機能アニメーションはプレゼンテーション専用。データ/ネットワーク関連は Data パッケージに残す
範囲と兄弟スキルとの関係
このスキルはモーション層です — 流動的でパフォーマンスの高いアニメーションを構築する方法を教えます。兄弟スキルと一緒にロードされた場合:
| 兄弟スキル | その焦点 | このスキルの焦点 |
|---|---|---|
swift-ui-architect | アーキテクチャ (モジュラーMVVM-C、ルートシェル、プロトコル境界) | アニメーションアーキテクチャ (モーショントークン、スプリング選択、オーケストレーション) |
ios-design-system | デザインシステムの基盤 (トークン、スタイル、ガバナンス) | モーショントークンとアニメーションコンポーネントパターン |
ios-hig | HIG準拠パターン | モーション固有のHIG (動きの低減、空間連続性) |
範囲外: デザイナー作成のベクターアニメーション (Lottie を参照)。複雑な UIKit トランジションコントローラ (Airbnb の宣言的トランジションフレームワーク を参照)。このスキルはプログラムによる SwiftUI アニメーションのみをカバーします。
クリニック アーキテクチャ契約 (iOS 26 / Swift 6.2)
このスキルのすべてのガイダンスは、クリニックモジュラーMVVM-Cアーキテクチャを前提としています:
- フィーチャーモジュールは
Domain+DesignSystemのみをインポート (Dataや兄弟フィーチャーは不可) - アプリターゲットが収束点であり、
DependencyContainer、具象コーディネーター、およびルートシェル配線を所有 DomainはピュアSwiftのままで、モデルとリポジトリ、*Coordinating、ErrorRouting、AppErrorコントラクトを定義Dataは SwiftData/ネットワーク/同期/リトライ/バックグラウンドI/Oを所有し、Domain プロトコルを実装- 読み取り/書き込みフローはデフォルトで stale-while-revalidate 読み取りと楽観的キュー書き込み
- ViewModel はリポジトリプロトコルを直接呼び出す (デフォルトの use-case/interactor 層なし)
適用タイミング
以下の場合にこれらのガイドラインを参照してください:
- SwiftUI ビューまたはトランジションにアニメーションを追加するとき
- ジェスチャ駆動のインタラクション (ドラッグ、スワイプ、パン) を構築するとき
- 空間トランジション (展開/折りたたみ、ナビゲーションモーフ) でビューを接続するとき
- マイクロインタラクション (ボタン押下、トグル、ローディング状態) を設計するとき
- コンテンツ変更を物理的に感じさせる (数字のロール、シンボル置換) とき
- マルチエレメントアニメーションシーケンス (KeyframeAnimator、PhaseAnimator) を振り付けるとき
- デザインシステムのモーショントークンを定義するとき
- アニメーションコードをパフォーマンス、アクセシビリティ、アーキテクチャ準拠についてレビューするとき
優先順位別ルールカテゴリ
| 優先順位 | カテゴリ | 影響 | プレフィックス | ルール数 |
|---|---|---|---|---|
| 1 | スプリング物理 | 致命的 | spring- | 8 |
| 2 | タイミングと感触 | 致命的 | feel- | 6 |
| 3 | ジェスチャ連続性 | 高 | gesture- | 7 |
| 4 | 空間トランジション | 高 | spatial- | 6 |
| 5 | マイクロインタラクション | 高 | micro- | 6 |
| 6 | オーケストレーション | 高 | orch- | 5 |
| 7 | クラフトと洗練 | 高 | craft- | 5 |
| 8 | コンテンツモーション | 中高 | content- | 5 |
クイックリファレンス
1. スプリング物理 (致命的)
spring-motion-tokens— モーショントークンを caseless enum として定義し、すべてのスプリングプリセットを管理spring-smooth-default— すべての UI トランジションにデフォルトで .smooth スプリングを使用spring-snappy-responsive— レスポンシブなインタラクションに .snappy スプリングを使用spring-bouncy-celebration— 遊び心とお祝いの瞬間に .bouncy スプリングを使用spring-custom-parameters— response と dampingFraction でカスタムスプリングを調整spring-velocity-preservation— スプリングは割り込み時に速度を保持spring-never-linear— インタラクティブ UI には linear または easeInOut を使用しないspring-completion-chaining— チェーンシーケンスには withAnimation の完了を使用
2. タイミングと感触 (致命的)
feel-250ms-max— UI アニメーションを 250ms 未満に保つfeel-faster-better— 速いアニメーションはほとんどの場合、感触が良いfeel-asymmetric-enter-exit— 進入と退出に非対称なタイミングを使用feel-distance-proportional— 持続時間を移動距離に合わせるfeel-haptic-sync— 触覚フィードバックを視覚アニメーションのキーフレームに同期feel-stagger-timing— 30~50ms 間隔で表示をずらす
3. ジェスチャ連続性 (高)
gesture-rubber-band— ドラッグ境界でラバーバンドgesture-momentum-dismiss— 速度または距離のしきい値で閉じるgesture-snap-points— 速度を認識するスナップポイントを使用gesture-interruptible— すべてのジェスチャアニメーションを割り込み可能にするgesture-scroll-drag-conflict— スクロールとドラッグのジェスチャ競合を解決gesture-state-transient— 一時的なドラッグ状態に GestureState を使用gesture-projected-landing— ジェスチャ速度を投影して自然な着地位置を計算
4. 空間トランジション (高)
spatial-matched-geometry— 展開/折りたたみモーフに matchedGeometryEffect を使用spatial-zoom-navigation— コレクション詳細にズームナビゲーショントランジションを使用 (iOS 18)spatial-transition-origin— トランジションをトリガー位置に固定spatial-hero-shared-element— 複数の要素 ID を共有してリッチなヒーローアニメーションを実現spatial-sheet-morph— シート表示に matchedGeometryEffect を使用spatial-tab-continuity— タブトランジションで空間方向を維持
5. マイクロインタラクション (高)
micro-button-press-scale— 押下時にボタンを 0.97 にスケーリングし触覚フィードバックを提供micro-haptic-pairing— すべての視覚状態変更に触覚フィードバックをペアリングmicro-symbol-effect— SF シンボルアニメーションに symbolEffect を使用micro-toggle-bounce— トグル状態変更にバウンスを追加micro-long-press-fill— 長押しアクションにプログレッシブフィルをアニメーションmicro-loading-phase— 有機的なローディング状態に繰り返しスプリングを使用
6. オーケストレーション (高)
orch-phase-animator— マルチステップシーケンスに PhaseAnimator を使用orch-keyframe-animator— タイムライン精度のモーションに KeyframeAnimator を使用orch-stagger-children— 子要素をずらしてオーケストレーションされた表示を実現orch-coordinated-entrance— 共有トリガーでマルチエレメントの進入を調整orch-timeline-view— 連続繰り返しアニメーションに TimelineView を使用
7. クラフトと洗練 (高)
craft-reduce-motion— accessibilityReduceMotion を尊重し、クロスフェードフォールバックを使用craft-blur-bridge— ぼかしを使用して不完全なトランジション状態を橋渡しcraft-drawing-group— Metal バックエンドの複雑なアニメーションに drawingGroup() を使用craft-geometry-group— geometryGroup() を使用してレイアウトアニメーションの伝播を分離craft-transaction-debug— Transaction を使用してアニメーション動作をデバッグおよびオーバーライド
8. コンテンツモーション (中高)
content-numeric-text— 数値変更に contentTransition(.numericText) を使用content-scroll-transition— スクロール位置効果に scrollTransition を使用content-visual-effect— 位置認識アニメーションに visualEffect を使用content-symbol-replace— contentTransition でシンボル置換をアニメーションcontent-text-renderer— 文字レベルアニメーションに Text Renderer を使用 (iOS 18)
使用方法
各リファレンスファイルを読んで、間違った例/正しい例を含む詳細な説明を確認してください:
リファレンスファイル
| ファイル | 説明 |
|---|---|
| references/_sections.md | カテゴリ定義と順序 |
| assets/templates/_template.md | 新しいルール用テンプレート |
| metadata.json | バージョンとリファレンス情報 |