Чӣ гуна калидҳо ва сценарияҳо дар амал истифода…

Ключҳо (Keys) дар Flutter барои идоракунии шенасоии widgetҳо, унсурҳо ва ҳолатҳо дар вақти барқарорсозии онҳо истифода мешаванд. Сенарияҳо (Scenarios), ҳамчун чунин, дар Flutter стандартӣ нестанд; эҳтимолан, сухан дар бораи моделҳо ё усулҳои гуногуни истифодаи клучҳо меравад.

Намудҳои клучҳо ва истифодаи онҳо:

LocalKey: Барои widgetҳо дар дохили як падар истифода мешавад.

ValueKey: Бар асоси арзиш (String, int ва ғайра). Барои рӯйхатҳои тағйирёбандаи widgetҳо (масалан, Dismissible) муфид аст.

// Нуқтаи истифодаи ValueKey барои нигоҳ доштани ҳолати widget дар рӯйхат
ListView.builder(
  itemCount: items.length,
  itemBuilder: (context, index) {
    return Dismissible(
      key: ValueKey(items[index].id), // ID-и беназир ҳамчун калид
      onDismissed: (direction) {
        // нест кардани унсур аз рӯйхат
      },
      child: ListTile(title: Text(items[index].name)),
    );
  },
)

ObjectKey: Бар асоси истинод ба объект.

// Нуқтаи истифодаи ObjectKey
// (камтар паҳншуда, аз ValueKey, аммо метавонад дар кор бо идентификаторҳои объектҳо муфид бошад)
Object uniqueObject = new Object(); // Гумон мекунем, ки ин объектест, ки намояндагии ягона дорад
Widget myWidget = Container(key: ObjectKey(uniqueObject));

GlobalKey: Барои шенасоии беназир дар тамоми дарахти widget-ҳо истифода мешавад. Имкон медиҳад, ки ба ҳолати widget дастрасӣ пайдо кунед ё амалҳоро аз ҳар ҷое дар барнома иҷро кунед.

GlobalKey:

// Нуқтаи истифодаи GlobalKey барои дастрасӣ ба ҳолати widget
final GlobalKey<MyStatefullWidgetState> myWidgetKey = GlobalKey();

// Дар ҷои дигар
// myWidgetKey.currentState?.doSomething(); // Даъвати усули ҳолат

// Истифодаи калид дар widget
// MyStatefullWidget(key: myWidgetKey);

GlobalKey<FormState>: Барои идоракунии ҳолати форм истифода мешавад (Form).

// Нуқтаи истифодаи GlobalKey<FormState> барои тасдиқи форм
final GlobalKey<FormState> formKey = GlobalKey<FormState>();

// ...

// Вақти фиристодани форм
// if (formKey.currentState!.validate()) {
//   // Формат дуруст аст, амалҳоро иҷро мекунем
// }

// Истифодаи калид дар widget-и Form
// Form(key: formKey, child: ...)

Истифодаи калидҳо дар рушди ҳаррӯза (сценарияҳо):

Идоракунии ҳолати унсурҳо дар рӯйхатҳои динамикӣ: Калидҳо (хусусан ValueKey) ба Flutter имкон медиҳанд, ки дуруст истифода бурда ва навсозӣ кунад widget-ҳоро дар рӯйхатҳо (ListView.builder, GridView.builder) ҳангоми илова кардан, тоза кардан ё тағир додани ҷойгиршавии унсурҳо. Бе калидҳо, Flutter метавонад бо мушкилот дар нигоҳ доштани ҳолати widget-ҳо рӯбарӯ шавад (масалан, куттии чекбокс дар унсури рӯйхат метавонад дар вақти барқарорсозӣ нопадид шавад).
Дастрасӣ ба ҳолати widget: GlobalKey имкон медиҳад, ки ба State аз ҳар ҷо дастрасӣ пайдо кунед, ки имконият медиҳад, ки усулҳоро даъват ё маълумотҳоро аз ин ҳолат гиред (масалан, нишон додани Snack Bar аз StatefulWidget, гирифтани ҳолати TextFormField).
Идоракунии ҳолати формҳо: GlobalKey<FormState> зарур аст барои тасдиқ ва нусхабардории ҳолати форм.
Идоракунии фокуси воридот: Калидҳо метавонанд барои идоракунии (FocusNode) дар widget-ҳои муайян истифода шаванд.
Нигоҳ доштани ҳолат ҳангоми рефакторинг дар дарахти widget: Агар widget ба дарахт гузошта шавад, истифодаи GlobalKey имкон медиҳад, ки Flutter ҳолати онро нигоҳ дорад, ба ҷои он ки онро аз нав сохта созад.

Дар маҷмӯъ, калидҳо механизмҳои асосӣ дар Flutter барои назорати дақиқи давраи ҳаёти widget-ҳо ва нигоҳ доштани ҳолати онҳо мебошанд, махсусан дар сценарияҳои динамики UI.

Чӣ гуна калидҳо ва сценарияҳо дар амал истифода мешаванд?