⚡️⚡️Flutter Key⚡️⚡️
5⃣
تقسیم بندی انواع key ها در فلاتر
✔️اون هایی که رنگ مشکی دارن abstract هستن و بقیه کلاس های معمولی هستن .
✔️اون هایی که با <T> مشخص شدن Generic هستن.
#key #local_key
#flutter_key #flutter_key
#value_key #object_key #unique_key
5⃣
تقسیم بندی انواع key ها در فلاتر
✔️اون هایی که رنگ مشکی دارن abstract هستن و بقیه کلاس های معمولی هستن .
✔️اون هایی که با <T> مشخص شدن Generic هستن.
#key #local_key
#flutter_key #flutter_key
#value_key #object_key #unique_key
⚡️⚡️Flutter Key⚡️⚡️
6️⃣ GlobalKey
در مورد GlobalKey ها باید بگیم ک:
✔️جنریک هستن و موقع نمونه سازی میتونیم واسشون یه Generic type مشخص کنیم. این Generic type باید از جنس State باشه.
درواقع اگه بخوایم GlobalKey رو به یه StatefulWidget اختصاص بدیم میتونیم براش type مشخص کنیم.
var key = GlobalKey<ScaffoldState>() ;
ویجت Scaffold یه StatefulWidget هست.
اگرم بخوایم به یه StatelessWidget یا... بدیمش هم میتونیم type مشخص نکنیم.
✔️یه پروپرتی (getter) به اسم currentContext دارن. (nullable)
✔️یه پروپرتی (getter) به اسم currentWidget دارن. (nullable)
✔️و یه پروپرتی هم به اسم currentState که type اش برابر type ای هست که برای GlobalKey مشخص کردیم.
گه اگه به ویجتی غیر از Stateful اختصاص بدیم این مقدار null برمیگردونه.
#key
#flutter_key
#local_key
#global_key
6️⃣ GlobalKey
در مورد GlobalKey ها باید بگیم ک:
✔️جنریک هستن و موقع نمونه سازی میتونیم واسشون یه Generic type مشخص کنیم. این Generic type باید از جنس State باشه.
درواقع اگه بخوایم GlobalKey رو به یه StatefulWidget اختصاص بدیم میتونیم براش type مشخص کنیم.
var key = GlobalKey<ScaffoldState>() ;
ویجت Scaffold یه StatefulWidget هست.
اگرم بخوایم به یه StatelessWidget یا... بدیمش هم میتونیم type مشخص نکنیم.
✔️یه پروپرتی (getter) به اسم currentContext دارن. (nullable)
✔️یه پروپرتی (getter) به اسم currentWidget دارن. (nullable)
✔️و یه پروپرتی هم به اسم currentState که type اش برابر type ای هست که برای GlobalKey مشخص کردیم.
گه اگه به ویجتی غیر از Stateful اختصاص بدیم این مقدار null برمیگردونه.
#key
#flutter_key
#local_key
#global_key
⚡️⚡️Flutter Key⚡️⚡️
8️⃣ GlobalKey
مثال )
میدونیم که وقتی که از MaterialApp استفاده میکنیم یه دونه Navigator برامون میسازه و توی درخت قراره میده.
بعد از اون هر موقع که بخوایم از نویگیتور استفاده کنیم میگیم :
Navigator.of(context)
❓این کد دقیقن چکار مکینه ؟
با استفاده از context ای که بهش دادیم شروع میکنه به جستجو توی درخت (از parent ویجت شروع میکنه) و میره بالا تا یه نویگتور توی درخت پیدا کنه و بعد state اون رو برمیگیردونه , یعنی خروجی این متد یه NavigatorState هست.
🔥ویجت Navigator یه StatefulWidget هست و یه state به نام NavigatorState داره و متد Navigator.of(context) یه NavigatorState برمیگردونه.
حالا بعد از اون میگیم
Navigator.of(context).push...
که این متد push و بقیه متد هایی که استفاده میکنیم متد هایی هستن که داخل NavigatorState تعریف شدن.
🔥🔥حالا به جای این کار میتونیم موقع ساخت MaterialApp یه پارامتر به اسم navigatorKey بهش بدیم. و توی این پارامتر یه GlobalKey بدیم. در نتیجه MaterialApp این key رو میده به Navigator و بعد از اون میتونیم ازش برای پیدا کردن NavigatorState استفاده کنیم :
var myNavKey = GlobalKey<NavigatorState>();
......
return MaterialApp(
navigatorKey: myNavKey,
.....
);
حالا به جای :
Navigator.of(context)
میگیم :
myNavKey.currentState.push...
🔥پس بدون نیاز به context تونستیم که نویگیت رو انجام بدیم.
🔥این کاری هست که پکیج GetX انجام میده.
#key
#flutter_key
#local_key
#global_key
8️⃣ GlobalKey
مثال )
میدونیم که وقتی که از MaterialApp استفاده میکنیم یه دونه Navigator برامون میسازه و توی درخت قراره میده.
بعد از اون هر موقع که بخوایم از نویگیتور استفاده کنیم میگیم :
Navigator.of(context)
❓این کد دقیقن چکار مکینه ؟
با استفاده از context ای که بهش دادیم شروع میکنه به جستجو توی درخت (از parent ویجت شروع میکنه) و میره بالا تا یه نویگتور توی درخت پیدا کنه و بعد state اون رو برمیگیردونه , یعنی خروجی این متد یه NavigatorState هست.
🔥ویجت Navigator یه StatefulWidget هست و یه state به نام NavigatorState داره و متد Navigator.of(context) یه NavigatorState برمیگردونه.
حالا بعد از اون میگیم
Navigator.of(context).push...
که این متد push و بقیه متد هایی که استفاده میکنیم متد هایی هستن که داخل NavigatorState تعریف شدن.
🔥🔥حالا به جای این کار میتونیم موقع ساخت MaterialApp یه پارامتر به اسم navigatorKey بهش بدیم. و توی این پارامتر یه GlobalKey بدیم. در نتیجه MaterialApp این key رو میده به Navigator و بعد از اون میتونیم ازش برای پیدا کردن NavigatorState استفاده کنیم :
var myNavKey = GlobalKey<NavigatorState>();
......
return MaterialApp(
navigatorKey: myNavKey,
.....
);
حالا به جای :
Navigator.of(context)
میگیم :
myNavKey.currentState.push...
🔥پس بدون نیاز به context تونستیم که نویگیت رو انجام بدیم.
🔥این کاری هست که پکیج GetX انجام میده.
#key
#flutter_key
#local_key
#global_key
⚡️⚡️Flutter Key⚡️⚡️
9️⃣ GlobalKey
❓آیا کاری که توی پست قبلی کردیم توی پرفرمانس تاثیر داره؟؟
😍😍صدردرصد بلههههه.
🔥🔥وقتی که از
Navigator.of
استفاده میکنیم شروع میکنه توی درخت حرکت کردن و به دنبال Navigator گشتن.
هرچه ویجت Navigator به ویجتی که داخلش این متد رو call کردیم نزدیکتر باشه این جستجو سریع تر انجام میشه و هر چقدر دورتر باشه زمان بیشتری میبره.
ولی وقتی از GlobalKey استفاده میکنیم دیگه نیازی به جستجو نیست و همون موقع در لحظه با استفاده از key میتونیم به NavigatorSate برسیم.
#key
#flutter_key
#local_key
#global_key
9️⃣ GlobalKey
❓آیا کاری که توی پست قبلی کردیم توی پرفرمانس تاثیر داره؟؟
😍😍صدردرصد بلههههه.
🔥🔥وقتی که از
Navigator.of
استفاده میکنیم شروع میکنه توی درخت حرکت کردن و به دنبال Navigator گشتن.
هرچه ویجت Navigator به ویجتی که داخلش این متد رو call کردیم نزدیکتر باشه این جستجو سریع تر انجام میشه و هر چقدر دورتر باشه زمان بیشتری میبره.
ولی وقتی از GlobalKey استفاده میکنیم دیگه نیازی به جستجو نیست و همون موقع در لحظه با استفاده از key میتونیم به NavigatorSate برسیم.
#key
#flutter_key
#local_key
#global_key
⚡️⚡️Flutter Key⚡️⚡️
1️⃣0️⃣ GlobalKey
🔥یه نکته مهم دیگه در مورد GlobalKey ها اینکه همیشه توی پروژتون یه کلاس برای مدیریت GlobalKey ها داشته باشید.
مثلن یه فولدر به اسم common داشته باشید و اونجا یه فایل به اسم keys.dart درست کنید و کلاس زیر رو داخلش بگذارید :
class Keys{
static final navigatorKey = GlobalKey<NavigatorState>();
}
هر GlobalKey که قراره توی پروژه استفاده بشه رو داخل این کلاس تعریف کنید و static کنید و هر جایی خواستید ازش استفاده کنید.
❌اگه خواستید یه GlobalKey خارج این کلاس تعریف کنید .
مثلن یه GlobalKey توی یه State تعریف کنید اصلن و به هیچ وجه اون رو توی متد build نسازید :
Widget build(BuildContext context){
final gKey = GlobalKey();
return Scaffold(key: gkey);
}
اصلن این کار رو نکنید , چون با هر بار rebuild شدن یه GlobalKey جدید و کاملن متفاوت از قبلی میسازه.
✅توی چنین مواردی GlobalKey رو قبل متد build و توی initState بهش مقدار بدید.
#key
#flutter_key
#local_key
#global_key
1️⃣0️⃣ GlobalKey
🔥یه نکته مهم دیگه در مورد GlobalKey ها اینکه همیشه توی پروژتون یه کلاس برای مدیریت GlobalKey ها داشته باشید.
مثلن یه فولدر به اسم common داشته باشید و اونجا یه فایل به اسم keys.dart درست کنید و کلاس زیر رو داخلش بگذارید :
class Keys{
static final navigatorKey = GlobalKey<NavigatorState>();
}
هر GlobalKey که قراره توی پروژه استفاده بشه رو داخل این کلاس تعریف کنید و static کنید و هر جایی خواستید ازش استفاده کنید.
❌اگه خواستید یه GlobalKey خارج این کلاس تعریف کنید .
مثلن یه GlobalKey توی یه State تعریف کنید اصلن و به هیچ وجه اون رو توی متد build نسازید :
Widget build(BuildContext context){
final gKey = GlobalKey();
return Scaffold(key: gkey);
}
اصلن این کار رو نکنید , چون با هر بار rebuild شدن یه GlobalKey جدید و کاملن متفاوت از قبلی میسازه.
✅توی چنین مواردی GlobalKey رو قبل متد build و توی initState بهش مقدار بدید.
#key
#flutter_key
#local_key
#global_key
⚡️⚡️Flutter Key⚡️⚡️
1️⃣1️⃣ GlobalKey
تا اینجا در مورد یکی از کاربرد های Globalkey به طور کامل صحبت کردیم و اون هم اختصاص GlobalKey به یه ویجت و دسترسی به context , state و خود widget در مکان های دیگه درخت بود.
ولی GlobalKey ها یه کاربرد مهم دیگه هم دارن.
🔥🔥با استفاده از GlobalKey میتونیم یه ویجت رو توی درخت جابجا کنیم (ویجت parent خودش رو تغییر بده) بدون اینکه اون ویجت state خودش رو از دست بده.
در مورد این کاربرد بعدن صحبت میکنیم.
#key
#flutter_key
#local_key
#global_key
1️⃣1️⃣ GlobalKey
تا اینجا در مورد یکی از کاربرد های Globalkey به طور کامل صحبت کردیم و اون هم اختصاص GlobalKey به یه ویجت و دسترسی به context , state و خود widget در مکان های دیگه درخت بود.
ولی GlobalKey ها یه کاربرد مهم دیگه هم دارن.
🔥🔥با استفاده از GlobalKey میتونیم یه ویجت رو توی درخت جابجا کنیم (ویجت parent خودش رو تغییر بده) بدون اینکه اون ویجت state خودش رو از دست بده.
در مورد این کاربرد بعدن صحبت میکنیم.
#key
#flutter_key
#local_key
#global_key
⚡️⚡️Flutter Key⚡️⚡️
1️⃣2️⃣ LocalKey
کار LocalKey ها این هست که به ویجت مورد نظر یه برچسب بزنن و اون رو از بقیه متمایز کنن.
❓حالا این برچسب زدن به چه درد میخوره و کجا باید ازشون استفاده کنیم؟
✔️دقیقن فقط یه کاربرد خاص دارن و اگه اون کاربرد رو بشناسیم میتونیم به خوبی ازشون استفاده کنیم.
🔥قبل از پرداختن به کاربرد یه یاداوری داشته باشیم.
همون طور که توی شماتیک پست قبل دیدیم LocalKey خودش یه کلاس abstract هست و نمیتونیم ازش نمونه بسازیم و برای استفاده از اون از subclass هاش یعنی ValueKey , ObjectKey یا uniqueKey استفاده میکنیم.
نوع PageStorageKey هم یه کاربرد دیگه داره که بعدن راجبش صحبت میکینم.
پس الان صحبتمون راجب سه نوع ValueKey , ObjectKey و uniqueKey هست.
بریم سر اصل مطلب...
❓کی از این ها استفاده کنیم ؟
✔️✔️✔️اگه یه لیست از ویجت های Stateful هم نوع داشتیم که قرار بود جایگاهشون توی لیست تغییر کنه(stateful ها میتونن فرزند اصلی لیست یا فرزند با واسطه باشن)برای هر Stateful یه key اختصاصی از این نوع در نظر میگیریم.(اگه stateful فرزند اصلی لیست بود به اون key رو میدیم و اگه فرزند با واسطه بود به فرزند اصلی (جد stateful) key رو میدیم)
مثلن وقتی که یه ListView داریم یا یه Column یا هر ویجت دیگه ای که قراره یه لیست از ویجت ها رو توی خودش داشته باشه.
✔️حالا اگه این ویجت هایی که قراره توی لیست قرار بگیرن از نوع Stateful بودن.
✔️همچنین Type یکسانی داشتن (مثلن همه از جنس MyStatefulWidget بودن / ویجت اختصاصی که از StatefulWidget ارث بری کرده)
✔️و علاوه بر اون قرار بود توی build های مختلف(setState) جایگاهشون توی لیست تغییر کنه.
✅در این حالت برای هر کدوم یه key اختصاص میدیم.
این که چه اتفاقی میوفته و چرا باید key بدیم رو بعدن توضیح میدیم.
توی پست های بعدی هم مثال میزنیم که بهتر متوجه بشید.
#key
#flutter_key
#local_key
#global_key
1️⃣2️⃣ LocalKey
کار LocalKey ها این هست که به ویجت مورد نظر یه برچسب بزنن و اون رو از بقیه متمایز کنن.
❓حالا این برچسب زدن به چه درد میخوره و کجا باید ازشون استفاده کنیم؟
✔️دقیقن فقط یه کاربرد خاص دارن و اگه اون کاربرد رو بشناسیم میتونیم به خوبی ازشون استفاده کنیم.
🔥قبل از پرداختن به کاربرد یه یاداوری داشته باشیم.
همون طور که توی شماتیک پست قبل دیدیم LocalKey خودش یه کلاس abstract هست و نمیتونیم ازش نمونه بسازیم و برای استفاده از اون از subclass هاش یعنی ValueKey , ObjectKey یا uniqueKey استفاده میکنیم.
نوع PageStorageKey هم یه کاربرد دیگه داره که بعدن راجبش صحبت میکینم.
پس الان صحبتمون راجب سه نوع ValueKey , ObjectKey و uniqueKey هست.
بریم سر اصل مطلب...
❓کی از این ها استفاده کنیم ؟
✔️✔️✔️اگه یه لیست از ویجت های Stateful هم نوع داشتیم که قرار بود جایگاهشون توی لیست تغییر کنه(stateful ها میتونن فرزند اصلی لیست یا فرزند با واسطه باشن)برای هر Stateful یه key اختصاصی از این نوع در نظر میگیریم.(اگه stateful فرزند اصلی لیست بود به اون key رو میدیم و اگه فرزند با واسطه بود به فرزند اصلی (جد stateful) key رو میدیم)
مثلن وقتی که یه ListView داریم یا یه Column یا هر ویجت دیگه ای که قراره یه لیست از ویجت ها رو توی خودش داشته باشه.
✔️حالا اگه این ویجت هایی که قراره توی لیست قرار بگیرن از نوع Stateful بودن.
✔️همچنین Type یکسانی داشتن (مثلن همه از جنس MyStatefulWidget بودن / ویجت اختصاصی که از StatefulWidget ارث بری کرده)
✔️و علاوه بر اون قرار بود توی build های مختلف(setState) جایگاهشون توی لیست تغییر کنه.
✅در این حالت برای هر کدوم یه key اختصاص میدیم.
این که چه اتفاقی میوفته و چرا باید key بدیم رو بعدن توضیح میدیم.
توی پست های بعدی هم مثال میزنیم که بهتر متوجه بشید.
#key
#flutter_key
#local_key
#global_key
⚡️⚡️Flutter Key⚡️⚡️
1️⃣7️⃣ LocalKey
🔥پس هر وقت یه لیست از Stateful های هم نوع داشتیم که قرار بود order شون تغییر کنه.
توجه کنید
✔️حتمن stateful باشن (stateful ها یا فرزند اصلی لیست باشن یا مثل مثال بالا از نوادگان لیست باشن)
✔️هم نوع باشن.
در این حالت از LocalKey ها استفاده میکنیم.
🔥🔥و نکته مهم طبق مثال های بالا این هست که key رو باید به فرزندان اصلی لیست بدیم.
این مثال هایی که زدیم مشابهش توی گوگل و یوتیوب هست.
ولی مهم مفهومه و اینکه چرا این اتفاقات میوفته که ان شالله بعدن بهش میپردازیم.
❌فقط توی همین مورد از این key ها استفاده کنید و جای دیگه لازم نیست.
❌فقط و فقط جاهایی که یه ویجت قراره چند تا فرزند بگیره (children) و قراره این اتفاقات بیوفته.
باید فرزندها key بگیرن.
اون هم از نوع Local .
ویجت های تک فرزندی نیاز ندارن که فرزندشون LocalKey داشته باشه به هیچ وجه.
🔥مگر اینکه جایی خود فلاتر برای کار دیگه ای اجبار کنه که به فلان ویجت حتمن key بدید.
#key
#flutter_key
#local_key
#global_key
1️⃣7️⃣ LocalKey
🔥پس هر وقت یه لیست از Stateful های هم نوع داشتیم که قرار بود order شون تغییر کنه.
توجه کنید
✔️حتمن stateful باشن (stateful ها یا فرزند اصلی لیست باشن یا مثل مثال بالا از نوادگان لیست باشن)
✔️هم نوع باشن.
در این حالت از LocalKey ها استفاده میکنیم.
🔥🔥و نکته مهم طبق مثال های بالا این هست که key رو باید به فرزندان اصلی لیست بدیم.
این مثال هایی که زدیم مشابهش توی گوگل و یوتیوب هست.
ولی مهم مفهومه و اینکه چرا این اتفاقات میوفته که ان شالله بعدن بهش میپردازیم.
❌فقط توی همین مورد از این key ها استفاده کنید و جای دیگه لازم نیست.
❌فقط و فقط جاهایی که یه ویجت قراره چند تا فرزند بگیره (children) و قراره این اتفاقات بیوفته.
باید فرزندها key بگیرن.
اون هم از نوع Local .
ویجت های تک فرزندی نیاز ندارن که فرزندشون LocalKey داشته باشه به هیچ وجه.
🔥مگر اینکه جایی خود فلاتر برای کار دیگه ای اجبار کنه که به فلان ویجت حتمن key بدید.
#key
#flutter_key
#local_key
#global_key
💊Capsule
⚡️نکات طلایی scrollable ویجت ها⚡️
5⃣
این نوع Key یه subclass از ValueKey هست با یه کاربرد خاص.
قبلن در مورد انواع key ها و کاربردشون گفتم و این نوع رو به آینده موکول کردم.
الان وقتشه 😍😍
🔥اگه بخوایم ScrollView موقعیت اسکرول خودش رو حفظ کنه و وقتی که خراب شد و دوباره از اول ساخته شد برگرده به همون scroll position قبلی، از این نوع از key استفاده می کنیم.
🔥برای مثال وقتی توی یه TabbarView یا یه PageView یه دونه ListView داشته باشیم وقتی میریم page بعدی این page که شامل لیست هست کامل destroy میشه و بعد که برمیگردیم از اول ساخته میشه.
🔥برای اینکه موقعیت اسکرول خودش رو ذخیره کنه و بعد که از اول ساخته شد دوباره بره همون جا :
✔️به یکی از parent های ListView یا خودش یه key از این نوع میدیم.
✔️توی ScrollController هم باید پارامتر زیر رو
🔥از این نوع key کلن میتونیم برای ذخیره و بازیابی اطلاعات توی یک Route و توی frame های مختلف استفاده کنیم که یه کاربردش همین بود که گفتم.
#capsule #intermediate #local_key #list_view
⚡️نکات طلایی scrollable ویجت ها⚡️
5⃣
PageStorageKeyاین نوع Key یه subclass از ValueKey هست با یه کاربرد خاص.
قبلن در مورد انواع key ها و کاربردشون گفتم و این نوع رو به آینده موکول کردم.
الان وقتشه 😍😍
🔥اگه بخوایم ScrollView موقعیت اسکرول خودش رو حفظ کنه و وقتی که خراب شد و دوباره از اول ساخته شد برگرده به همون scroll position قبلی، از این نوع از key استفاده می کنیم.
🔥برای مثال وقتی توی یه TabbarView یا یه PageView یه دونه ListView داشته باشیم وقتی میریم page بعدی این page که شامل لیست هست کامل destroy میشه و بعد که برمیگردیم از اول ساخته میشه.
🔥برای اینکه موقعیت اسکرول خودش رو ذخیره کنه و بعد که از اول ساخته شد دوباره بره همون جا :
✔️به یکی از parent های ListView یا خودش یه key از این نوع میدیم.
✔️توی ScrollController هم باید پارامتر زیر رو
true کنیم : keepScrollOffset🔥از این نوع key کلن میتونیم برای ذخیره و بازیابی اطلاعات توی یک Route و توی frame های مختلف استفاده کنیم که یه کاربردش همین بود که گفتم.
#capsule #intermediate #local_key #list_view
💊Capsule
⚡️نکات طلایی scrollable ویجت ها⚡️
7⃣
توی این پست میخوام یکم پیشگویی کنم و از آینده بگم 😂😂🤪
توی پست شماره ۵ در مورد PageStorageKey توضیح دادم و بهتون گفتم که از این نوع key میتونیم برای ذخیره موقعیت اسکرول یه scrollView استفاده کنیم.
🔥این روش توی ورژن های آینده فلاتر منسوخ میشه (دقیق نمیدونم چه ورژنی) ولی یکی از ToDo های فلاتر منسوخ کردن این روش هست.
🔥توی پست های بعدی در مورد روش جایگزین بهتون میگم که بعد از منسوخ شدن این روش هم خیالتون راحت باشه 😍
#capsule #list_view #advanced #local_key
⚡️نکات طلایی scrollable ویجت ها⚡️
7⃣
توی این پست میخوام یکم پیشگویی کنم و از آینده بگم 😂😂🤪
توی پست شماره ۵ در مورد PageStorageKey توضیح دادم و بهتون گفتم که از این نوع key میتونیم برای ذخیره موقعیت اسکرول یه scrollView استفاده کنیم.
🔥این روش توی ورژن های آینده فلاتر منسوخ میشه (دقیق نمیدونم چه ورژنی) ولی یکی از ToDo های فلاتر منسوخ کردن این روش هست.
🔥توی پست های بعدی در مورد روش جایگزین بهتون میگم که بعد از منسوخ شدن این روش هم خیالتون راحت باشه 😍
#capsule #list_view #advanced #local_key