Flutter मा keys के हुन्छन् र तपाईलाई कहिले यिनीहरु चाहिन्छ?

Question

Accepted Answer

**Keys** ले Flutter framework लाई rebuild भर्दा widgets लाई सही रूपमा पहचान गर्न र संरक्षण गर्न मद्दत गर्छ — विशेष गरी **stateful widgets को सूचीमा** जहाँ क्रम बदलिन्छ, थपिन्छ वा हटाइन्छ। कहिले keys चाहिन्छ भनी बुझ्नुले सूक्ष्म र भ्रामक bugs रोक्छ।

## Keys ले के गर्छन्

```text
During rebuilds, Flutter MATCHES new widgets to existing elements/state by POSITION and
TYPE. Usually this works fine. But when widgets of the SAME TYPE are reordered/added/
removed in a list, position-matching gets confused → state attaches to the WRONG widget.
→ KEYS give widgets a stable IDENTITY so Flutter matches them correctly across changes.
```

## क्लासिक समस्या (keys बिना)

```text
A list of STATEFUL widgets (e.g. items with their own state). You remove the FIRST item:
  ✗ WITHOUT keys → Flutter matches by position → the state stays at each position, so
    state appears attached to the WRONG items (state "shifts" incorrectly)
  ✓ WITH keys → Flutter matches by key → state follows the correct widget
→ This causes confusing bugs (wrong checkbox checked, wrong item highlighted, etc.).
```

```dart
// give list items stable keys (e.g. a unique id)
ListView(children: items.map((item) =>
  MyStatefulItem(key: ValueKey(item.id), item: item)   // stable identity
).toList())
```

## Key प्रकार र कहिले प्रयोग गर्ने

```text
ValueKey → key by a value (e.g. an item's unique id) — common for list items
ObjectKey → key by an object's identity
UniqueKey → a guaranteed-unique key (forces a new identity each build — use carefully)
GlobalKey → a globally-unique key; access a widget's state/context from elsewhere
  (e.g. Form's GlobalKey) — powerful but heavier; use sparingly
WHEN NEEDED: mainly for STATEFUL widgets in dynamic lists (reorder/add/remove).
  Stateless widgets and static lists usually DON'T need keys.
```

## यो किन महत्त्वपूर्ण छ

Keys बुझ्नु वरिष्ठ स्तरको मूल्यवान ज्ञान हो किनभने यो **stateful widgets को साथ सूक्ष्म, भ्रामक bugs** समाधान गर्छ र कहिले keys चाहिन्छ भनी जान्नु गहिरो Flutter समझलाई प्रतिबिम्बित गर्छ।

मूल समस्या — कि Flutter सामान्यतया widgets लाई तिनीहरुको अवस्थामा **स्थिति र प्रकार** द्वारा मिलाउछ rebuild को समयमा, जो सामान्यतया ठीक काम गर्छ तर **एउटै प्रकारका stateful widgets जब सूचीमा क्रम बदलिन्छ, थपिन्छ वा हटाइन्छ भने खराब हुन्छ** (अवस्था गलत widgets लाई जोडिन्छ) — यो एक वास्तविक भ्रामक bugs को स्रोत हो (गलत checkbox checked, गलत आइटम highlight, अवस्था गलत रूपमा "shift" भएको देखिन्छ)। **Keys ले widgets लाई स्थिर पहचान दिन्छ** त्यसैले Flutter ले यिनीहरु यो परिवर्तनहरु भर्दा सही रूपमा मिलाउछ, यस्ता bugs ठीक गर्दै।

**क्लासिक समस्या** बुझ्नु (stateful widgets को सूचीबाट आइटम हटाउने बिना keys को कारण अवस्था गलत हुन्छ) र समाधान (`ValueKey(item.id)` जस्ता स्थिर keys दिने) यो व्यावहारिक ज्ञान हो जो यस्ता भ्रामक समस्या समाधान गर्छ।

**Key प्रकार** (ValueKey id जस्ता मान द्वारा key गर्न — सूचीको आइटमहरु को लागि सामान्य; ObjectKey; UniqueKey; र **GlobalKey** एक widget को अवस्थामा अन्यत्र पहुँच गर्न को लागि, जस्तै Form को GlobalKey) र महत्त्वपूर्ण रूपमा **कहिले keys चाहिन्छ** (मुख्यतया stateful widgets को गतिशील सूचीमा; stateless widgets र स्थिर सूचीहरु सामान्यतया यिनीहरु चाहिंदैन) बुझ्नु परिपक्व समझ प्रतिबिम्बित गर्छ — keys लाई उपयुक्त रूपमा लागु गर्नु सबैतिर cargo-culting को बजायमा वा जहाँ चाहिन्छ भनी छोडिने को बजायमा।

Keys ले stateful widgets को गतिशील सूचीमा वास्तविक, सूक्ष्म bugs समाधान गर्छ (एक भ्रामक समस्या जो धेरै developers लाई हराउछ) र कहिले र कसरी keys प्रयोग गर्ने बुझ्नु गहिरो Flutter ज्ञान को प्रतिबिम्ब गर्छ, keys बुझ्नु वरिष्ठ स्तरको ज्ञान मूल्यवान छ — state bugs को एक वर्ग समाधान गर्दै र वरिष्ठ भूमिकाहरु को लागि अपेक्षा गरिएको Flutter को rendering model को गहिरो समझ प्रतिबिम्बित गर्दै, एक विषय जो त्यिनहरु लाई अलग गर्छ जो वास्तविक रूपमा Flutter को समझ राख्छन् त्यिनहरु बाट जो मात्र यसलाई सतहको साथ प्रयोग गर्छन्।