چرخه حیات StatefulWidget و کلاس State
StatefulWidget & State lifecycleبررسی گامبهگام متدهای چرخه حیات State در Flutter شامل createState، initState، didChangeDependencies، build، didUpdateWidget و dispose
فهرست مطالب این صفحه
درک دقیق چرخه حیات (Lifecycle) اشیای State در Flutter برای جلوگیری از نشت حافظه (Memory Leaks)، جلوگیری از فراخوانیهای تکراری API و مدیریت صحیح کنترلرها و انیمیشنها ضروری است.
ترتیب اجرای متدهای چرخه حیات State
هنگامی که یک StatefulWidget وارد درخت ویجتها میشود، فریمورک متدهای زیر را به ترتیب فراخوانی میکند:
createState(): بلافاصله پس از ساختStatefulWidgetفراخوانی میشود تا نمونهStateمتناظر ایجاد گردد.initState(): فقط یکبار در طول عمر شیءStateو پیش از اولین فراخوانیbuild()اجرا میشود.- محل مناسب برای مقداردهی اولیه متغیرها، ساخت
AnimationControllerیاTextEditingControllerو شروع گوش دادن به یکStream. - در این متد هنوز دسترسی به
InheritedWidgetهایی مانندTheme.of(context)یاMediaQuery.of(context)مجاز نیست.
- محل مناسب برای مقداردهی اولیه متغیرها، ساخت
didChangeDependencies(): بلافاصله پس ازinitState()و همچنین هر زمان که یکی از وابستگیهایInheritedWidgetکه این ویجت از آنها استفاده میکند تغییر کند فراخوانی میشود.build(BuildContext context): رابط کاربری ویجت را توصیف میکند و بارها در طول حیات ویجت فراخوانی میشود. باید کاملاً خالص (Pure) و بدون عوارض جانبی باشد.didUpdateWidget(covariant T oldWidget): هر زمان که ویجت والد بازسازی شود و پیکربندی جدیدی (پارامترهای سازنده جدید) به این ویجت ارسال کند فراخوانی میشود.setState(VoidCallback fn): به فریمورک اطلاع میدهد که وضعیت داخلی تغییر کرده است و باید متدbuild()دوباره اجرا شود.deactivate()وdispose(): هنگامی که ویجت برای همیشه از درخت حذف میشود، متدdispose()فراخوانی میگردد تا تمام منابع، کنترلرها و اشتراکهایStreamآزاد شوند.
مثال کامل پیادهسازی متدهای چرخه حیات
Dart
import 'dart:async';
import 'package:flutter/material.dart';
class TimerTrackerWidget extends StatefulWidget {
const TimerTrackerWidget({super.key, required this.label});
final String label;
@override
State<TimerTrackerWidget> createState() => _TimerTrackerWidgetState();
}
class _TimerTrackerWidgetState extends State<TimerTrackerWidget> {
late final TextEditingController _controller;
Timer? _timer;
int _secondsElapsed = 0;
@override
void initState() {
super.initState();
_controller = TextEditingController(text: widget.label);
_timer = Timer.periodic(const Duration(seconds: 1), (timer) {
if (!mounted) return;
setState(() {
_secondsElapsed++;
});
});
}
@override
void didUpdateWidget(covariant TimerTrackerWidget oldWidget) {
super.didUpdateWidget(oldWidget);
if (oldWidget.label != widget.label) {
_controller.text = widget.label;
}
}
@override
void dispose() {
_timer?.cancel();
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
mainAxisSize: MainAxisSize.min,
children: [
TextField(controller: _controller),
const SizedBox(height: 8),
Text('زمان سپریشده: $_secondsElapsed ثانیه'),
],
);
}
}
نکته حیاتی درباره
mounted: پیش از فراخوانیsetState()در پایان یک عملیات ناهمگام (await) یا تایمر، همیشه بررسی کنید که خاصیتmountedبرابرtrueباشد تا در صورت بسته شدن صفحه توسط کاربر، خطای فراخوانیsetState()روی ویجت حذفشده رخ ندهد.