Refactor Constructors page

Author: Tony Sansone

examples/misc/lib/language_tour/classes/point_alt.dart

@@ -34,3 +34,72 @@ class Point {
 // #docregion idiomatic-constructor
 }
 // #enddocregion idiomatic-constructor
+
+// #docregion initialize-declaration
+class PointA {
+  double x = 1.0;
+  double y = 2.0;
+
+  // The parameterless constructor is not even be needed to set to (1.0,2.0)
+  PointA();
+
+  @override
+  String toString() {
+    return 'PointA($x,$y)';
+  }
+}
+// #enddocregion initialize-declaration
+
+// #docregion initialize-formal
+class PointB {
+  final double x;
+  final double y;
+
+  // Sets the x and y instance variables
+  // before the constructor body runs.
+  PointB(this.x, this.y);
+
+  // Initializing formal parameters can also be optional.
+  PointB.optional([this.x = 0.0, this.y = 0.0]);
+  PointB.named({required this.x, required this.y});
+
+  // Private fields cannot be used as named initializing formals.
+  PointB.namedPrivate({required double x, required double y})
+      : _x = x,
+        _y = y;
+}
+// #enddocregion initialize-formal
+
+// #docregion initialize-named
+class PointC {
+  double x; // must be set in constructor
+  double y; // must be set in constructor
+
+  // Generative constructor with initializing formal parameters
+  // with default values
+  PointC({this.x = 1.0, this.y = 1.0});
+
+  @override
+  String toString() {
+    return 'PointC($x,$y)';
+  }
+}
+
+// Constructor using named variables.
+final pointC = PointC(x: 2.0, y: 2.0);
+// #enddocregion initialize-named
+
+// #docregion initialize-null
+class PointD {
+  double? x; // null if not set in constructor
+  double? y; // null if not set in constructor
+
+  // Generative constructor with initializing formal parameters
+  PointD(this.x, this.y);
+
+  @override
+  String toString() {
+    return 'PointD($x,$y)';
+  }
+}
+// #enddocregion initialize-null

examples/misc/lib/language_tour/classes/super_initializer_named_parameters.dart

@@ -0,0 +1,21 @@
+// #docregion named
+class Vector2d {
+// #enddocregion named
+  final double x;
+  final double y;
+
+  Vector2d(this.x, this.y);
+// #docregion named
+  // ...
+  Vector2d.named({required this.x, required this.y});
+}
+
+class Vector3d extends Vector2d {
+  final double z;
+
+  // Forward the y parameter to the named super constructor like:
+  // Vector3d.yzPlane({required double y, required this.z})
+  //       : super.named(x: 0, y: y);
+  Vector3d.yzPlane({required super.y, required this.z}) : super.named(x: 0);
+}
+// #enddocregion named

examples/misc/lib/language_tour/classes/super_initializer_positional_parameters.dart

@@ -0,0 +1,16 @@
+// #docregion positional
+class Vector2d {
+  final double x;
+  final double y;
+
+  Vector2d(this.x, this.y);
+}
+
+class Vector3d extends Vector2d {
+  final double z;
+
+  // Forward the x and y parameters to the default super constructor like:
+  // Vector3d(final double x, final double y, this.z) : super(x, y);
+  Vector3d(super.x, super.y, this.z);
+}
+// #enddocregion positional