⚡️⚡️Flutter Key⚡️⚡️
1⃣

توی چند پست آینده در مورد key ها صحبت میکنیم.
انواع اون ها رو بررسی میکنیم و کاربرد هر کدومشون رو میگیم.

🔥توی فلاتر یه کلاس به اسم Key داریم که abstract هست و پایه و اساس کلاس های دیگه هست.

این کلاس دو نوع فرزند داره
LocalKey
GlobalKey

این ها کلاس هایی هستند که از Key ارث بری کردند و دو نوع مختلف Key رو با کاربرد های مختلف برای ما میسازند.

پست های بعدی رو از دست ندید. 😍
#key
#flutter_key
#local_key
#global_key

⚡️⚡️Flutter Key⚡️⚡️
2⃣

🔥اولین نکته و اولین تفاوت این دو نوع Key رو از اسمشون میگیریم.

✔️کلید های global باید در کل اپ یکتا باشن ، یعنی اینکه اگه به یک ویجتی یه GlobalKey دادیم اون key رو دیگه نمیتونم به ویجت دیگه ای بدیم.

✔️اما LocalKey ها فقط در یک sub tree بررسی میشن یعنی اینکه میتونیم به دو تا ویجت LocalKey یکسان بدیم به شرط اینکه در یک sub tree نباشن.

🤔حالا اینکه این sub tree رو چگونه تحلیل کنیم و از کجا بفهمیم که کجاها مجاز نیستیم از LocalKey یکسان استفاده کنیم بستگی به مورد استفاده داره که به موقش در موردش صحبت میکنیم.

#key
#flutter_key
#local_key
#global_key

⚡️⚡️Flutter Key⚡️⚡️
3⃣

خب بریم سر وقت مهمترین تفاوت بین global ها و local ها :

🔥تفاوت اصلی اینجاست که GlobalKey ها حافظه دارن و LocalKey ها هیچ حافظه ای ندارن.

❓یعنی چی؟ وقتی که به یه ویجتی یه دونه GlobalKey اختصاص میدیم ، GlobalKey یه کار مهم میکنه و context ویجت رو توی خودش ذخیره میکنه (BuildContext).

✔️در نتیجه بعد از اون هر موقع و هر جایی با استفاده از اون key میتونیم به context ویجت دسترسی داشته باشیم و چون خود context هم اطلاعات دیگه از قبیل widget و State رو توی خودش داره میتونیم به اون ها هم دسترسی داشته باشیم.

✔️علاوه بر اون اگه اون ویجت توی درخت جابجا بشه و context اش تغییر کنه باز هم به context جدید دسترسی داریم.

🔥یه نکته هم بگیم که همه ویجت ها یه BuildContext اختصاصی برای خودشون دارن، همه ویجت ها و نه فقط استیت لس و استیت فول هایی که خودمون میسازیم.
همه ویجت شامل Text و Container و... یه BuildContext اختصاصی دارن که این context موقع ساخته شدن ویجت توی درخت ساخته میشه.

❌برخلاف global ها LocalKey هیچ حافظه ای نداره و هیچی توی خودش نگه نمیداره.

پس با توجه به این نکات :

✅ وقتی از GlobalKey استفاده میکنیم که بعدن و یه جای دیگه از برنامه نیاز داشته باشیم به context یا state یا خود اون widget دسترسی داشته باشیم.

✅وقتی از LocalKey ها استفاده میکنیم که فقط بخوایم به برچسب به اون ویجت بزنیم و با اون برچسب اون ویجت رو از بقیه متمایز کنیم.

🔥پس GlobalKey ها حافظه دارن و LocalKey ها صرفن یه برچسب هستن.

🔥البته GlobalKey ها علاوه بر داشتن حافظه میتونن کار برچسب گذاری (متمایز کردن) رو هم انجام بدن ولی اگه هدفمون فقط متمایز کردن ویجت از بقیه هست و نمیخایم بعدن یه جای دیگه به اطلاعاتش دسترسی داشته باشیم از LocalKey استفاده میکنیم.
#key
#flutter_key
#local_key
#global_key

⚡️⚡️Flutter Key⚡️⚡️
4️⃣
⛔️توی پست قبلی گفتیم که Globalkey ها حافظه دارن و Context ویجت رو توی خودشون ذخیره میکنن و بعدن با استفاده از اون میتونیم به context یا خود Widget یا State اون (در صورتی که ویجتی که key بهش اختصاص داده شده Stateful باشه) دسترسی پیدا کنیم و در مقابل LocalKey ها صرفن یه برچسب هستن.

اینجا یه نکته در مورد اون چیزی که واقعن داره اتفاق میوفته میگیم (Under the hood) , اگه زیاد علاقه ای ندارید میتونید از این نکته صرف نظر کنید.

🔥در واقع خود GlobalKey کار ذخیره Context رو انجام نمیده و Context ویجت توی خود GlobalKey ذخیره نمیشه.

❓پس کجا ذخیره میشه ؟
یه map وجود داره به شکل زیر
Map<GlobalKey , BuildContext> ـregistery

مپی که key های اون از جنس GlobalKey هستن و Value های اون از جنس BuildContext (البته دقیقن از جنس BuildContext نیستن ولی برای سادگی ما اینجا از نوع BuildContext در نظر میگیریم)

این مپ توی یه کلاسی که Element tree رو مدیریت میکنه وجود داره و وقتی که یه Element جدید ساخته میشه و mount میشه اگه key اختصاص داده شده به Widget اون Element از نوع Globalkey باشه یه عنصر به مپ اضافه میکنه :
_registery[gKey] = context;

اینجا gkey رو GlobalKey اختصاص داده شده به ویجت در نظر بگیرید و context رو هم buildContext ویجت.

وقتی هم که Element به اخر عمرش میرسه و unmount میشه این مپ اون عنصر رو حذف میکنه:
_registery.remove(gKey);

حالا خود کلاس GlobalKey به این مپ دسترسی داره و میتونه BuildContext متناظر با خودش رو پیدا کنه.

⛔️این نکته پیشرفته بود و سعی کردم که خیلی سادش کنم که بهتر متوجه بشید و برخی نکات خیلی ریز رو حذف کردم ولی میتونید ازش صرف نظر کنید.
#key
#flutter_key
#local_key
#global_key

⚡️⚡️Flutter 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