Kas yra raktai (keys) Flutter'yje ir kada jų reikia?

Question

Accepted Answer

**Raktai** Flutter'yje padeda struktūrai teisingai identifikuoti ir išsaugoti valdiklius iš naujo sudarant — ypač svarbu **būsenos turintiems valdikliais sąraše**, kurie yra perrūšiuojami, pridedami ar šalinami. Supratus, kada raktai reikalingi, išvengiama subtilių, paini sukeliančių klaidų.

## Ką raktai daro

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

## Klasikinė problema (be raktų)

```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())
```

## Raktų tipai ir kada juos naudoti

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

## Kodėl tai svarbu

Raktų supratimas yra brangus aukštesnio lygio žinios, nes jie sprendžia **subtiles, paini sukeliančias klaidas** su būsenos turinčiais valdikliais dinaminiam sąrašuose, o žinojimas, kada jie reikalingi, atspindi gilesnį Flutter supratimą.

Pagrindinis klausimas — kad Flutter paprastai suderina valdiklius jų būsenai pagal **poziciją ir tipą** iš naujo sudarant, kas paprastai veikia, bet **sugenda, kai to paties tipo būsenos turintys valdikliai yra perrūšiuojami, pridedami ar šalinami sąraše** (sukeldami būseną, kad ji bus pridėta prie neteisingų valdiklių) — yra tikra neaiškių klaidų šaltinis (neteisingas langelis pažymėtas, neteisingas elementas paryškintas, būsena, kuri atrodo „šalinta