58

I try to create some custom widgets with some parameters in the constructor. This widget has some optional and required parameters.

how can make Function type parameter optional in my Widget.

class TextInputWithIcon extends StatefulWidget {
  final String iconPath;
  final String placeHolder;
  final Function(bool) onFocusChange;
  const TextInputWithIcon(
      {Key key,
      @required this.iconPath,
      this.placeHolder = "",
      this.onFocusChange})
      : super(key: key);

  @override
  _TextInputWithIconState createState() => _TextInputWithIconState();
}

class _TextInputWithIconState extends State<TextInputWithIcon> {
@override
  Widget build(BuildContext context) {
    return MY_WIDGET;
   }
}
Saman
  • 2,506
  • 4
  • 22
  • 41

3 Answers3

112

Optional parameters can be either positional or named, but not both.

Named parameters are optional by default so you don't have to assign the default value.

If a parameter is optional but can’t be null, provide a default value.

With null safety

class TextInputWithIcon extends StatefulWidget {
  final String iconPath;
  final String placeHolder;
  final Function(bool)? onFocusChange; // nullable and optional
  
  const TextInputWithIcon(
      {Key? key,
      required this.iconPath, // non-nullable and required
      this.placeHolder = "", // non-nullable but optional with a default value
      this.onFocusChange, // nullable and optional
      })
      : super(key: key);

  @override
  _TextInputWithIconState createState() => _TextInputWithIconState();

}

Without null safety

const TextInputWithIcon(
      {Key key,
      @required this.iconPath,
      this.placeHolder = "",
      this.onFocusChange
})
      : super(key: key);

Usage:

void _focusChanged(bool value) {

    // using null-aware operator (for both with and without null safety)
    onFocusChange?.call(value);
    
    // or without null-aware operator 
    
    // with null safety
    if(onFocusChange != null) {
      onFocusChange!(value);
    }

    // without null safety
    if(onFocusChange != null) {
      onFocusChange(value);
    }

  }

Dart 2.17 update:

Although it often makes sense to place positional arguments first, named arguments can be placed anywhere in the argument list when it suits your API:

repeat(times: 2, () {
  ...
});

Have a look at Optional Parameters to understand better.

Edit: Thank you Jonah Williams to clarification.

Umair M
  • 10,298
  • 6
  • 42
  • 74
17

Another option if you don't like named parameters (like me :/) is:

function_name (argument1, [argument2]) {
   // statements
}

arguments in brackets are optional.

source

15

You can use a default value that does nothing:

class TextInputWithIcon extends StatefulWidget {
  final String iconPath;
  final String placeHolder;
  final Function(bool) onFocusChange;
  const TextInputWithIcon(
      {Key key,
      @required this.iconPath,
      this.placeHolder = "",
      this.onFocusChange = _dummyOnFocusChange})
      : assert(onFocusChange != null), super(key: key);

  @override
  _TextInputWithIconState createState() => _TextInputWithIconState();

  static dynamic _dummyOnFocusChange(bool val) {}
}

I created a static named function instead of just a closure as a default value because closures are not const and currently default values need to be const.

I added the assert(...) to ensure that an error is shown when null is passed explicitly.

Günter Zöchbauer
  • 623,577
  • 216
  • 2,003
  • 1,567
  • if my function don't take argument also not return anything it'll be >> (static _dummyOnFocusChange() {} ) is this way correct because i tried and give error at compile time so i tried ( static dynamic _dummyOnFocusChange() {} ) and worked with me. Can you tell me why worked ?? – Magician Apr 07 '20 at 21:19
  • If you need to pass a parameter depends on `final Function(bool) onFocusChange`. If you don't intend to return anything, use `void`. `dynamic` is kind of a wildcard. – Günter Zöchbauer Apr 08 '20 at 03:18
  • for my case I need to pass a custom model. I can't just declare the whole model if null, I need extra info that it's not there – Dani Feb 13 '21 at 11:52
  • @GünterZöchbauer how can we pass optional params and use them in a custom widget? Kindly suggest. Thanks. – Kamlesh May 16 '21 at 17:29