إنشاء Bounce Animation في Flutter بمكون قابل لإعادة الاستخدام، مع فصل مدة الحركة عن تأخير البداية وإلغاء المؤقت واحترام تقليل الحركة.
التأخير ليس مدة الحركة
ضرب duration في قيمة اسمها delay يجعل الحركة أبطأ، ولا يؤخر بدايتها. المثال المصحح يفصل duration عن delay من نوع Duration، ويستخدم Timer لتأخير controller.forward. اختَر Curve تناسب النتيجة؛ easeInOutQuint تسارع وتباطؤ وليست ارتدادًا فعليًا مثل bounceOut. اشرح للمستخدم الفرق بين توقيت البداية وشكل المنحنى بدل تغيير الاسم فقط مع بقاء السلوك القديم.
مكون يملك موارده
يملك State في المثال AnimationController والمؤقت ويحررهما في dispose، فلا يبدأ forward بعد إغلاق الشاشة. لا تضع controller عامًا تشترك فيه كل نسخ المكون دون قصد. يقبل child جاهزًا ومدة وتأخيرًا، ويمكن استخدامه مع بطاقة أو زر دون تكرار كود الحركة. SlideTransition يحرك العنصر بنسبة من حجمه، لذلك Offset بقيمة 0.2 لا تعني عشرين بكسل على كل عنصر.
التفاعل وإتاحة الوصول
يحترم المثال MediaQuery.disableAnimations فيوصل العنصر إلى نهايته دون انتظار. لا تخف زرًا أساسيًا فترة طويلة ولا تجعل حركة دخول تتكرر كلما تغير عداد داخل البطاقة. استخدم مفاتيح مستقرة لعناصر القوائم، وحدد إن كانت الحركة لمرة دخول الشاشة أو لكل عنصر جديد. عندما تتغير خصائص المكون بعد بنائه لا يفترض المثال إعادة الدخول تلقائيًا؛ أعد إنشاؤه بمفتاح مناسب إذا كان ذلك سلوكك المقصود.
فحص الأداء والسلوك
اختبر تأخيرًا صفريًا وآخر قصيرًا وإغلاق الصفحة قبل انتهاء المؤقت، ثم تقليل الحركة وتغيير حجم child. استخدم AnimatedWidget وchild ثابتًا قدر الإمكان لتقليل عمل كل إطار. لا تدّع أن الحركة لا تؤثر على الأداء مطلقًا؛ الصور الكبيرة والقص والظلال وتكرار الحركات قد تزيد الحمل. قياس profile على جهاز مناسب يفيد أكثر من الحكم من محاكي Debug ببطاقة واحدة.
طريقة الاستخدام
أدرج BounceFromBottom داخل صفحة MaterialApp ثم مرر child وdelay وduration. المثال يعرف المكون كاملًا دون الاعتماد على أسماء classes مفقودة من مشروع خارجي. يمكن دمجه مع واجهة المطعم أو الرحلات، لكن لا تجمع أكثر من حركة على العنصر نفسه دون اختبار النتيجة. الأوامر أو الحزم الإضافية ليست مطلوبة لهذا المكون؛ يعتمد على Flutter وTimer فقط.
المثال البرمجي
ضع المكون داخل مشروع Flutter وصفحة مناسبة في MaterialApp. الكود التالي مثال مستقل للجزء المشروح، ولا يعتمد على ملفات تطبيق خارجي غير مرفقة. راجع المتطلبات المذكورة في النص، خاصة الخط والحزم في مثال PDF.
import 'dart:async';
import 'package:flutter/material.dart';
class BounceFromBottom extends StatefulWidget {
const BounceFromBottom({super.key, required this.child,
this.delay = Duration.zero, this.duration = const Duration(milliseconds: 450)});
final Widget child;
final Duration delay;
final Duration duration;
@override
State<BounceFromBottom> createState() => _BounceFromBottomState();
}
class _BounceFromBottomState extends State<BounceFromBottom>
with SingleTickerProviderStateMixin {
late final AnimationController _controller;
late final Animation<Offset> _position;
Timer? _timer;
bool _started = false;
@override
void initState() {
super.initState();
if (widget.delay.isNegative || widget.duration <= Duration.zero) {
throw ArgumentError('Delay must be nonnegative and duration positive');
}
_controller = AnimationController(vsync: this, duration: widget.duration);
_position = Tween(begin: const Offset(0, .2), end: Offset.zero)
.animate(CurvedAnimation(parent: _controller, curve: Curves.bounceOut));
}
@override
void didChangeDependencies() {
super.didChangeDependencies();
if (MediaQuery.disableAnimationsOf(context)) {
_timer?.cancel();
_controller.value = 1;
_started = true;
} else if (!_started) {
_started = true;
_timer = Timer(widget.delay, () {
if (mounted) _controller.forward();
});
}
}
@override
void didUpdateWidget(covariant BounceFromBottom oldWidget) {
super.didUpdateWidget(oldWidget);
_controller.duration = widget.duration;
}
@override
void dispose() {
_timer?.cancel();
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) => SlideTransition(
position: _position, child: widget.child,
);
}






