Cad iad keys i Flutter agus cathain a bhíonn a fhios agat gur bhfuil siad de dhíth?

Question

Accepted Answer

Cuidíonn **keys** i Flutter an creatlach a bhíonn ar an cothrom cheart chun wigets a aithint agus a chaomhnú trasna athdhéanaimh — go háirithe tábhachtach do **wigets stateful i liosta** a bhíonn athord déanta orthu, fhágtha nó bainne. Tuiscint ar an am a bhíonn gá do na keys a chosc bugs cealgach, mearbhall.

## Cad a dhéanann 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.
```

## An fhadhb dhéalta (gan 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())
```

## Cineálacha keys agus cathain a úsáid iad

```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.
```

## Cén fáth a bhíonn sé ríthábhachtach

Is eolas dea-scéal ar leibhéal sinsearach a bhíonn ann a thuiscint ar na keys mar a réiteann siad **bugs cealgach, mearbhall** le wigets stateful i liosta dinimiciúla, agus is léiriú ar thuiscint dhoimhne ar Flutter a bhíonn ann fios a bheith agat cathain atá gá dóibh.

An fhadhb bhunúsach — go soláthraíonn Flutter na wigets ar a gcóir do staid na **seasamh agus cineál** le linn athdhéanaimh, a oibríonn go maith i ginearálta ach **a theipeann nuair atáonn wigets stateful den chineál céanna athord ar a gcóir, fhágtha nó bainte i liosta** (an staid ag gabháil don chiotóga míchearta) — is foinse fhíor de bhuganna mearbhall é seo (bosca driocha mícheart, mír gheal mícheart, staid ag crith go mícheart). Is éard a thugann **keys do wigets ná aithint bhuan** ionas go bhfáisceann Flutter iad i gceart thrasna na hathruithe seo, ag socrú buganna mar sin.

Tuiscint ar an **fhadhb dhéalta** (mír a bhaint ó liosta de wigets stateful gan keys ag socrú staid go mícheart) agus an réiteach (mír a thabhairt do keys buana cosúil le `ValueKey(item.id)`) is eolas práiticiúil an rud atá ag réiteach na faidhbe mearbhall seo.

Tuiscint ar an **gcineálacha keys** (ValueKey chun eagar a chur ar luach cosúil le id — coitianta do mhíreanna liosta; ObjectKey; UniqueKey; agus **GlobalKey** chun rochtain a bhaint ar staid wigit in áit eile, cosúil le GlobalKey Form) agus go tábhachtach **cathain atá gá do na keys** (go príomha do wigets stateful i liosta dinimiciúla; ní bhaineann wigets staidéartha agus liosta statach gá dóibh i ngnáth) léiríonn tuiscint aibí — na keys a chur i bhfeidhm go ceart ina ionad a gcur ar fud an domhain nó a fhágáil i áit a bhí gá dóibh.

Ar an ábhar go bhfuil na keys ag socrú buganna fíor, cealgach le wigets stateful i liosta dinimiciúla (fhadhb mearbhall a bhíonn ag cur isteach ar go leor forbróirí) agus go bhfuil tuiscint ar cathain agus conas iad a úsáid ina léiriú ar eolas doimhne ar Flutter, is eolas dea-scéal ar leibhéal sinsearach a bhíonn ann a thuiscint ar na keys — ag socrú ghrúpa de bhuganna staid mearbhall agus ag léiriú an tuisceana doimhne ar an tsamhail tarraint Flutter a bhíonn ag súil in aghaidh na róil sinsearach, topaicín a dhéanann idirdhealú idir iad siúd a thuigfidh tarraint Flutter i ndáiríbh agus iad siúd a úsáideann sé go dromchla amháin.