Kokiu tikslu naudojami vardiniai parametrai funkcijose ir konstruktoriuose?

Vardiniai parametrai Dart/Flutter funkcijose ir konstruktoriuose sprendžia kelias užduotis:

1. Kodo skaitomumo gerinimas: Vardiniai parametrai aiškiai nurodo jų paskirtį iškvietimo metu. Tai ypač naudinga, kai funkcija ar konstruktorius turi daug vienodo tipo argumentų.

   // Be vardinių parametrų, nėra iš karto aišku, ką reiškia 1.0 ir 5.0
   Widget buildContainer(1.0, 5.0, Colors.blue);
   
   // Su vardiniais parametrais, argumentų paskirtis aiški
   Widget buildContainer({double? padding, double? margin, Color? color});
   Widget container = buildContainer(padding: 1.0, margin: 5.0, color: Colors.blue);
   

2. Kvietimo lankstumo užtikrinimas: Jie leidžia iškviesti funkcijas ar konstruktorius perduodant tik būtinus parametrus, ignoruojant kitus, jei jie nėra privalomi (required arba numatytos reikšmės).

   // Iškvietimas perduodant tik reikalingus parametrus
   Widget container = buildContainer(color: Colors.red);
   

3. Argumentų tvarkos klaidų prevencija: Kadangi parametrai nurodomi pagal pavadinimą, jų tvarka iškvietimo metu nėra svarbi, kas pašalina klaidas, susijusias su neteisinga argumentų tvarka.

   // Pavadintų parametrų tvarka nėra svarbi
   Widget container1 = buildContainer(padding: 1.0, color: Colors.blue);
   Widget container2 = buildContainer(color: Colors.blue, padding: 1.0); // Lygu
   

4. Kodo palaikymo gerinimas: Vardiniai parametrai palengvina naujų neprivalomų parametrų pridėjimą būsimose funkcijos ar klasės versijose be būtinybės keisti esamus iškvietimus.

Dart/Flutter dauguma widgetų naudoja vardinius parametrus, kas daro jų API intuityvesnį ir lankstesnį.

Jie deklaruojami skliausteliuose {} funkcijos ar konstruktoriaus parametruose. Privalomi vardiniai parametrai pažymimi žodžiu required.

// Privalomas vardinis parametras
void printRequiredName({required String name}) {
  print(name);
}

// Neprivalomas vardinis parametras su numatyta reikšme
void printOptionalAge({int age = 30}) {
  print(age);
}