Do czego służą nazwane parametry w funkcjach i konstruktorach?

Nazwane parametry w funkcjach i konstruktorach Dart/Flutter rozwiązują kilka zadań:

1. Poprawa czytelności kodu: Nazewnictwo parametrów wyraźnie wskazuje ich przeznaczenie podczas wywołania. Jest to szczególnie przydatne, gdy funkcja lub konstruktor ma wiele argumentów tego samego typu.

   // Bez nazwanych parametrów, nie od razu wiadomo, co oznaczają 1.0 i 5.0
   Widget buildContainer(1.0, 5.0, Colors.blue);
   
   // Z nazwanymi parametrami, przypisanie argumentów jest oczywiste
   Widget buildContainer({double? padding, double? margin, Color? color});
   Widget container = buildContainer(padding: 1.0, margin: 5.0, color: Colors.blue);
   

2. Zapewnienie elastyczności wywołania: Pozwalają wywołać funkcje lub konstruktory, przekazując tylko potrzebne parametry, ignorując pozostałe, jeśli nie są obowiązkowe (z użyciem required lub wartości domyślnych).

   // Wywołanie z przekazaniem tylko potrzebnych parametrów
   Widget container = buildContainer(color: Colors.red);
   

3. Zapobieganie błędom kolejności argumentów: Ponieważ parametry są wskazywane po nazwie, ich kolejność podczas wywołania nie ma znaczenia, co wyklucza błędy związane z nieprawidłową kolejnością przekazywania argumentów.

   // Kolejność nazwanych parametrów nie ma znaczenia
   Widget container1 = buildContainer(padding: 1.0, color: Colors.blue);
   Widget container2 = buildContainer(color: Colors.blue, padding: 1.0); // Równoważne
   

4. Ulepszenie obsługi kodu: Nazwane parametry ułatwiają dodawanie nowych opcjonalnych parametrów w przyszłych wersjach funkcji lub klasy bez konieczności zmiany istniejących wywołań.

W Flutter większość widżetów używa nazwanych parametrów, co czyni ich API bardziej intuicyjnym i elastycznym.

Są one deklarowane w nawiasach {} na liście parametrów funkcji lub konstruktora. Obowiązkowe nazwane parametry oznacza się słowem kluczowym required.

// Obowiązkowy nazwany parametr
void printRequiredName({required String name}) {
  print(name);
}

// Opcjonalny nazwany parametr z wartością domyślną
void printOptionalAge({int age = 30}) {
  print(age);
}