مقدمه انیمیشن‌ها: انیمیشن‌های ضمنی (Implicit) و صریح (Explicit)

Introduction to animations

آشنایی جامع با سیستم انیمیشن در Flutter، تفاوت AnimatedContainer و AnimationController و انتخاب روش مناسب

فهرست مطالب این صفحه

در Flutter ساخت انیمیشن‌های روان و با نرخ فریم بالا بسیار ساده است. مستندات رسمی فلاتر انیمیشن‌ها را به دو دسته اصلی تقسیم می‌کند: انیمیشن‌های ضمنی (Implicit) و انیمیشن‌های صریح (Explicit).

۱. انیمیشن‌های ضمنی (Implicit Animations)

ویجت‌هایی که نام آن‌ها با Animated آغاز می‌شود (مانند AnimatedContainer، AnimatedOpacity و AnimatedAlign) به‌طور خودکار تغییر مقادیر را در طول یک بازه زمانی (Duration) انیمیت می‌کنند؛ بدون آنکه نیازی به مدیریت AnimationController داشته باشید:

Dart
import 'package:flutter/material.dart';

class ExpandingBoxDemo extends StatefulWidget {
  const ExpandingBoxDemo({super.key});

  @override
  State<ExpandingBoxDemo> createState() => _ExpandingBoxDemoState();
}

class _ExpandingBoxDemoState extends State<ExpandingBoxDemo> {
  bool _isExpanded = false;

  @override
  Widget build(BuildContext context) {
    return GestureDetector(
      onTap: () {
        setState(() {
          _isExpanded = !_isExpanded;
        });
      },
      child: AnimatedContainer(
        duration: const Duration(milliseconds: 350),
        curve: Curves.easeInOut,
        width: _isExpanded ? 240 : 120,
        height: _isExpanded ? 140 : 80,
        decoration: BoxDecoration(
          color: _isExpanded ? const Color(0xFF027DFD) : const Color(0xFF0553B1),
          borderRadius: BorderRadius.circular(_isExpanded ? 24 : 10),
        ),
        alignment: Alignment.center,
        child: const Text(
          'لمس کنید',
          style: TextStyle(color: Colors.white, fontWeight: FontWeight.bold),
        ),
      ),
    );
  }
}

۲. انیمیشن‌های صریح (Explicit Animations)

هنگامی که به کنترل کامل روی انیمیشن نیاز دارید (مانند تکرار بی‌نهایت، توقف، معکوس کردن حرکت یا هماهنگ کردن چند انیمیشن هم‌زمان)، از AnimationController همراه با SingleTickerProviderStateMixin استفاده می‌کنید:

Dart
class PulseBadge extends StatefulWidget {
  const PulseBadge({super.key});

  @override
  State<PulseBadge> createState() => _PulseBadgeState();
}

class _PulseBadgeState extends State<PulseBadge>
    with SingleTickerProviderStateMixin {
  late final AnimationController _controller;
  late final Animation<double> _scaleAnimation;

  @override
  void initState() {
    super.initState();
    _controller = AnimationController(
      vsync: this,
      duration: const Duration(milliseconds: 900),
    )..repeat(reverse: true);

    _scaleAnimation = Tween<double>(begin: 0.92, end: 1.08).animate(
      CurvedAnimation(parent: _controller, curve: Curves.easeInOut),
    );
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return ScaleTransition(
      scale: _scaleAnimation,
      child: const Icon(Icons.favorite, color: Colors.red, size: 48),
    );
  }
}