Unverified Commit 9d4e8167 authored by Pierre-Louis's avatar Pierre-Louis Committed by GitHub

Fix `deprecated_new_in_comment_reference` for `material` library (#100289)

* fix deprecated_new_in_comment_reference for `material` library

in a future version of the SDK, these will be flagged, fix them now

* Update pubspec.yaml
parent 4d2dc5d6
...@@ -293,9 +293,9 @@ class AnimationController extends Animation<double> ...@@ -293,9 +293,9 @@ class AnimationController extends Animation<double>
/// The behavior of the controller when [AccessibilityFeatures.disableAnimations] /// The behavior of the controller when [AccessibilityFeatures.disableAnimations]
/// is true. /// is true.
/// ///
/// Defaults to [AnimationBehavior.normal] for the [new AnimationController] /// Defaults to [AnimationBehavior.normal] for the [AnimationController.new]
/// constructor, and [AnimationBehavior.preserve] for the /// constructor, and [AnimationBehavior.preserve] for the
/// [new AnimationController.unbounded] constructor. /// [AnimationController.unbounded] constructor.
final AnimationBehavior animationBehavior; final AnimationBehavior animationBehavior;
/// Returns an [Animation<double>] for this animation controller, so that a /// Returns an [Animation<double>] for this animation controller, so that a
...@@ -715,7 +715,7 @@ class AnimationController extends Animation<double> ...@@ -715,7 +715,7 @@ class AnimationController extends Animation<double>
/// ///
/// The values from the simulation are clamped to the [lowerBound] and /// The values from the simulation are clamped to the [lowerBound] and
/// [upperBound]. To avoid this, consider creating the [AnimationController] /// [upperBound]. To avoid this, consider creating the [AnimationController]
/// using the [new AnimationController.unbounded] constructor. /// using the [AnimationController.unbounded] constructor.
/// ///
/// Returns a [TickerFuture] that completes when the animation is complete. /// Returns a [TickerFuture] that completes when the animation is complete.
/// ///
......
...@@ -689,7 +689,7 @@ class CatmullRomSpline extends Curve2D { ...@@ -689,7 +689,7 @@ class CatmullRomSpline extends Curve2D {
/// Constructs a centripetal Catmull-Rom spline curve. /// Constructs a centripetal Catmull-Rom spline curve.
/// ///
/// The same as [new CatmullRomSpline], except that the internal data /// The same as [CatmullRomSpline.new], except that the internal data
/// structures are precomputed instead of being computed lazily. /// structures are precomputed instead of being computed lazily.
CatmullRomSpline.precompute( CatmullRomSpline.precompute(
List<Offset> controlPoints, { List<Offset> controlPoints, {
...@@ -826,7 +826,7 @@ class CatmullRomSpline extends Curve2D { ...@@ -826,7 +826,7 @@ class CatmullRomSpline extends Curve2D {
/// ///
/// * [CatmullRomSpline], the 2D spline that this curve uses to generate its values. /// * [CatmullRomSpline], the 2D spline that this curve uses to generate its values.
/// * A Wikipedia article on [centripetal Catmull-Rom splines](https://en.wikipedia.org/wiki/Centripetal_Catmull%E2%80%93Rom_spline). /// * A Wikipedia article on [centripetal Catmull-Rom splines](https://en.wikipedia.org/wiki/Centripetal_Catmull%E2%80%93Rom_spline).
/// * [new CatmullRomCurve] for a description of the constraints put on the /// * [CatmullRomCurve.new] for a description of the constraints put on the
/// input control points. /// input control points.
/// * This [paper on using Catmull-Rom splines](http://faculty.cs.tamu.edu/schaefer/research/cr_cad.pdf). /// * This [paper on using Catmull-Rom splines](http://faculty.cs.tamu.edu/schaefer/research/cr_cad.pdf).
class CatmullRomCurve extends Curve { class CatmullRomCurve extends Curve {
...@@ -868,7 +868,7 @@ class CatmullRomCurve extends Curve { ...@@ -868,7 +868,7 @@ class CatmullRomCurve extends Curve {
/// Constructs a centripetal [CatmullRomCurve]. /// Constructs a centripetal [CatmullRomCurve].
/// ///
/// Same as [new CatmullRomCurve], but it precomputes the internal curve data /// Same as [CatmullRomCurve.new], but it precomputes the internal curve data
/// structures for a more predictable computation load. /// structures for a more predictable computation load.
CatmullRomCurve.precompute(this.controlPoints, {this.tension = 0.0}) CatmullRomCurve.precompute(this.controlPoints, {this.tension = 0.0})
: assert(tension != null), : assert(tension != null),
...@@ -943,7 +943,7 @@ class CatmullRomCurve extends Curve { ...@@ -943,7 +943,7 @@ class CatmullRomCurve extends Curve {
/// well-formed and will not produce a spline that self-intersects. /// well-formed and will not produce a spline that self-intersects.
/// ///
/// This method is also used in debug mode to validate a curve to make sure /// This method is also used in debug mode to validate a curve to make sure
/// that it won't violate the contract for the [new CatmullRomCurve] /// that it won't violate the contract for the [CatmullRomCurve.new]
/// constructor. /// constructor.
/// ///
/// If in debug mode, and `reasons` is non-null, this function will fill in /// If in debug mode, and `reasons` is non-null, this function will fill in
......
...@@ -42,7 +42,7 @@ import 'text_field.dart'; ...@@ -42,7 +42,7 @@ import 'text_field.dart';
/// resources used by the object. /// resources used by the object.
/// ///
/// For documentation about the various parameters, see the /// For documentation about the various parameters, see the
/// [CupertinoTextField] class and [new CupertinoTextField.borderless], /// [CupertinoTextField] class and [CupertinoTextField.borderless],
/// the constructor. /// the constructor.
/// ///
/// {@tool snippet} /// {@tool snippet}
...@@ -96,7 +96,7 @@ class CupertinoTextFormFieldRow extends FormField<String> { ...@@ -96,7 +96,7 @@ class CupertinoTextFormFieldRow extends FormField<String> {
/// insets are intended, explicitly pass [EdgeInsets.zero] to [padding]. /// insets are intended, explicitly pass [EdgeInsets.zero] to [padding].
/// ///
/// For documentation about the various parameters, see the /// For documentation about the various parameters, see the
/// [CupertinoTextField] class and [new CupertinoTextField.borderless], /// [CupertinoTextField] class and [CupertinoTextField.borderless],
/// the constructor. /// the constructor.
CupertinoTextFormFieldRow({ CupertinoTextFormFieldRow({
Key? key, Key? key,
......
...@@ -774,10 +774,10 @@ class FlutterError extends Error with DiagnosticableTreeMixin implements Asserti ...@@ -774,10 +774,10 @@ class FlutterError extends Error with DiagnosticableTreeMixin implements Asserti
/// All sentences in the error should be correctly punctuated (i.e., /// All sentences in the error should be correctly punctuated (i.e.,
/// do end the error message with a period). /// do end the error message with a period).
/// ///
/// This constructor defers to the [new FlutterError.fromParts] constructor. /// This constructor defers to the [FlutterError.fromParts] constructor.
/// The first line is wrapped in an implied [ErrorSummary], and subsequent /// The first line is wrapped in an implied [ErrorSummary], and subsequent
/// lines are wrapped in implied [ErrorDescription]s. Consider using the /// lines are wrapped in implied [ErrorDescription]s. Consider using the
/// [new FlutterError.fromParts] constructor to provide more detail, e.g. /// [FlutterError.fromParts] constructor to provide more detail, e.g.
/// using [ErrorHint]s or other [DiagnosticsNode]s. /// using [ErrorHint]s or other [DiagnosticsNode]s.
factory FlutterError(String message) { factory FlutterError(String message) {
final List<String> lines = message.split('\n'); final List<String> lines = message.split('\n');
......
...@@ -47,7 +47,7 @@ import 'diagnostics.dart'; ...@@ -47,7 +47,7 @@ import 'diagnostics.dart';
/// * [InheritedNotifier], an abstract superclass for widgets that use a /// * [InheritedNotifier], an abstract superclass for widgets that use a
/// [Listenable]'s notifications to trigger rebuilds in descendant widgets /// [Listenable]'s notifications to trigger rebuilds in descendant widgets
/// that declare a dependency on them, using the [InheritedWidget] mechanism. /// that declare a dependency on them, using the [InheritedWidget] mechanism.
/// * [new Listenable.merge], which creates a [Listenable] that triggers /// * [Listenable.merge], which creates a [Listenable] that triggers
/// notifications whenever any of a list of other [Listenable]s trigger their /// notifications whenever any of a list of other [Listenable]s trigger their
/// notifications. /// notifications.
abstract class Listenable { abstract class Listenable {
......
...@@ -3501,7 +3501,7 @@ abstract class DiagnosticableTree with Diagnosticable { ...@@ -3501,7 +3501,7 @@ abstract class DiagnosticableTree with Diagnosticable {
/// [DiagnosticsTreeStyle.offstage] to indicate that they are offstage. /// [DiagnosticsTreeStyle.offstage] to indicate that they are offstage.
/// ///
/// The list must not contain any null entries. If there are explicit null /// The list must not contain any null entries. If there are explicit null
/// children to report, consider [new DiagnosticsNode.message] or /// children to report, consider [DiagnosticsNode.message] or
/// [DiagnosticsProperty<Object>] as possible [DiagnosticsNode] objects to /// [DiagnosticsProperty<Object>] as possible [DiagnosticsNode] objects to
/// provide. /// provide.
/// ///
......
...@@ -27,7 +27,7 @@ abstract class Key { ...@@ -27,7 +27,7 @@ abstract class Key {
/// Default constructor, used by subclasses. /// Default constructor, used by subclasses.
/// ///
/// Useful so that subclasses can call us, because the [new Key] factory /// Useful so that subclasses can call us, because the [Key.new] factory
/// constructor shadows the implicit constructor. /// constructor shadows the implicit constructor.
@protected @protected
const Key.empty(); const Key.empty();
......
...@@ -6,7 +6,7 @@ import 'dart:async'; ...@@ -6,7 +6,7 @@ import 'dart:async';
/// A [Future] whose [then] implementation calls the callback immediately. /// A [Future] whose [then] implementation calls the callback immediately.
/// ///
/// This is similar to [new Future.value], except that the value is available in /// This is similar to [Future.value], except that the value is available in
/// the same event-loop iteration. /// the same event-loop iteration.
/// ///
/// ⚠ This class is useful in cases where you want to expose a single API, where /// ⚠ This class is useful in cases where you want to expose a single API, where
...@@ -19,7 +19,7 @@ class SynchronousFuture<T> implements Future<T> { ...@@ -19,7 +19,7 @@ class SynchronousFuture<T> implements Future<T> {
/// ///
/// See also: /// See also:
/// ///
/// * [new Future.value] for information about creating a regular /// * [Future.value] for information about creating a regular
/// [Future] that completes with a value. /// [Future] that completes with a value.
SynchronousFuture(this._value); SynchronousFuture(this._value);
......
...@@ -17,7 +17,7 @@ class MaterialColor extends ColorSwatch<int> { ...@@ -17,7 +17,7 @@ class MaterialColor extends ColorSwatch<int> {
/// Creates a color swatch with a variety of shades. /// Creates a color swatch with a variety of shades.
/// ///
/// The `primary` argument should be the 32 bit ARGB value of one of the /// The `primary` argument should be the 32 bit ARGB value of one of the
/// values in the swatch, as would be passed to the [new Color] constructor /// values in the swatch, as would be passed to the [Color.new] constructor
/// for that same color, and as is exposed by [value]. (This is distinct from /// for that same color, and as is exposed by [value]. (This is distinct from
/// the specific index of the color in the swatch.) /// the specific index of the color in the swatch.)
const MaterialColor(int primary, Map<int, Color> swatch) : super(primary, swatch); const MaterialColor(int primary, Map<int, Color> swatch) : super(primary, swatch);
......
...@@ -28,7 +28,7 @@ typedef DataColumnSortCallback = void Function(int columnIndex, bool ascending); ...@@ -28,7 +28,7 @@ typedef DataColumnSortCallback = void Function(int columnIndex, bool ascending);
/// ///
/// One column configuration must be provided for each column to /// One column configuration must be provided for each column to
/// display in the table. The list of [DataColumn] objects is passed /// display in the table. The list of [DataColumn] objects is passed
/// as the `columns` argument to the [new DataTable] constructor. /// as the `columns` argument to the [DataTable.new] constructor.
@immutable @immutable
class DataColumn { class DataColumn {
/// Creates the configuration for a column of a [DataTable]. /// Creates the configuration for a column of a [DataTable].
...@@ -81,7 +81,7 @@ class DataColumn { ...@@ -81,7 +81,7 @@ class DataColumn {
/// ///
/// One row configuration must be provided for each row to /// One row configuration must be provided for each row to
/// display in the table. The list of [DataRow] objects is passed /// display in the table. The list of [DataRow] objects is passed
/// as the `rows` argument to the [new DataTable] constructor. /// as the `rows` argument to the [DataTable.new] constructor.
/// ///
/// The data for this row of the table is provided in the [cells] /// The data for this row of the table is provided in the [cells]
/// property of the [DataRow] object. /// property of the [DataRow] object.
......
...@@ -21,7 +21,7 @@ import 'data_table.dart'; ...@@ -21,7 +21,7 @@ import 'data_table.dart';
abstract class DataTableSource extends ChangeNotifier { abstract class DataTableSource extends ChangeNotifier {
/// Called to obtain the data about a particular row. /// Called to obtain the data about a particular row.
/// ///
/// The [new DataRow.byIndex] constructor provides a convenient way to construct /// The [DataRow.byIndex] constructor provides a convenient way to construct
/// [DataRow] objects for this callback's purposes without having to worry about /// [DataRow] objects for this callback's purposes without having to worry about
/// independently keying each row. /// independently keying each row.
/// ///
......
...@@ -93,7 +93,7 @@ class TextFormField extends FormField<String> { ...@@ -93,7 +93,7 @@ class TextFormField extends FormField<String> {
/// to [initialValue] or the empty string. /// to [initialValue] or the empty string.
/// ///
/// For documentation about the various parameters, see the [TextField] class /// For documentation about the various parameters, see the [TextField] class
/// and [new TextField], the constructor. /// and [TextField.new], the constructor.
TextFormField({ TextFormField({
Key? key, Key? key,
this.controller, this.controller,
......
...@@ -63,7 +63,7 @@ class Theme extends StatelessWidget { ...@@ -63,7 +63,7 @@ class Theme extends StatelessWidget {
/// [MaterialLocalizations], the returned data is localized according to the /// [MaterialLocalizations], the returned data is localized according to the
/// nearest available [MaterialLocalizations]. /// nearest available [MaterialLocalizations].
/// ///
/// Defaults to [new ThemeData.fallback] if there is no [Theme] in the given /// Defaults to [ThemeData.fallback] if there is no [Theme] in the given
/// build context. /// build context.
/// ///
/// Typical usage is as follows: /// Typical usage is as follows:
......
...@@ -11,8 +11,8 @@ import 'basic_types.dart'; ...@@ -11,8 +11,8 @@ import 'basic_types.dart';
/// Base class for [Alignment] that allows for text-direction aware /// Base class for [Alignment] that allows for text-direction aware
/// resolution. /// resolution.
/// ///
/// A property or argument of this type accepts classes created either with [new /// A property or argument of this type accepts classes created either with [
/// Alignment] and its variants, or [new AlignmentDirectional]. /// Alignment] and its variants, or [AlignmentDirectional.new].
/// ///
/// To convert an [AlignmentGeometry] object of indeterminate type into an /// To convert an [AlignmentGeometry] object of indeterminate type into an
/// [Alignment] object, call the [resolve] method. /// [Alignment] object, call the [resolve] method.
......
...@@ -8,8 +8,8 @@ import 'basic_types.dart'; ...@@ -8,8 +8,8 @@ import 'basic_types.dart';
/// Base class for [BorderRadius] that allows for text-direction aware resolution. /// Base class for [BorderRadius] that allows for text-direction aware resolution.
/// ///
/// A property or argument of this type accepts classes created either with [new /// A property or argument of this type accepts classes created either with [
/// BorderRadius.only] and its variants, or [new BorderRadiusDirectional.only] /// BorderRadius.only] and its variants, or [BorderRadiusDirectional.only]
/// and its variants. /// and its variants.
/// ///
/// To convert a [BorderRadiusGeometry] object of indeterminate type into a /// To convert a [BorderRadiusGeometry] object of indeterminate type into a
......
...@@ -430,7 +430,7 @@ class ColorSwatch<T> extends Color { ...@@ -430,7 +430,7 @@ class ColorSwatch<T> extends Color {
/// Creates a color that has a small table of related colors called a "swatch". /// Creates a color that has a small table of related colors called a "swatch".
/// ///
/// The `primary` argument should be the 32 bit ARGB value of one of the /// The `primary` argument should be the 32 bit ARGB value of one of the
/// values in the swatch, as would be passed to the [new Color] constructor /// values in the swatch, as would be passed to the [Color.new] constructor
/// for that same color, and as is exposed by [value]. (This is distinct from /// for that same color, and as is exposed by [value]. (This is distinct from
/// the specific index of the color in the swatch.) /// the specific index of the color in the swatch.)
const ColorSwatch(int primary, this._swatch) : super(primary); const ColorSwatch(int primary, this._swatch) : super(primary);
......
...@@ -11,8 +11,8 @@ import 'basic_types.dart'; ...@@ -11,8 +11,8 @@ import 'basic_types.dart';
/// Base class for [EdgeInsets] that allows for text-direction aware /// Base class for [EdgeInsets] that allows for text-direction aware
/// resolution. /// resolution.
/// ///
/// A property or argument of this type accepts classes created either with [new /// A property or argument of this type accepts classes created either with [
/// EdgeInsets.fromLTRB] and its variants, or [new /// EdgeInsets.fromLTRB] and its variants, or [
/// EdgeInsetsDirectional.fromSTEB] and its variants. /// EdgeInsetsDirectional.fromSTEB] and its variants.
/// ///
/// To convert an [EdgeInsetsGeometry] object of indeterminate type into a /// To convert an [EdgeInsetsGeometry] object of indeterminate type into a
......
...@@ -77,7 +77,7 @@ class FractionalOffset extends Alignment { ...@@ -77,7 +77,7 @@ class FractionalOffset extends Alignment {
/// ///
/// The offset is assumed to be relative to the same origin as the rectangle. /// The offset is assumed to be relative to the same origin as the rectangle.
/// ///
/// If the offset is relative to the top left of the rectangle, use [new /// If the offset is relative to the top left of the rectangle, use [
/// FractionalOffset.fromOffsetAndSize] instead, passing `rect.size`. /// FractionalOffset.fromOffsetAndSize] instead, passing `rect.size`.
/// ///
/// The returned [FractionalOffset] describes the position of the /// The returned [FractionalOffset] describes the position of the
......
...@@ -327,13 +327,13 @@ abstract class Gradient { ...@@ -327,13 +327,13 @@ abstract class Gradient {
/// A 2D linear gradient. /// A 2D linear gradient.
/// ///
/// This class is used by [BoxDecoration] to represent linear gradients. This /// This class is used by [BoxDecoration] to represent linear gradients. This
/// abstracts out the arguments to the [new ui.Gradient.linear] constructor from /// abstracts out the arguments to the [ui.Gradient.linear] constructor from
/// the `dart:ui` library. /// the `dart:ui` library.
/// ///
/// A gradient has two anchor points, [begin] and [end]. The [begin] point /// A gradient has two anchor points, [begin] and [end]. The [begin] point
/// corresponds to 0.0, and the [end] point corresponds to 1.0. These points are /// corresponds to 0.0, and the [end] point corresponds to 1.0. These points are
/// expressed in fractions, so that the same gradient can be reused with varying /// expressed in fractions, so that the same gradient can be reused with varying
/// sized boxes without changing the parameters. (This contrasts with [new /// sized boxes without changing the parameters. (This contrasts with [
/// ui.Gradient.linear], whose arguments are expressed in logical pixels.) /// ui.Gradient.linear], whose arguments are expressed in logical pixels.)
/// ///
/// The [colors] are described by a list of [Color] objects. There must be at /// The [colors] are described by a list of [Color] objects. There must be at
...@@ -546,14 +546,14 @@ class LinearGradient extends Gradient { ...@@ -546,14 +546,14 @@ class LinearGradient extends Gradient {
/// A 2D radial gradient. /// A 2D radial gradient.
/// ///
/// This class is used by [BoxDecoration] to represent radial gradients. This /// This class is used by [BoxDecoration] to represent radial gradients. This
/// abstracts out the arguments to the [new ui.Gradient.radial] constructor from /// abstracts out the arguments to the [ui.Gradient.radial] constructor from
/// the `dart:ui` library. /// the `dart:ui` library.
/// ///
/// A normal radial gradient has a [center] and a [radius]. The [center] point /// A normal radial gradient has a [center] and a [radius]. The [center] point
/// corresponds to 0.0, and the ring at [radius] from the center corresponds /// corresponds to 0.0, and the ring at [radius] from the center corresponds
/// to 1.0. These lengths are expressed in fractions, so that the same gradient /// to 1.0. These lengths are expressed in fractions, so that the same gradient
/// can be reused with varying sized boxes without changing the parameters. /// can be reused with varying sized boxes without changing the parameters.
/// (This contrasts with [new ui.Gradient.radial], whose arguments are expressed /// (This contrasts with [ui.Gradient.radial], whose arguments are expressed
/// in logical pixels.) /// in logical pixels.)
/// ///
/// It is also possible to create a two-point (or focal pointed) radial gradient /// It is also possible to create a two-point (or focal pointed) radial gradient
...@@ -831,7 +831,7 @@ class RadialGradient extends Gradient { ...@@ -831,7 +831,7 @@ class RadialGradient extends Gradient {
/// A 2D sweep gradient. /// A 2D sweep gradient.
/// ///
/// This class is used by [BoxDecoration] to represent sweep gradients. This /// This class is used by [BoxDecoration] to represent sweep gradients. This
/// abstracts out the arguments to the [new ui.Gradient.sweep] constructor from /// abstracts out the arguments to the [ui.Gradient.sweep] constructor from
/// the `dart:ui` library. /// the `dart:ui` library.
/// ///
/// A gradient has a [center], a [startAngle], and an [endAngle]. The [startAngle] /// A gradient has a [center], a [startAngle], and an [endAngle]. The [startAngle]
......
...@@ -777,7 +777,7 @@ class OneFrameImageStreamCompleter extends ImageStreamCompleter { ...@@ -777,7 +777,7 @@ class OneFrameImageStreamCompleter extends ImageStreamCompleter {
/// ///
/// Errors are reported using [FlutterError.reportError] with the `silent` /// Errors are reported using [FlutterError.reportError] with the `silent`
/// argument on [FlutterErrorDetails] set to true, meaning that by default the /// argument on [FlutterErrorDetails] set to true, meaning that by default the
/// message is only dumped to the console in debug mode (see [new /// message is only dumped to the console in debug mode (see [
/// FlutterErrorDetails]). /// FlutterErrorDetails]).
OneFrameImageStreamCompleter(Future<ImageInfo> image, { InformationCollector? informationCollector }) OneFrameImageStreamCompleter(Future<ImageInfo> image, { InformationCollector? informationCollector })
: assert(image != null) { : assert(image != null) {
......
...@@ -48,7 +48,7 @@ class SpringDescription { ...@@ -48,7 +48,7 @@ class SpringDescription {
/// The damping coefficient (c). /// The damping coefficient (c).
/// ///
/// Do not confuse the damping _coefficient_ (c) with the damping _ratio_ (ζ). /// Do not confuse the damping _coefficient_ (c) with the damping _ratio_ (ζ).
/// To create a [SpringDescription] with a damping ratio, use the [new /// To create a [SpringDescription] with a damping ratio, use the [
/// SpringDescription.withDampingRatio] constructor. /// SpringDescription.withDampingRatio] constructor.
/// ///
/// The units of the damping coefficient are M/T, where M is the mass unit /// The units of the damping coefficient are M/T, where M is the mass unit
...@@ -104,7 +104,7 @@ class SpringSimulation extends Simulation { ...@@ -104,7 +104,7 @@ class SpringSimulation extends Simulation {
/// The kind of spring being simulated, for debugging purposes. /// The kind of spring being simulated, for debugging purposes.
/// ///
/// This is derived from the [SpringDescription] provided to the [new /// This is derived from the [SpringDescription] provided to the [
/// SpringSimulation] constructor. /// SpringSimulation] constructor.
SpringType get type => _solution.type; SpringType get type => _solution.type;
...@@ -130,7 +130,7 @@ class ScrollSpringSimulation extends SpringSimulation { ...@@ -130,7 +130,7 @@ class ScrollSpringSimulation extends SpringSimulation {
/// Creates a spring simulation from the provided spring description, start /// Creates a spring simulation from the provided spring description, start
/// distance, end distance, and initial velocity. /// distance, end distance, and initial velocity.
/// ///
/// See the [new SpringSimulation] constructor on the superclass for a /// See the [SpringSimulation.new] constructor on the superclass for a
/// discussion of the arguments' units. /// discussion of the arguments' units.
ScrollSpringSimulation( ScrollSpringSimulation(
SpringDescription spring, SpringDescription spring,
......
...@@ -61,20 +61,20 @@ class _DebugSize extends Size { ...@@ -61,20 +61,20 @@ class _DebugSize extends Size {
/// ## Terminology /// ## Terminology
/// ///
/// When the minimum constraints and the maximum constraint in an axis are the /// When the minimum constraints and the maximum constraint in an axis are the
/// same, that axis is _tightly_ constrained. See: [new /// same, that axis is _tightly_ constrained. See: [
/// BoxConstraints.tightFor], [new BoxConstraints.tightForFinite], [tighten], /// BoxConstraints.tightFor], [BoxConstraints.tightForFinite], [tighten],
/// [hasTightWidth], [hasTightHeight], [isTight]. /// [hasTightWidth], [hasTightHeight], [isTight].
/// ///
/// An axis with a minimum constraint of 0.0 is _loose_ (regardless of the /// An axis with a minimum constraint of 0.0 is _loose_ (regardless of the
/// maximum constraint; if it is also 0.0, then the axis is simultaneously tight /// maximum constraint; if it is also 0.0, then the axis is simultaneously tight
/// and loose!). See: [new BoxConstraints.loose], [loosen]. /// and loose!). See: [BoxConstraints.loose], [loosen].
/// ///
/// An axis whose maximum constraint is not infinite is _bounded_. See: /// An axis whose maximum constraint is not infinite is _bounded_. See:
/// [hasBoundedWidth], [hasBoundedHeight]. /// [hasBoundedWidth], [hasBoundedHeight].
/// ///
/// An axis whose maximum constraint is infinite is _unbounded_. An axis is /// An axis whose maximum constraint is infinite is _unbounded_. An axis is
/// _expanding_ if it is tightly infinite (its minimum and maximum constraints /// _expanding_ if it is tightly infinite (its minimum and maximum constraints
/// are both infinite). See: [new BoxConstraints.expand]. /// are both infinite). See: [BoxConstraints.expand].
/// ///
/// An axis whose _minimum_ constraint is infinite is just said to be _infinite_ /// An axis whose _minimum_ constraint is infinite is just said to be _infinite_
/// (since by definition the maximum constraint must also be infinite in that /// (since by definition the maximum constraint must also be infinite in that
...@@ -107,7 +107,7 @@ class BoxConstraints extends Constraints { ...@@ -107,7 +107,7 @@ class BoxConstraints extends Constraints {
/// ///
/// See also: /// See also:
/// ///
/// * [new BoxConstraints.tightForFinite], which is similar but instead of /// * [BoxConstraints.tightForFinite], which is similar but instead of
/// being tight if the value is non-null, is tight if the value is not /// being tight if the value is non-null, is tight if the value is not
/// infinite. /// infinite.
const BoxConstraints.tightFor({ const BoxConstraints.tightFor({
...@@ -123,7 +123,7 @@ class BoxConstraints extends Constraints { ...@@ -123,7 +123,7 @@ class BoxConstraints extends Constraints {
/// ///
/// See also: /// See also:
/// ///
/// * [new BoxConstraints.tightFor], which is similar but instead of being /// * [BoxConstraints.tightFor], which is similar but instead of being
/// tight if the value is not infinite, is tight if the value is non-null. /// tight if the value is not infinite, is tight if the value is non-null.
const BoxConstraints.tightForFinite({ const BoxConstraints.tightForFinite({
double width = double.infinity, double width = double.infinity,
......
...@@ -234,7 +234,7 @@ class RenderEditable extends RenderBox with RelayoutWhenSystemFontsChangeMixin, ...@@ -234,7 +234,7 @@ class RenderEditable extends RenderBox with RelayoutWhenSystemFontsChangeMixin,
/// the number of lines. By default, it is 1, meaning this is a single-line /// the number of lines. By default, it is 1, meaning this is a single-line
/// text field. If it is not null, it must be greater than zero. /// text field. If it is not null, it must be greater than zero.
/// ///
/// The [offset] is required and must not be null. You can use [new /// The [offset] is required and must not be null. You can use [
/// ViewportOffset.zero] if you have no need for scrolling. /// ViewportOffset.zero] if you have no need for scrolling.
RenderEditable({ RenderEditable({
InlineSpan? text, InlineSpan? text,
......
...@@ -1051,7 +1051,7 @@ typedef ShaderCallback = Shader Function(Rect bounds); ...@@ -1051,7 +1051,7 @@ typedef ShaderCallback = Shader Function(Rect bounds);
/// Applies a mask generated by a [Shader] to its child. /// Applies a mask generated by a [Shader] to its child.
/// ///
/// For example, [RenderShaderMask] can be used to gradually fade out the edge /// For example, [RenderShaderMask] can be used to gradually fade out the edge
/// of a child by using a [new ui.Gradient.linear] mask. /// of a child by using a [ui.Gradient.linear] mask.
class RenderShaderMask extends RenderProxyBox { class RenderShaderMask extends RenderProxyBox {
/// Creates a render object that applies a mask generated by a [Shader] to its child. /// Creates a render object that applies a mask generated by a [Shader] to its child.
/// ///
...@@ -1144,7 +1144,7 @@ class RenderBackdropFilter extends RenderProxyBox { ...@@ -1144,7 +1144,7 @@ class RenderBackdropFilter extends RenderProxyBox {
/// The image filter to apply to the existing painted content before painting /// The image filter to apply to the existing painted content before painting
/// the child. /// the child.
/// ///
/// For example, consider using [new ui.ImageFilter.blur] to create a backdrop /// For example, consider using [ui.ImageFilter.blur] to create a backdrop
/// blur effect. /// blur effect.
ui.ImageFilter get filter => _filter; ui.ImageFilter get filter => _filter;
ui.ImageFilter _filter; ui.ImageFilter _filter;
...@@ -5303,7 +5303,7 @@ class RenderFollowerLayer extends RenderProxyBox { ...@@ -5303,7 +5303,7 @@ class RenderFollowerLayer extends RenderProxyBox {
/// If the [FollowerLayer] has not yet been created, was never composited, or /// If the [FollowerLayer] has not yet been created, was never composited, or
/// was unable to determine the transform (see /// was unable to determine the transform (see
/// [FollowerLayer.getLastTransform]), this returns the identity matrix (see /// [FollowerLayer.getLastTransform]), this returns the identity matrix (see
/// [new Matrix4.identity]. /// [Matrix4.identity].
Matrix4 getCurrentTransform() { Matrix4 getCurrentTransform() {
return layer?.getLastTransform() ?? Matrix4.identity(); return layer?.getLastTransform() ?? Matrix4.identity();
} }
......
...@@ -1254,7 +1254,7 @@ class RenderViewport extends RenderViewportBase<SliverPhysicalContainerParentDat ...@@ -1254,7 +1254,7 @@ class RenderViewport extends RenderViewportBase<SliverPhysicalContainerParentDat
/// list, if any, is used. /// list, if any, is used.
/// ///
/// The [offset] must be specified. For testing purposes, consider passing a /// The [offset] must be specified. For testing purposes, consider passing a
/// [new ViewportOffset.zero] or [new ViewportOffset.fixed]. /// [ViewportOffset.zero] or [ViewportOffset.fixed].
RenderViewport({ RenderViewport({
AxisDirection axisDirection = AxisDirection.down, AxisDirection axisDirection = AxisDirection.down,
required AxisDirection crossAxisDirection, required AxisDirection crossAxisDirection,
...@@ -1791,7 +1791,7 @@ class RenderShrinkWrappingViewport extends RenderViewportBase<SliverLogicalConta ...@@ -1791,7 +1791,7 @@ class RenderShrinkWrappingViewport extends RenderViewportBase<SliverLogicalConta
/// contents. /// contents.
/// ///
/// The [offset] must be specified. For testing purposes, consider passing a /// The [offset] must be specified. For testing purposes, consider passing a
/// [new ViewportOffset.zero] or [new ViewportOffset.fixed]. /// [ViewportOffset.zero] or [ViewportOffset.fixed].
RenderShrinkWrappingViewport({ RenderShrinkWrappingViewport({
AxisDirection axisDirection = AxisDirection.down, AxisDirection axisDirection = AxisDirection.down,
required AxisDirection crossAxisDirection, required AxisDirection crossAxisDirection,
......
...@@ -238,7 +238,7 @@ class SystemChannels { ...@@ -238,7 +238,7 @@ class SystemChannels {
/// See also: /// See also:
/// ///
/// * [RawKeyboard], which uses this channel to expose key data. /// * [RawKeyboard], which uses this channel to expose key data.
/// * [new RawKeyEvent.fromMessage], which can decode this data into the [RawKeyEvent] /// * [RawKeyEvent.fromMessage], which can decode this data into the [RawKeyEvent]
/// subclasses mentioned above. /// subclasses mentioned above.
static const BasicMessageChannel<Object?> keyEvent = BasicMessageChannel<Object?>( static const BasicMessageChannel<Object?> keyEvent = BasicMessageChannel<Object?>(
'flutter/keyevent', 'flutter/keyevent',
......
...@@ -124,7 +124,7 @@ class TextInputType { ...@@ -124,7 +124,7 @@ class TextInputType {
/// ///
/// Requests a default keyboard with ready access to the number keys. /// Requests a default keyboard with ready access to the number keys.
/// Additional options, such as decimal point and/or positive/negative /// Additional options, such as decimal point and/or positive/negative
/// signs, can be requested using [new TextInputType.numberWithOptions]. /// signs, can be requested using [TextInputType.numberWithOptions].
static const TextInputType number = TextInputType.numberWithOptions(); static const TextInputType number = TextInputType.numberWithOptions();
/// Optimize for telephone numbers. /// Optimize for telephone numbers.
......
...@@ -63,7 +63,7 @@ typedef LocaleListResolutionCallback = Locale? Function(List<Locale>? locales, I ...@@ -63,7 +63,7 @@ typedef LocaleListResolutionCallback = Locale? Function(List<Locale>? locales, I
/// locale for the device after [LocaleListResolutionCallback] fails or is not provided. /// locale for the device after [LocaleListResolutionCallback] fails or is not provided.
/// ///
/// This callback is also used if the app is created with a specific locale using /// This callback is also used if the app is created with a specific locale using
/// the [new WidgetsApp] `locale` parameter. /// the [WidgetsApp.new] `locale` parameter.
/// ///
/// The [locale] is either the value of [WidgetsApp.locale], or the device's default /// The [locale] is either the value of [WidgetsApp.locale], or the device's default
/// locale when the app started, or the device locale the user selected after the app /// locale when the app started, or the device locale the user selected after the app
......
...@@ -304,7 +304,7 @@ class Opacity extends SingleChildRenderObjectWidget { ...@@ -304,7 +304,7 @@ class Opacity extends SingleChildRenderObjectWidget {
/// A widget that applies a mask generated by a [Shader] to its child. /// A widget that applies a mask generated by a [Shader] to its child.
/// ///
/// For example, [ShaderMask] can be used to gradually fade out the edge /// For example, [ShaderMask] can be used to gradually fade out the edge
/// of a child by using a [new ui.Gradient.linear] mask. /// of a child by using a [ui.Gradient.linear] mask.
/// ///
/// {@youtube 560 315 https://www.youtube.com/watch?v=7sUL66pTQ7Q} /// {@youtube 560 315 https://www.youtube.com/watch?v=7sUL66pTQ7Q}
/// ///
...@@ -1640,7 +1640,7 @@ class FittedBox extends SingleChildRenderObjectWidget { ...@@ -1640,7 +1640,7 @@ class FittedBox extends SingleChildRenderObjectWidget {
/// ///
/// * [Transform], which applies an arbitrary transform to its child widget at /// * [Transform], which applies an arbitrary transform to its child widget at
/// paint time. /// paint time.
/// * [new Transform.translate], which applies an absolute offset translation /// * [Transform.translate], which applies an absolute offset translation
/// transformation instead of an offset scaled to the child. /// transformation instead of an offset scaled to the child.
/// * The [catalog of layout widgets](https://flutter.dev/widgets/layout/). /// * The [catalog of layout widgets](https://flutter.dev/widgets/layout/).
class FractionalTranslation extends SingleChildRenderObjectWidget { class FractionalTranslation extends SingleChildRenderObjectWidget {
...@@ -1705,7 +1705,7 @@ class FractionalTranslation extends SingleChildRenderObjectWidget { ...@@ -1705,7 +1705,7 @@ class FractionalTranslation extends SingleChildRenderObjectWidget {
/// ///
/// * [Transform], which is a paint effect that allows you to apply an /// * [Transform], which is a paint effect that allows you to apply an
/// arbitrary transform to a child. /// arbitrary transform to a child.
/// * [new Transform.rotate], which applies a rotation paint effect. /// * [Transform.rotate], which applies a rotation paint effect.
/// * The [catalog of layout widgets](https://flutter.dev/widgets/layout/). /// * The [catalog of layout widgets](https://flutter.dev/widgets/layout/).
class RotatedBox extends SingleChildRenderObjectWidget { class RotatedBox extends SingleChildRenderObjectWidget {
/// A widget that rotates its child. /// A widget that rotates its child.
...@@ -2207,7 +2207,7 @@ class CustomMultiChildLayout extends MultiChildRenderObjectWidget { ...@@ -2207,7 +2207,7 @@ class CustomMultiChildLayout extends MultiChildRenderObjectWidget {
/// specified height and width as possible given the parent's constraints. If /// specified height and width as possible given the parent's constraints. If
/// [height] or [width] is null or unspecified, it will be treated as zero. /// [height] or [width] is null or unspecified, it will be treated as zero.
/// ///
/// The [new SizedBox.expand] constructor can be used to make a [SizedBox] that /// The [SizedBox.expand] constructor can be used to make a [SizedBox] that
/// sizes itself to fit the parent. It is equivalent to setting [width] and /// sizes itself to fit the parent. It is equivalent to setting [width] and
/// [height] to [double.infinity]. /// [height] to [double.infinity].
/// ///
...@@ -2344,7 +2344,7 @@ class SizedBox extends SingleChildRenderObjectWidget { ...@@ -2344,7 +2344,7 @@ class SizedBox extends SingleChildRenderObjectWidget {
/// ``` /// ```
/// {@end-tool} /// {@end-tool}
/// ///
/// The same behavior can be obtained using the [new SizedBox.expand] widget. /// The same behavior can be obtained using the [SizedBox.expand] widget.
/// ///
/// See also: /// See also:
/// ///
......
...@@ -17,7 +17,7 @@ import 'implicit_animations.dart'; ...@@ -17,7 +17,7 @@ import 'implicit_animations.dart';
/// An image that shows a [placeholder] image while the target [image] is /// An image that shows a [placeholder] image while the target [image] is
/// loading, then fades in the new image when it loads. /// loading, then fades in the new image when it loads.
/// ///
/// Use this class to display long-loading images, such as [new NetworkImage], /// Use this class to display long-loading images, such as [NetworkImage.new],
/// so that the image appears on screen with a graceful animation rather than /// so that the image appears on screen with a graceful animation rather than
/// abruptly popping onto the screen. /// abruptly popping onto the screen.
/// ///
...@@ -129,9 +129,9 @@ class FadeInImage extends StatefulWidget { ...@@ -129,9 +129,9 @@ class FadeInImage extends StatefulWidget {
/// ///
/// See also: /// See also:
/// ///
/// * [new Image.memory], which has more details about loading images from /// * [Image.memory], which has more details about loading images from
/// memory. /// memory.
/// * [new Image.network], which has more details about loading images from /// * [Image.network], which has more details about loading images from
/// the network. /// the network.
FadeInImage.memoryNetwork({ FadeInImage.memoryNetwork({
Key? key, Key? key,
...@@ -200,9 +200,9 @@ class FadeInImage extends StatefulWidget { ...@@ -200,9 +200,9 @@ class FadeInImage extends StatefulWidget {
/// ///
/// See also: /// See also:
/// ///
/// * [new Image.asset], which has more details about loading images from /// * [Image.asset], which has more details about loading images from
/// asset bundles. /// asset bundles.
/// * [new Image.network], which has more details about loading images from /// * [Image.network], which has more details about loading images from
/// the network. /// the network.
FadeInImage.assetNetwork({ FadeInImage.assetNetwork({
Key? key, Key? key,
......
...@@ -2446,7 +2446,7 @@ class BuildOwner { ...@@ -2446,7 +2446,7 @@ class BuildOwner {
/// This field will default to a [FocusManager] that has registered its /// This field will default to a [FocusManager] that has registered its
/// global input handlers via [FocusManager.registerGlobalHandlers]. Callers /// global input handlers via [FocusManager.registerGlobalHandlers]. Callers
/// wishing to avoid registering those handlers (and modifying the associated /// wishing to avoid registering those handlers (and modifying the associated
/// static state) can explicitly pass a focus manager to the [new BuildOwner] /// static state) can explicitly pass a focus manager to the [BuildOwner.new]
/// constructor. /// constructor.
FocusManager focusManager; FocusManager focusManager;
......
...@@ -15,7 +15,7 @@ import 'framework.dart' show BuildContext; ...@@ -15,7 +15,7 @@ import 'framework.dart' show BuildContext;
/// widget subtree. /// widget subtree.
/// ///
/// To obtain the current icon theme, use [IconTheme.of]. To convert an icon /// To obtain the current icon theme, use [IconTheme.of]. To convert an icon
/// theme to a version with all the fields filled in, use [new /// theme to a version with all the fields filled in, use [
/// IconThemeData.fallback]. /// IconThemeData.fallback].
@immutable @immutable
class IconThemeData with Diagnosticable { class IconThemeData with Diagnosticable {
......
...@@ -237,12 +237,12 @@ typedef ImageErrorWidgetBuilder = Widget Function( ...@@ -237,12 +237,12 @@ typedef ImageErrorWidgetBuilder = Widget Function(
/// Several constructors are provided for the various ways that an image can be /// Several constructors are provided for the various ways that an image can be
/// specified: /// specified:
/// ///
/// * [new Image], for obtaining an image from an [ImageProvider]. /// * [Image.new], for obtaining an image from an [ImageProvider].
/// * [new Image.asset], for obtaining an image from an [AssetBundle] /// * [Image.asset], for obtaining an image from an [AssetBundle]
/// using a key. /// using a key.
/// * [new Image.network], for obtaining an image from a URL. /// * [Image.network], for obtaining an image from a URL.
/// * [new Image.file], for obtaining an image from a [File]. /// * [Image.file], for obtaining an image from a [File].
/// * [new Image.memory], for obtaining an image from a [Uint8List]. /// * [Image.memory], for obtaining an image from a [Uint8List].
/// ///
/// The following image formats are supported: {@macro dart.ui.imageFormats} /// The following image formats are supported: {@macro dart.ui.imageFormats}
/// ///
...@@ -292,7 +292,7 @@ typedef ImageErrorWidgetBuilder = Widget Function( ...@@ -292,7 +292,7 @@ typedef ImageErrorWidgetBuilder = Widget Function(
/// See also: /// See also:
/// ///
/// * [Icon], which shows an image from a font. /// * [Icon], which shows an image from a font.
/// * [new Ink.image], which is the preferred way to show an image in a /// * [Ink.image], which is the preferred way to show an image in a
/// material application (especially if the image is in a [Material] and will /// material application (especially if the image is in a [Material] and will
/// have an [InkWell] on top of it). /// have an [InkWell] on top of it).
/// * [Image](dart-ui/Image-class.html), the class in the [dart:ui] library. /// * [Image](dart-ui/Image-class.html), the class in the [dart:ui] library.
...@@ -303,7 +303,7 @@ class Image extends StatefulWidget { ...@@ -303,7 +303,7 @@ class Image extends StatefulWidget {
/// Creates a widget that displays an image. /// Creates a widget that displays an image.
/// ///
/// To show an image from the network or from an asset bundle, consider using /// To show an image from the network or from an asset bundle, consider using
/// [new Image.network] and [new Image.asset] respectively. /// [Image.network] and [Image.asset] respectively.
/// ///
/// The [image], [alignment], [repeat], and [matchTextDirection] arguments /// The [image], [alignment], [repeat], and [matchTextDirection] arguments
/// must not be null. /// must not be null.
......
...@@ -199,7 +199,7 @@ class Scrollable extends StatefulWidget { ...@@ -199,7 +199,7 @@ class Scrollable extends StatefulWidget {
/// ///
/// Some subtypes of [ScrollView] can infer this value automatically. For /// Some subtypes of [ScrollView] can infer this value automatically. For
/// example [ListView] will use the number of widgets in the child list, /// example [ListView] will use the number of widgets in the child list,
/// while the [new ListView.separated] constructor will use half that amount. /// while the [ListView.separated] constructor will use half that amount.
/// ///
/// For [CustomScrollView] and other types which do not receive a builder /// For [CustomScrollView] and other types which do not receive a builder
/// or list of widgets, the child count must be explicitly provided. /// or list of widgets, the child count must be explicitly provided.
......
...@@ -1032,7 +1032,7 @@ class SliverGrid extends SliverMultiBoxAdaptorWidget { ...@@ -1032,7 +1032,7 @@ class SliverGrid extends SliverMultiBoxAdaptorWidget {
/// ///
/// See also: /// See also:
/// ///
/// * [new GridView.count], the equivalent constructor for [GridView] widgets. /// * [GridView.count], the equivalent constructor for [GridView] widgets.
SliverGrid.count({ SliverGrid.count({
Key? key, Key? key,
required int crossAxisCount, required int crossAxisCount,
...@@ -1056,7 +1056,7 @@ class SliverGrid extends SliverMultiBoxAdaptorWidget { ...@@ -1056,7 +1056,7 @@ class SliverGrid extends SliverMultiBoxAdaptorWidget {
/// ///
/// See also: /// See also:
/// ///
/// * [new GridView.extent], the equivalent constructor for [GridView] widgets. /// * [GridView.extent], the equivalent constructor for [GridView] widgets.
SliverGrid.extent({ SliverGrid.extent({
Key? key, Key? key,
required double maxCrossAxisExtent, required double maxCrossAxisExtent,
......
...@@ -83,7 +83,7 @@ class DefaultTextStyle extends InheritedTheme { ...@@ -83,7 +83,7 @@ class DefaultTextStyle extends InheritedTheme {
/// ancestor". To replace a non-null [maxLines] from an ancestor with the null /// ancestor". To replace a non-null [maxLines] from an ancestor with the null
/// value (to remove the restriction on number of lines), manually obtain the /// value (to remove the restriction on number of lines), manually obtain the
/// ambient [DefaultTextStyle] using [DefaultTextStyle.of], then create a new /// ambient [DefaultTextStyle] using [DefaultTextStyle.of], then create a new
/// [DefaultTextStyle] using the [new DefaultTextStyle] constructor directly. /// [DefaultTextStyle] using the [DefaultTextStyle.new] constructor directly.
/// See the source below for an example of how to do this (since that's /// See the source below for an example of how to do this (since that's
/// essentially what this constructor does). /// essentially what this constructor does).
static Widget merge({ static Widget merge({
......
...@@ -789,7 +789,7 @@ class DecoratedBoxTransition extends AnimatedWidget { ...@@ -789,7 +789,7 @@ class DecoratedBoxTransition extends AnimatedWidget {
/// ///
/// See also: /// See also:
/// ///
/// * [new DecoratedBox] /// * [DecoratedBox.new]
const DecoratedBoxTransition({ const DecoratedBoxTransition({
Key? key, Key? key,
required this.decoration, required this.decoration,
...@@ -856,7 +856,7 @@ class AlignTransition extends AnimatedWidget { ...@@ -856,7 +856,7 @@ class AlignTransition extends AnimatedWidget {
/// ///
/// See also: /// See also:
/// ///
/// * [new Align]. /// * [Align.new].
const AlignTransition({ const AlignTransition({
Key? key, Key? key,
required Animation<AlignmentGeometry> alignment, required Animation<AlignmentGeometry> alignment,
......
...@@ -199,7 +199,7 @@ class TestSemantics { ...@@ -199,7 +199,7 @@ class TestSemantics {
/// ///
/// See also: /// See also:
/// ///
/// * [new TestSemantics.root], which uses this value to describe the root /// * [TestSemantics.root], which uses this value to describe the root
/// node. /// node.
static const Rect rootRect = Rect.fromLTWH(0.0, 0.0, 2400.0, 1800.0); static const Rect rootRect = Rect.fromLTWH(0.0, 0.0, 2400.0, 1800.0);
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment