diff --git a/packages/cupertino_ui/analysis_options.yaml b/packages/cupertino_ui/analysis_options.yaml index bd2a1b96a3d9..3e17bba73b77 100644 --- a/packages/cupertino_ui/analysis_options.yaml +++ b/packages/cupertino_ui/analysis_options.yaml @@ -13,3 +13,8 @@ analyzer: - windows/** - macos/** - linux/** + +linter: + rules: + # TODO(dkwingsmt): Remove when https://github.com/dart-lang/sdk/issues/63777 is fixed. + unintended_html_in_doc_comment: false diff --git a/packages/cupertino_ui/lib/src/app.dart b/packages/cupertino_ui/lib/src/app.dart index a3cb84be1af2..91a271b55691 100644 --- a/packages/cupertino_ui/lib/src/app.dart +++ b/packages/cupertino_ui/lib/src/app.dart @@ -67,8 +67,8 @@ import 'theme.dart'; /// * The San Francisco font family is unavailable on Android and can result /// in undefined font behavior. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -89,10 +89,10 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// +/// +/// /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -122,10 +122,10 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// +/// +/// /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -149,7 +149,7 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// @@ -372,8 +372,8 @@ class CupertinoApp extends StatefulWidget { final bool debugShowCheckedModeBanner; /// {@macro flutter.widgets.widgetsApp.shortcuts} - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -400,13 +400,13 @@ class CupertinoApp extends StatefulWidget { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@macro flutter.widgets.widgetsApp.shortcuts.seeAlso} final Map? shortcuts; /// {@macro flutter.widgets.widgetsApp.actions} - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -438,7 +438,7 @@ class CupertinoApp extends StatefulWidget { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@macro flutter.widgets.widgetsApp.actions.seeAlso} final Map>? actions; diff --git a/packages/cupertino_ui/lib/src/checkbox.dart b/packages/cupertino_ui/lib/src/checkbox.dart index c917fdb4aece..3a0071fa4913 100644 --- a/packages/cupertino_ui/lib/src/checkbox.dart +++ b/packages/cupertino_ui/lib/src/checkbox.dart @@ -205,8 +205,8 @@ class CupertinoCheckbox extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -227,7 +227,7 @@ class CupertinoCheckbox extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@endtemplate} /// /// If [fillColor] resolves to null for the requested state, then the fill color diff --git a/packages/cupertino_ui/lib/src/colors.dart b/packages/cupertino_ui/lib/src/colors.dart index a82cb600b426..97feb96f81b2 100644 --- a/packages/cupertino_ui/lib/src/colors.dart +++ b/packages/cupertino_ui/lib/src/colors.dart @@ -661,8 +661,8 @@ abstract final class CupertinoColors { /// [CupertinoDynamicColor.resolve] against its own [BuildContext], on a best-effort /// basis. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -682,7 +682,7 @@ abstract final class CupertinoColors { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ### Using a [CupertinoDynamicColor] from a [CupertinoTheme] /// @@ -691,8 +691,8 @@ abstract final class CupertinoColors { /// implicitly resolves all the colors used in the retrieved [CupertinoThemeData], /// before returning it. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -711,7 +711,7 @@ abstract final class CupertinoColors { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ### Manually Resolving a [CupertinoDynamicColor] /// @@ -722,8 +722,8 @@ abstract final class CupertinoColors { /// the colors used in the [Border] have to be resolved manually before being passed /// to [CupertinoNavigationBar]'s constructor. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -750,7 +750,7 @@ abstract final class CupertinoColors { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/context_menu.dart b/packages/cupertino_ui/lib/src/context_menu.dart index 72e87b3b0212..331c45635084 100644 --- a/packages/cupertino_ui/lib/src/context_menu.dart +++ b/packages/cupertino_ui/lib/src/context_menu.dart @@ -148,8 +148,8 @@ class CupertinoContextMenu extends StatefulWidget { /// Exposes the default border radius for matching iOS 16.0 behavior. This /// value was eyeballed from the iOS simulator running iOS 16.0. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -215,8 +215,7 @@ class CupertinoContextMenu extends StatefulWidget { /// ) /// ``` /// - /// - // TODO(framework): End of the blue example container. + /// static const double kOpenBorderRadius = _previewBorderRadiusRatio; /// Exposes the final box shadow of the opening animation of the child widget @@ -259,8 +258,8 @@ class CupertinoContextMenu extends StatefulWidget { /// the widget from 0 to [animationOpensAt], and the second stage for when the /// widget fully opens up to the menu, from [animationOpensAt] to 1. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -329,8 +328,7 @@ class CupertinoContextMenu extends StatefulWidget { /// ) /// ``` /// - /// - // TODO(framework): End of the blue example container. + /// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 diff --git a/packages/cupertino_ui/lib/src/date_picker.dart b/packages/cupertino_ui/lib/src/date_picker.dart index bac359f2a314..8839cad8f0ec 100644 --- a/packages/cupertino_ui/lib/src/date_picker.dart +++ b/packages/cupertino_ui/lib/src/date_picker.dart @@ -483,8 +483,8 @@ class CupertinoDatePicker extends StatefulWidget { /// /// If the selection overlay builder returns null, no overlay will be drawn. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -519,7 +519,7 @@ class CupertinoDatePicker extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final SelectionOverlayBuilder? selectionOverlayBuilder; /// The behavior of reporting the selected date. @@ -2267,8 +2267,8 @@ class CupertinoTimerPicker extends StatefulWidget { /// /// If the selection overlay builder returns null, no overlay will be drawn. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -2301,7 +2301,7 @@ class CupertinoTimerPicker extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final SelectionOverlayBuilder? selectionOverlayBuilder; /// The behavior of reporting the selected duration. diff --git a/packages/cupertino_ui/lib/src/icons.dart b/packages/cupertino_ui/lib/src/icons.dart index 4a973f70f80d..493295d4aef9 100644 --- a/packages/cupertino_ui/lib/src/icons.dart +++ b/packages/cupertino_ui/lib/src/icons.dart @@ -21,8 +21,8 @@ import 'package:flutter/widgets.dart'; /// cupertino_icons: ^1.0.0 /// ``` /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -57,7 +57,7 @@ import 'package:flutter/widgets.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// For versions 0.1.3 and below, see this [glyph map](https://raw.githubusercontent.com/flutter/packages/main/third_party/packages/cupertino_icons/map.png). /// diff --git a/packages/cupertino_ui/lib/src/magnifier.dart b/packages/cupertino_ui/lib/src/magnifier.dart index 16fbaf427dc0..6231fc6846ce 100644 --- a/packages/cupertino_ui/lib/src/magnifier.dart +++ b/packages/cupertino_ui/lib/src/magnifier.dart @@ -14,8 +14,8 @@ import 'theme.dart'; /// A [CupertinoMagnifier] used for magnifying text in cases where a user's /// finger may be blocking the point of interest, like a selection handle. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -23,7 +23,7 @@ import 'theme.dart'; /// /// {@example example/lib/magnifier/cupertino_text_magnifier.0.dart} /// -// TODO(framework): End of the blue example container. +/// /// /// Delegates styling to [CupertinoMagnifier] with its position depending on /// [magnifierInfo]. @@ -226,8 +226,8 @@ class _CupertinoTextMagnifierState extends State /// A [RawMagnifier] used for magnifying text in cases where a user's /// finger may be blocking the point of interest, like a selection handle. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -235,7 +235,7 @@ class _CupertinoTextMagnifierState extends State /// /// {@example example/lib/magnifier/cupertino_magnifier.0.dart} /// -// TODO(framework): End of the blue example container. +/// /// /// [CupertinoMagnifier] is a wrapper around [RawMagnifier] that handles styling /// and transitions. diff --git a/packages/cupertino_ui/lib/src/menu_anchor.dart b/packages/cupertino_ui/lib/src/menu_anchor.dart index 762861815e0c..00be09a451f0 100644 --- a/packages/cupertino_ui/lib/src/menu_anchor.dart +++ b/packages/cupertino_ui/lib/src/menu_anchor.dart @@ -295,15 +295,14 @@ typedef CupertinoMenuAnimationStatusChangedCallback = void Function(AnimationSta /// invoked every time the [AnimationStatus] of the menu animation changes. /// /// ## Usage -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// /// This example demonstrates a simple [CupertinoMenuAnchor] that wraps /// a button. /// /// {@example /example/lib/menu_anchor/menu_anchor.0.dart} /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 @@ -1701,15 +1700,14 @@ class _CupertinoDividerPainter extends CustomPainter { /// will perform a destructive action, and will color the text of the menu item /// [CupertinoColors.systemRed]. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// /// This example demonstrates a simple [CupertinoMenuAnchor] that wraps /// a button. /// /// {@example /example/lib/menu_anchor/menu_anchor.0.dart} /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 diff --git a/packages/cupertino_ui/lib/src/slider.dart b/packages/cupertino_ui/lib/src/slider.dart index 33047c757022..fd77174a68b9 100644 --- a/packages/cupertino_ui/lib/src/slider.dart +++ b/packages/cupertino_ui/lib/src/slider.dart @@ -140,8 +140,8 @@ class CupertinoSlider extends StatefulWidget { /// The value passed will be the last [value] that the slider had before the /// change began. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -163,7 +163,7 @@ class CupertinoSlider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -177,8 +177,8 @@ class CupertinoSlider extends StatefulWidget { /// [onChanged] for that), but rather to know when the user has completed /// selecting a new [value] by ending a drag. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -200,7 +200,7 @@ class CupertinoSlider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/sliding_segmented_control.dart b/packages/cupertino_ui/lib/src/sliding_segmented_control.dart index d06ac15a3408..231ce1d04f40 100644 --- a/packages/cupertino_ui/lib/src/sliding_segmented_control.dart +++ b/packages/cupertino_ui/lib/src/sliding_segmented_control.dart @@ -427,8 +427,8 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// the parent [StatefulWidget] using the [State.setState] method, so that /// the parent gets rebuilt; for example: /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -464,7 +464,7 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// final ValueChanged onValueChanged; /// The color used to paint the rounded rect behind the [children] and the separators. diff --git a/packages/cupertino_ui/lib/src/switch.dart b/packages/cupertino_ui/lib/src/switch.dart index 4db1901d3222..888463f45745 100644 --- a/packages/cupertino_ui/lib/src/switch.dart +++ b/packages/cupertino_ui/lib/src/switch.dart @@ -87,8 +87,8 @@ const CupertinoDynamicColor _kOffLabelColor = CupertinoDynamicColor.withBrightne /// // TODO(framework): End of the @dartpad directive. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -110,7 +110,7 @@ const CupertinoDynamicColor _kOffLabelColor = CupertinoDynamicColor.withBrightne /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// @@ -305,8 +305,8 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -327,7 +327,7 @@ class CupertinoSwitch extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// The [CupertinoSwitch] track has no outline by default. final WidgetStateProperty? trackOutlineColor; @@ -340,8 +340,8 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -362,7 +362,7 @@ class CupertinoSwitch extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// Since a [CupertinoSwitch] has no track outline by default, this parameter /// is set only if [trackOutlineColor] is provided. @@ -378,8 +378,8 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -400,7 +400,7 @@ class CupertinoSwitch extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// If null, then the [CupertinoSwitch] does not have any icons on the thumb. final WidgetStateProperty? thumbIcon; @@ -414,8 +414,8 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -436,7 +436,7 @@ class CupertinoSwitch extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// If null, then [MouseCursor.defer] is used when the switch is disabled. /// When the switch is enabled, [SystemMouseCursors.click] is used on Web, and diff --git a/packages/cupertino_ui/lib/src/text_field.dart b/packages/cupertino_ui/lib/src/text_field.dart index 32612565d1f3..4739768c31a6 100644 --- a/packages/cupertino_ui/lib/src/text_field.dart +++ b/packages/cupertino_ui/lib/src/text_field.dart @@ -837,8 +837,8 @@ class CupertinoTextField extends StatefulWidget { /// /// {@macro flutter.widgets.magnifier.intro} /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -846,7 +846,7 @@ class CupertinoTextField extends StatefulWidget { /// /// {@example example/lib/magnifier/text_magnifier.0.dart} /// - // TODO(framework): End of the blue example container. + /// final TextMagnifierConfiguration? magnifierConfiguration; /// {@macro flutter.widgets.EditableText.spellCheckConfiguration} diff --git a/packages/cupertino_ui/lib/src/text_form_field_row.dart b/packages/cupertino_ui/lib/src/text_form_field_row.dart index 9de408b852a2..ac07c4a2f48a 100644 --- a/packages/cupertino_ui/lib/src/text_form_field_row.dart +++ b/packages/cupertino_ui/lib/src/text_form_field_row.dart @@ -48,8 +48,8 @@ import 'text_field.dart'; /// [CupertinoTextField] class and [CupertinoTextField.borderless], /// the constructor. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -76,7 +76,7 @@ import 'text_field.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 diff --git a/packages/material_ui/analysis_options.yaml b/packages/material_ui/analysis_options.yaml index bd2a1b96a3d9..3e17bba73b77 100644 --- a/packages/material_ui/analysis_options.yaml +++ b/packages/material_ui/analysis_options.yaml @@ -13,3 +13,8 @@ analyzer: - windows/** - macos/** - linux/** + +linter: + rules: + # TODO(dkwingsmt): Remove when https://github.com/dart-lang/sdk/issues/63777 is fixed. + unintended_html_in_doc_comment: false diff --git a/packages/material_ui/lib/src/app.dart b/packages/material_ui/lib/src/app.dart index fdfef4617901..fc692d93ed87 100644 --- a/packages/material_ui/lib/src/app.dart +++ b/packages/material_ui/lib/src/app.dart @@ -118,8 +118,8 @@ enum ThemeMode { /// If [home], [routes], [onGenerateRoute], and [onUnknownRoute] are all null, /// and [builder] is not null, then no [Navigator] is created. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -139,10 +139,10 @@ enum ThemeMode { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// +/// +/// /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -170,10 +170,10 @@ enum ThemeMode { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// +/// +/// /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -196,7 +196,7 @@ enum ThemeMode { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ## Troubleshooting /// @@ -694,8 +694,8 @@ class MaterialApp extends StatefulWidget { final bool debugShowCheckedModeBanner; /// {@macro flutter.widgets.widgetsApp.shortcuts} - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -722,13 +722,13 @@ class MaterialApp extends StatefulWidget { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@macro flutter.widgets.widgetsApp.shortcuts.seeAlso} final Map? shortcuts; /// {@macro flutter.widgets.widgetsApp.actions} - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -760,7 +760,7 @@ class MaterialApp extends StatefulWidget { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@macro flutter.widgets.widgetsApp.actions.seeAlso} final Map>? actions; diff --git a/packages/material_ui/lib/src/app_bar.dart b/packages/material_ui/lib/src/app_bar.dart index 569451926577..de0ab3436dc6 100644 --- a/packages/material_ui/lib/src/app_bar.dart +++ b/packages/material_ui/lib/src/app_bar.dart @@ -272,8 +272,8 @@ class AppBar extends StatefulWidget implements PreferredSizeWidget { /// will use a [BackButton] that calls [Navigator.maybePop]. /// {@endtemplate} /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -294,7 +294,7 @@ class AppBar extends StatefulWidget implements PreferredSizeWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// The [Builder] is used in this example to ensure that the `context` refers /// to that part of the subtree. That way this code snippet can be used even @@ -373,8 +373,8 @@ class AppBar extends StatefulWidget implements PreferredSizeWidget { /// widget with an [IconButton] that opens the end drawer (using [Icons.menu]). /// {@endtemplate} /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -401,7 +401,7 @@ class AppBar extends StatefulWidget implements PreferredSizeWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final List? actions; /// {@template flutter.material.appbar.automaticallyImplyActions} @@ -1516,8 +1516,8 @@ class _SliverAppBarDelegate extends SliverPersistentHeaderDelegate { /// [actions], above the [bottom] (if any). If a [flexibleSpace] widget is /// specified then it is stacked behind the toolbar and the bottom widget. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1540,7 +1540,7 @@ class _SliverAppBarDelegate extends SliverPersistentHeaderDelegate { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 diff --git a/packages/material_ui/lib/src/bottom_app_bar.dart b/packages/material_ui/lib/src/bottom_app_bar.dart index 41849b89592f..7600127593bd 100644 --- a/packages/material_ui/lib/src/bottom_app_bar.dart +++ b/packages/material_ui/lib/src/bottom_app_bar.dart @@ -27,8 +27,8 @@ import 'theme.dart'; /// /// Typically used with a [Scaffold] and a [FloatingActionButton]. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -42,7 +42,7 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 diff --git a/packages/material_ui/lib/src/carousel.dart b/packages/material_ui/lib/src/carousel.dart index 7ef95af25ef5..8fb84195e361 100644 --- a/packages/material_ui/lib/src/carousel.dart +++ b/packages/material_ui/lib/src/carousel.dart @@ -51,8 +51,8 @@ import 'theme.dart'; /// [CarouselView.weighted] is used, then set the [flexWeights] to only have /// one integer in the array. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -86,7 +86,7 @@ import 'theme.dart'; /// ), /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// In [CarouselView.weighted], weights are relative proportions. For example, /// if the layout weights is `[3, 2, 1]`, it means the first visible item occupies @@ -284,8 +284,8 @@ class CarouselView extends StatefulWidget { /// The [flexWeights] parameter determines the layout, and [itemBuilder] /// creates items as they become visible. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -306,7 +306,7 @@ class CarouselView extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// diff --git a/packages/material_ui/lib/src/checkbox.dart b/packages/material_ui/lib/src/checkbox.dart index 1a6e53f4dbd6..ef32862afeed 100644 --- a/packages/material_ui/lib/src/checkbox.dart +++ b/packages/material_ui/lib/src/checkbox.dart @@ -221,8 +221,8 @@ class Checkbox extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -243,7 +243,7 @@ class Checkbox extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@endtemplate} /// /// If null, then the value of [activeColor] is used in the selected diff --git a/packages/material_ui/lib/src/checkbox_list_tile.dart b/packages/material_ui/lib/src/checkbox_list_tile.dart index 5bf87f9e0670..a692cbb58f59 100644 --- a/packages/material_ui/lib/src/checkbox_list_tile.dart +++ b/packages/material_ui/lib/src/checkbox_list_tile.dart @@ -61,8 +61,8 @@ enum _CheckboxType { material, adaptive } /// In this case, one can wrap a [Material] widget around the [CheckboxListTile], /// e.g.: /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -80,7 +80,7 @@ enum _CheckboxType { material, adaptive } /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ## Performance considerations when wrapping [CheckboxListTile] with [Material] /// @@ -296,8 +296,8 @@ class CheckboxListTile extends StatelessWidget { /// /// If null, the checkbox will be displayed as disabled. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -317,7 +317,7 @@ class CheckboxListTile extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final ValueChanged? onChanged; /// The cursor for a mouse pointer when it enters or is hovering over the diff --git a/packages/material_ui/lib/src/chip.dart b/packages/material_ui/lib/src/chip.dart index 93601ea6735c..3e94dd6a3797 100644 --- a/packages/material_ui/lib/src/chip.dart +++ b/packages/material_ui/lib/src/chip.dart @@ -460,8 +460,8 @@ abstract interface class SelectableChipAttributes { /// The [onSelected] and [TappableChipAttributes.onPressed] callbacks must not /// both be specified at the same time. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -493,7 +493,7 @@ abstract interface class SelectableChipAttributes { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// ValueChanged? get onSelected; /// Elevation to be applied on the chip relative to its parent during the @@ -595,8 +595,8 @@ abstract interface class TappableChipAttributes { /// taps on the label or avatar parts of the chip. If [onPressed] is null, /// then the chip will be disabled. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -618,7 +618,7 @@ abstract interface class TappableChipAttributes { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// VoidCallback? get onPressed; /// Elevation to be applied on the chip relative to its parent during the @@ -678,8 +678,8 @@ class ChipAnimationStyle { /// [MaterialApp] and [Scaffold]. The [label] and [clipBehavior] arguments must /// not be null. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -693,7 +693,7 @@ class ChipAnimationStyle { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// diff --git a/packages/material_ui/lib/src/chip_theme.dart b/packages/material_ui/lib/src/chip_theme.dart index 9d931d76ebdd..b1a0547202af 100644 --- a/packages/material_ui/lib/src/chip_theme.dart +++ b/packages/material_ui/lib/src/chip_theme.dart @@ -62,8 +62,8 @@ class ChipTheme extends InheritedTheme { /// Defaults to the ambient [ThemeData.chipTheme] if there is no /// [ChipTheme] in the given build context. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -84,7 +84,7 @@ class ChipTheme extends InheritedTheme { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -126,8 +126,8 @@ class ChipTheme extends InheritedTheme { /// you get from [ChipTheme.of], or create an entirely new one with /// [ChipThemeData.fromDefaults]. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -160,7 +160,7 @@ class ChipTheme extends InheritedTheme { /// } /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// diff --git a/packages/material_ui/lib/src/circle_avatar.dart b/packages/material_ui/lib/src/circle_avatar.dart index d5d5cc579015..366f94139b47 100644 --- a/packages/material_ui/lib/src/circle_avatar.dart +++ b/packages/material_ui/lib/src/circle_avatar.dart @@ -29,8 +29,8 @@ import 'theme.dart'; /// The [onForegroundImageError] parameter must be null if the [foregroundImage] /// is null. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -43,12 +43,12 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// The image will be cropped to have a circle shape. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -62,7 +62,7 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// diff --git a/packages/material_ui/lib/src/color_scheme.dart b/packages/material_ui/lib/src/color_scheme.dart index e5d7d16920db..a7ff0d7f55d8 100644 --- a/packages/material_ui/lib/src/color_scheme.dart +++ b/packages/material_ui/lib/src/color_scheme.dart @@ -435,8 +435,8 @@ class ColorScheme with Diagnosticable { /// For Material 3, use [ColorScheme.fromSeed] to create a color scheme /// from a single seed color based on the Material 3 color system. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -454,7 +454,7 @@ class ColorScheme with Diagnosticable { /// ), /// ``` /// - // TODO(framework): End of the blue example container. + /// const ColorScheme.light({ this.brightness = Brightness.light, this.primary = const Color(0xff6200ee), @@ -530,8 +530,8 @@ class ColorScheme with Diagnosticable { /// Override the `brightness` property of [ColorScheme.fromSeed] to create a /// dark color scheme. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -552,7 +552,7 @@ class ColorScheme with Diagnosticable { /// ), /// ``` /// - // TODO(framework): End of the blue example container. + /// const ColorScheme.dark({ this.brightness = Brightness.dark, this.primary = const Color(0xffbb86fc), @@ -627,8 +627,8 @@ class ColorScheme with Diagnosticable { /// from a single seed color based on the Material 3 color system. To create a /// high-contrast color scheme, set `contrastLevel` to 1.0. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -646,7 +646,7 @@ class ColorScheme with Diagnosticable { /// ), /// ``` /// - // TODO(framework): End of the blue example container. + /// const ColorScheme.highContrastLight({ this.brightness = Brightness.light, this.primary = const Color(0xff0000ba), @@ -723,8 +723,8 @@ class ColorScheme with Diagnosticable { /// dark color scheme. To create a high-contrast color scheme, set /// `contrastLevel` to 1.0. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -745,7 +745,7 @@ class ColorScheme with Diagnosticable { /// ), /// ``` /// - // TODO(framework): End of the blue example container. + /// const ColorScheme.highContrastDark({ this.brightness = Brightness.dark, this.primary = const Color(0xffefb7ff), diff --git a/packages/material_ui/lib/src/colors.dart b/packages/material_ui/lib/src/colors.dart index 822ff7649ac7..7f07e209cf13 100644 --- a/packages/material_ui/lib/src/colors.dart +++ b/packages/material_ui/lib/src/colors.dart @@ -187,8 +187,8 @@ class MaterialAccentColor extends ColorSwatch { /// In addition, a series of blacks and whites with common opacities are /// available. For example, [black54] is a pure black with 54% opacity. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -199,9 +199,10 @@ class MaterialAccentColor extends ColorSwatch { /// Color selection = Colors.green[400]!; // Selects a mid-range green. /// ``` /// -// TODO(framework): End of the blue example container. -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -213,7 +214,7 @@ class MaterialAccentColor extends ColorSwatch { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ## Color palettes /// @@ -525,8 +526,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.pink.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.pinkAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -537,7 +538,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -570,8 +571,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.pink.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.pinkAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -582,7 +583,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -609,8 +610,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.purple.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.purpleAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -621,7 +622,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -654,8 +655,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.purple.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.purpleAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -666,7 +667,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -694,8 +695,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.pink.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.pinkAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -706,7 +707,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -739,8 +740,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.pink.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.pinkAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -751,7 +752,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -779,8 +780,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.indigo.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.indigoAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -791,7 +792,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -824,8 +825,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.indigo.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.indigoAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -836,7 +837,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -864,8 +865,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.deepPurple.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.deepPurpleAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -876,7 +877,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -909,8 +910,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.deepPurple.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.deepPurpleAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -921,7 +922,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -951,8 +952,8 @@ abstract final class Colors { /// /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.blueGrey.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -963,7 +964,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -996,8 +997,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.lightBlue.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.lightBlueAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1008,7 +1009,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1036,8 +1037,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.cyan.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.cyanAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1048,7 +1049,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1081,8 +1082,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.cyan.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.cyanAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1093,7 +1094,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1123,8 +1124,8 @@ abstract final class Colors { /// /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.blueGrey.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1135,7 +1136,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1168,8 +1169,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.teal.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.tealAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1180,7 +1181,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1208,8 +1209,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.cyan.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.cyanAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1220,7 +1221,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1253,8 +1254,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.cyan.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.cyanAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1265,7 +1266,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1296,8 +1297,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.lime.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.limeAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1308,7 +1309,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1344,8 +1345,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.lime.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.limeAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1356,7 +1357,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1384,8 +1385,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.lime.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.limeAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1396,7 +1397,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1429,8 +1430,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.lime.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.limeAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1441,7 +1442,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1469,8 +1470,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.yellow.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.yellowAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1481,7 +1482,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1514,8 +1515,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.yellow.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.yellowAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1526,7 +1527,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1554,8 +1555,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.amber.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.amberAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1566,7 +1567,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1599,8 +1600,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.amber.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.amberAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1611,7 +1612,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1639,8 +1640,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.orange.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.orangeAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1651,7 +1652,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1684,8 +1685,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.orange.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.orangeAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1696,7 +1697,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1726,8 +1727,8 @@ abstract final class Colors { /// /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.brown.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1738,7 +1739,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1771,8 +1772,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.deepOrange.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.deepOrangeAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1783,7 +1784,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1813,8 +1814,8 @@ abstract final class Colors { /// /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.brown.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1825,7 +1826,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1858,8 +1859,8 @@ abstract final class Colors { /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.red.png) /// ![](https://flutter.github.io/assets-for-api-docs/assets/material/Colors.redAccent.png) /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1870,7 +1871,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1897,8 +1898,8 @@ abstract final class Colors { /// /// This swatch has no corresponding accent color and swatch. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1909,7 +1910,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1945,8 +1946,8 @@ abstract final class Colors { /// used for raised button while pressed in light themes, and 850 is used for /// the background color of the dark theme. See [ThemeData.brightness]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1957,7 +1958,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1994,8 +1995,8 @@ abstract final class Colors { /// /// This swatch has no corresponding accent swatch. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -2006,7 +2007,7 @@ abstract final class Colors { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// diff --git a/packages/material_ui/lib/src/dialog.dart b/packages/material_ui/lib/src/dialog.dart index 9739a4efbb76..c8aa34d56ad8 100644 --- a/packages/material_ui/lib/src/dialog.dart +++ b/packages/material_ui/lib/src/dialog.dart @@ -53,8 +53,8 @@ const EdgeInsets _defaultInsetPadding = EdgeInsets.symmetric(horizontal: 40.0, v /// For applications targeting large screens such as desktop or Web, it is recommended to /// set the [constraints] property. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -64,7 +64,7 @@ const EdgeInsets _defaultInsetPadding = EdgeInsets.symmetric(horizontal: 40.0, v /// const Dialog(constraints: BoxConstraints(maxWidth: 560, minHeight: 280)); /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// @@ -345,8 +345,8 @@ class Dialog extends StatelessWidget { /// /// {@animation 350 622 https://flutter.github.io/assets-for-api-docs/assets/material/alert_dialog.mp4} /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -383,7 +383,7 @@ class Dialog extends StatelessWidget { /// } /// ``` /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 @@ -646,8 +646,8 @@ class AlertDialog extends StatelessWidget { /// /// If there are no [actions], then no padding will be included. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -664,7 +664,7 @@ class AlertDialog extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -1061,8 +1061,8 @@ class _AdaptiveAlertDialog extends AlertDialog { /// title and the first option, and 24 pixels of spacing between the last option /// and the bottom of the dialog. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1073,7 +1073,7 @@ class _AdaptiveAlertDialog extends AlertDialog { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// @@ -1133,8 +1133,8 @@ class SimpleDialogOption extends StatelessWidget { /// /// {@animation 350 622 https://flutter.github.io/assets-for-api-docs/assets/material/simple_dialog.mp4} /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1183,7 +1183,7 @@ class SimpleDialogOption extends StatelessWidget { /// } /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// diff --git a/packages/material_ui/lib/src/divider.dart b/packages/material_ui/lib/src/divider.dart index 214d06fee3f3..e5ab6f1b603b 100644 --- a/packages/material_ui/lib/src/divider.dart +++ b/packages/material_ui/lib/src/divider.dart @@ -128,8 +128,8 @@ class Divider extends StatelessWidget { /// also null, then [ThemeData.dividerColor] is used. /// {@endtemplate} /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -139,7 +139,7 @@ class Divider extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final Color? color; /// Computes the [BorderSide] that represents a divider. @@ -155,8 +155,8 @@ class Divider extends StatelessWidget { /// If [context] is null, the default color of [BorderSide] is used and the /// default width of 0.0 is used. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -176,7 +176,7 @@ class Divider extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// static BorderSide createBorderSide(BuildContext? context, {Color? color, double? width}) { final DividerThemeData? dividerTheme = context != null ? DividerTheme.of(context) : null; final DividerThemeData? defaults = context != null @@ -314,8 +314,8 @@ class VerticalDivider extends StatelessWidget { /// If this is null, then the [DividerThemeData.color] is used. If that is /// also null, then [ThemeData.dividerColor] is used. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -325,7 +325,7 @@ class VerticalDivider extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final Color? color; /// The amount of radius for the border of the divider. diff --git a/packages/material_ui/lib/src/drawer.dart b/packages/material_ui/lib/src/drawer.dart index 2443856d51c3..585dced2dec5 100644 --- a/packages/material_ui/lib/src/drawer.dart +++ b/packages/material_ui/lib/src/drawer.dart @@ -422,8 +422,8 @@ class DrawerController extends StatefulWidget { /// The closest instance of [DrawerController] that encloses the given /// context, or null if none is found. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// Typical usage is as follows: @@ -432,7 +432,7 @@ class DrawerController extends StatefulWidget { /// DrawerController? controller = DrawerController.maybeOf(context); /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// Calling this method will create a dependency on the closest /// [DrawerController] in the [context], if there is one. @@ -454,8 +454,8 @@ class DrawerController extends StatefulWidget { /// Calling this method will create a dependency on the closest /// [DrawerController] in the [context]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// Typical usage is as follows: @@ -464,7 +464,7 @@ class DrawerController extends StatefulWidget { /// DrawerController controller = DrawerController.of(context); /// ``` /// - // TODO(framework): End of the blue example container. + /// static DrawerController of(BuildContext context) { final DrawerController? controller = maybeOf(context); assert(() { diff --git a/packages/material_ui/lib/src/dropdown_menu.dart b/packages/material_ui/lib/src/dropdown_menu.dart index 662daab7db3c..0c9a04789ac7 100644 --- a/packages/material_ui/lib/src/dropdown_menu.dart +++ b/packages/material_ui/lib/src/dropdown_menu.dart @@ -576,8 +576,8 @@ class DropdownMenu extends StatefulWidget { /// When [DropdownMenu.enableFilter] is true, this callback is used to /// compute the list of filtered items. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -603,7 +603,7 @@ class DropdownMenu extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// Defaults to null. If this parameter is null and the /// [DropdownMenu.enableFilter] property is set to true, the default behavior @@ -615,8 +615,8 @@ class DropdownMenu extends StatefulWidget { /// When [DropdownMenu.enableSearch] is true, this callback is used to compute /// the index of the search result to be highlighted. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -637,7 +637,7 @@ class DropdownMenu extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// Defaults to null. If this is null and [DropdownMenu.enableSearch] is true, /// the default function will return the index of the first matching result diff --git a/packages/material_ui/lib/src/icons.dart b/packages/material_ui/lib/src/icons.dart index e0f636c73259..c2901424b336 100644 --- a/packages/material_ui/lib/src/icons.dart +++ b/packages/material_ui/lib/src/icons.dart @@ -125,8 +125,8 @@ final class PlatformAdaptiveIcons implements Icons { /// uses-material-design: true /// ``` /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -160,7 +160,7 @@ final class PlatformAdaptiveIcons implements Icons { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// @@ -177,8 +177,8 @@ abstract final class Icons { /// /// Use with the [Icon] class to show specific icons. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -192,7 +192,7 @@ abstract final class Icons { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// diff --git a/packages/material_ui/lib/src/ink_decoration.dart b/packages/material_ui/lib/src/ink_decoration.dart index 5414d9c652f0..545f849f2744 100644 --- a/packages/material_ui/lib/src/ink_decoration.dart +++ b/packages/material_ui/lib/src/ink_decoration.dart @@ -47,8 +47,8 @@ import 'material.dart'; /// generally speaking will match the order they are given in the widget tree, /// but this order may appear to be somewhat random in more dynamic situations. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -74,9 +74,10 @@ import 'material.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -113,7 +114,7 @@ import 'material.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// What to do if you want to clip this [Ink.image]? /// diff --git a/packages/material_ui/lib/src/ink_sparkle.dart b/packages/material_ui/lib/src/ink_sparkle.dart index e08e3658e78f..1a6d007e460a 100644 --- a/packages/material_ui/lib/src/ink_sparkle.dart +++ b/packages/material_ui/lib/src/ink_sparkle.dart @@ -43,8 +43,8 @@ import 'material.dart'; /// /// When the ripple is removed, [onRemoved] will be called. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -59,7 +59,7 @@ import 'material.dart'; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// class InkSparkle extends InteractiveInkFeature { /// Begin a sparkly ripple effect, centered at [position] relative to /// [referenceBox]. diff --git a/packages/material_ui/lib/src/list_tile.dart b/packages/material_ui/lib/src/list_tile.dart index 5d826b614bcf..98a76e5753f5 100644 --- a/packages/material_ui/lib/src/list_tile.dart +++ b/packages/material_ui/lib/src/list_tile.dart @@ -203,8 +203,8 @@ enum ListTileTitleAlignment { /// ancestor. In this case, one can wrap a [Material] widget around the /// [ListTile], e.g.: /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -220,7 +220,7 @@ enum ListTileTitleAlignment { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ## Performance considerations when wrapping [ListTile] with [Material] /// @@ -286,8 +286,8 @@ enum ListTileTitleAlignment { /// // TODO(framework): End of the @dartpad directive. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -314,9 +314,10 @@ enum ListTileTitleAlignment { /// ) /// ``` /// -// TODO(framework): End of the blue example container. -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -334,7 +335,7 @@ enum ListTileTitleAlignment { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// To be accessible, tappable [leading] and [trailing] widgets have to /// be at least 48x48 in size. However, to adhere to the Material spec, @@ -348,8 +349,8 @@ enum ListTileTitleAlignment { /// that are large enough, but it is up to the developer to ensure that /// their widgets follow the Material spec. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -376,7 +377,7 @@ enum ListTileTitleAlignment { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ## The ListTile layout isn't exactly what I want /// diff --git a/packages/material_ui/lib/src/material_state.dart b/packages/material_ui/lib/src/material_state.dart index ec3c0b311bd6..f85265c81a4b 100644 --- a/packages/material_ui/lib/src/material_state.dart +++ b/packages/material_ui/lib/src/material_state.dart @@ -107,8 +107,8 @@ typedef MaterialPropertyResolver = WidgetPropertyResolver; /// to provide a `defaultValue` to the super constructor, so that we can know /// at compile-time what its default color is. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -134,7 +134,7 @@ typedef MaterialPropertyResolver = WidgetPropertyResolver; /// } /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also /// diff --git a/packages/material_ui/lib/src/material_state_mixin.dart b/packages/material_ui/lib/src/material_state_mixin.dart index 5222cbcf12fe..12ed8c5b06eb 100644 --- a/packages/material_ui/lib/src/material_state_mixin.dart +++ b/packages/material_ui/lib/src/material_state_mixin.dart @@ -19,8 +19,8 @@ import 'package:flutter/widgets.dart'; /// to manage the set of active [WidgetState]s, and the calling of [setState] /// as necessary. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -52,7 +52,7 @@ import 'package:flutter/widgets.dart'; /// } /// ``` /// -// TODO(framework): End of the blue example container. +/// @optionalTypeArgs mixin MaterialStateMixin on State { /// Managed set of active [WidgetState] values; designed to be passed to @@ -76,8 +76,8 @@ mixin MaterialStateMixin on State { /// If supplied, the [onChanged] function is only called when child widgets /// report events that make changes to the current set of [WidgetState]s. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -115,7 +115,7 @@ mixin MaterialStateMixin on State { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// @protected ValueChanged updateMaterialState(WidgetState key, {ValueChanged? onChanged}) { return (bool value) { diff --git a/packages/material_ui/lib/src/menu_anchor.dart b/packages/material_ui/lib/src/menu_anchor.dart index 817cefa2a8aa..3194a34f395e 100644 --- a/packages/material_ui/lib/src/menu_anchor.dart +++ b/packages/material_ui/lib/src/menu_anchor.dart @@ -412,8 +412,8 @@ class MenuAnchor extends StatefulWidget { /// therefore cannot be used on its own to determine the current animation /// direction. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -443,7 +443,7 @@ class MenuAnchor extends StatefulWidget { /// ); /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// Defaults to null. final ValueChanged? onAnimationStatusChanged; diff --git a/packages/material_ui/lib/src/popup_menu.dart b/packages/material_ui/lib/src/popup_menu.dart index c933e06ed56b..7710937e883e 100644 --- a/packages/material_ui/lib/src/popup_menu.dart +++ b/packages/material_ui/lib/src/popup_menu.dart @@ -148,8 +148,8 @@ class PopupMenuDivider extends PopupMenuEntry { /// {@macro flutter.material.Divider.color} /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -159,7 +159,7 @@ class PopupMenuDivider extends PopupMenuEntry { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final Color? color; @override @@ -245,8 +245,8 @@ class _RenderMenuItem extends RenderShiftedBox { /// [PopupMenuItem] is [kMinInteractiveDimension] pixels high. If you use a widget /// with a different height, it must be specified in the [height] property. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -260,7 +260,7 @@ class _RenderMenuItem extends RenderShiftedBox { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See the example at [PopupMenuButton] for how this example could be used in a /// complete menu, and see the example at [CheckedPopupMenuItem] for one way to @@ -502,8 +502,8 @@ class PopupMenuItemState> extends State { /// layout uses [ListTile]; the checkmark is an [Icons.done] icon, shown in the /// [ListTile.leading] position. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -543,7 +543,7 @@ class PopupMenuItemState> extends State { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// In particular, observe how the second menu item uses a [ListTile] with a /// blank [Icon] in the [ListTile.leading] position to get the same alignment as diff --git a/packages/material_ui/lib/src/progress_indicator_theme.dart b/packages/material_ui/lib/src/progress_indicator_theme.dart index bb1bb427ba8e..911f2a21e7d1 100644 --- a/packages/material_ui/lib/src/progress_indicator_theme.dart +++ b/packages/material_ui/lib/src/progress_indicator_theme.dart @@ -316,8 +316,8 @@ class ProgressIndicatorThemeData with Diagnosticable { /// Values specified here are used for [ProgressIndicator] properties that are not /// given an explicit non-null value. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -333,7 +333,7 @@ class ProgressIndicatorThemeData with Diagnosticable { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// class ProgressIndicatorTheme extends InheritedTheme { /// Creates a theme that controls the configurations for [ProgressIndicator] /// widgets. diff --git a/packages/material_ui/lib/src/radio.dart b/packages/material_ui/lib/src/radio.dart index 4220a4d8273c..8cf623e6c710 100644 --- a/packages/material_ui/lib/src/radio.dart +++ b/packages/material_ui/lib/src/radio.dart @@ -276,8 +276,8 @@ class Radio extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -297,7 +297,7 @@ class Radio extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@endtemplate} /// /// If null, then the value of [activeColor] is used in the selected state. If diff --git a/packages/material_ui/lib/src/radio_list_tile.dart b/packages/material_ui/lib/src/radio_list_tile.dart index 4e2e76230634..d1e6d99bd574 100644 --- a/packages/material_ui/lib/src/radio_list_tile.dart +++ b/packages/material_ui/lib/src/radio_list_tile.dart @@ -63,8 +63,8 @@ enum _RadioType { material, adaptive } /// [RadioListTile] itself but by the [Material] widget ancestor. In this /// case, one can wrap a [Material] widget around the [RadioListTile], e.g.: /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -81,7 +81,7 @@ enum _RadioType { material, adaptive } /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ## Performance considerations when wrapping [RadioListTile] with [Material] /// diff --git a/packages/material_ui/lib/src/range_slider.dart b/packages/material_ui/lib/src/range_slider.dart index 44d5b8b277b8..11bab6b801cc 100644 --- a/packages/material_ui/lib/src/range_slider.dart +++ b/packages/material_ui/lib/src/range_slider.dart @@ -200,8 +200,8 @@ class RangeSlider extends StatefulWidget { /// [StatefulWidget] using the [State.setState] method, so that the parent /// gets rebuilt; for example: /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -218,7 +218,7 @@ class RangeSlider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -236,8 +236,8 @@ class RangeSlider extends StatefulWidget { /// The values passed will be the last [values] that the slider had before the /// change began. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -257,7 +257,7 @@ class RangeSlider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -275,8 +275,8 @@ class RangeSlider extends StatefulWidget { /// [onChanged] for that). Rather, it should be used to know when the user has /// completed selecting a new [values] by ending a drag or a click. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -296,7 +296,7 @@ class RangeSlider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -392,8 +392,8 @@ class RangeSlider extends StatefulWidget { /// This is used by accessibility frameworks like TalkBack on Android to /// inform users what the currently selected value is with more context. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -416,7 +416,7 @@ class RangeSlider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final SemanticFormatterCallback? semanticFormatterCallback; /// Determines the padding around the [RangeSlider]. diff --git a/packages/material_ui/lib/src/scaffold.dart b/packages/material_ui/lib/src/scaffold.dart index 3ebc163a0455..32614c1f4da6 100644 --- a/packages/material_ui/lib/src/scaffold.dart +++ b/packages/material_ui/lib/src/scaffold.dart @@ -1666,8 +1666,8 @@ class _FloatingActionButtonTransitionState extends State<_FloatingActionButtonTr /// better to add a listener to the [TabController] that updates the /// AppBar /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -1685,7 +1685,7 @@ class _FloatingActionButtonTransitionState extends State<_FloatingActionButtonTr /// }) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// Although there are some use cases, like a presentation app that /// shows embedded flutter content, where nested scaffolds are diff --git a/packages/material_ui/lib/src/search.dart b/packages/material_ui/lib/src/search.dart index af089d1ec6c2..9a940a6eb085 100644 --- a/packages/material_ui/lib/src/search.dart +++ b/packages/material_ui/lib/src/search.dart @@ -119,8 +119,8 @@ abstract class SearchDelegate { /// [keyboardType] and/or [textInputAction]. Only one of [searchFieldLabel] /// and [searchFieldDecorationTheme] may be non-null. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -155,7 +155,7 @@ abstract class SearchDelegate { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// SearchDelegate({ this.searchFieldLabel, this.searchFieldStyle, diff --git a/packages/material_ui/lib/src/segmented_button.dart b/packages/material_ui/lib/src/segmented_button.dart index 1ca049304d7b..cef5cdaa960c 100644 --- a/packages/material_ui/lib/src/segmented_button.dart +++ b/packages/material_ui/lib/src/segmented_button.dart @@ -250,8 +250,8 @@ class SegmentedButton extends StatefulWidget { /// All parameters default to null. By default this method returns /// a [ButtonStyle] that doesn't override anything. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -287,7 +287,7 @@ class SegmentedButton extends StatefulWidget { /// ), /// ``` /// - // TODO(framework): End of the blue example container. + /// static ButtonStyle styleFrom({ Color? foregroundColor, Color? backgroundColor, diff --git a/packages/material_ui/lib/src/selectable_text.dart b/packages/material_ui/lib/src/selectable_text.dart index 6d4c3b8a9bc3..dc8d08b558f1 100644 --- a/packages/material_ui/lib/src/selectable_text.dart +++ b/packages/material_ui/lib/src/selectable_text.dart @@ -95,8 +95,8 @@ class _SelectableTextSelectionGestureDetectorBuilder extends TextSelectionGestur /// /// {@macro flutter.material.textfield.wantKeepAlive} /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -108,15 +108,15 @@ class _SelectableTextSelectionGestureDetectorBuilder extends TextSelectionGestur /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// Using the [SelectableText.rich] constructor, the [SelectableText] widget can /// display a paragraph with differently styled [TextSpan]s. The sample /// that follows displays "Hello beautiful world" with different styles /// for each word. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -132,7 +132,7 @@ class _SelectableTextSelectionGestureDetectorBuilder extends TextSelectionGestur /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ## Interactivity /// diff --git a/packages/material_ui/lib/src/slider.dart b/packages/material_ui/lib/src/slider.dart index 5d77348679f5..01390195f198 100644 --- a/packages/material_ui/lib/src/slider.dart +++ b/packages/material_ui/lib/src/slider.dart @@ -296,8 +296,8 @@ class Slider extends StatefulWidget { /// [StatefulWidget] using the [State.setState] method, so that the parent /// gets rebuilt; for example: /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -316,7 +316,7 @@ class Slider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -335,8 +335,8 @@ class Slider extends StatefulWidget { /// The value passed will be the last [value] that the slider had before the /// change began. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -358,7 +358,7 @@ class Slider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -372,8 +372,8 @@ class Slider extends StatefulWidget { /// [onChanged] for that), but rather to know when the user has completed /// selecting a new [value] by ending a drag or a click. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -395,7 +395,7 @@ class Slider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -539,8 +539,8 @@ class Slider extends StatefulWidget { /// This is used by accessibility frameworks like TalkBack on Android to /// inform users what the currently selected value is with more context. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -564,7 +564,7 @@ class Slider extends StatefulWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// Ignored if this slider is created with [Slider.adaptive] final SemanticFormatterCallback? semanticFormatterCallback; diff --git a/packages/material_ui/lib/src/slider_theme.dart b/packages/material_ui/lib/src/slider_theme.dart index 539312158b53..aea913ee79e2 100644 --- a/packages/material_ui/lib/src/slider_theme.dart +++ b/packages/material_ui/lib/src/slider_theme.dart @@ -66,8 +66,8 @@ class SliderTheme extends InheritedTheme { /// Defaults to the ambient [ThemeData.sliderTheme] if there is no /// [SliderTheme] in the given build context. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -95,7 +95,7 @@ class SliderTheme extends InheritedTheme { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -254,8 +254,8 @@ class SliderThemeData with Diagnosticable { /// [copyWith] on the one you get from [SliderTheme.of], or create an /// entirely new one with [SliderThemeData.fromPrimaryColors]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -283,7 +283,7 @@ class SliderThemeData with Diagnosticable { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// const SliderThemeData({ this.trackHeight, this.activeTrackColor, diff --git a/packages/material_ui/lib/src/switch.dart b/packages/material_ui/lib/src/switch.dart index 60c37e766624..2014f2c60c3c 100644 --- a/packages/material_ui/lib/src/switch.dart +++ b/packages/material_ui/lib/src/switch.dart @@ -327,8 +327,8 @@ class Switch extends StatelessWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -349,7 +349,7 @@ class Switch extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@endtemplate} /// /// If null, then the value of [activeThumbColor] is used in the selected @@ -373,8 +373,8 @@ class Switch extends StatelessWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -395,7 +395,7 @@ class Switch extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@endtemplate} /// /// If null, then the value of [activeTrackColor] is used in the selected @@ -419,8 +419,8 @@ class Switch extends StatelessWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -441,7 +441,7 @@ class Switch extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@endtemplate} /// /// In Material 3, the outline color defaults to transparent in the selected @@ -458,8 +458,8 @@ class Switch extends StatelessWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -480,7 +480,7 @@ class Switch extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@endtemplate} /// /// Defaults to 2.0. @@ -495,8 +495,8 @@ class Switch extends StatelessWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -517,7 +517,7 @@ class Switch extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// {@endtemplate} /// /// If null, then the value of [SwitchThemeData.thumbIcon] is used. If this is also null, diff --git a/packages/material_ui/lib/src/switch_list_tile.dart b/packages/material_ui/lib/src/switch_list_tile.dart index a061c1f4ca67..d281fef1f3f9 100644 --- a/packages/material_ui/lib/src/switch_list_tile.dart +++ b/packages/material_ui/lib/src/switch_list_tile.dart @@ -66,8 +66,8 @@ enum _SwitchListTileType { material, adaptive } /// [SwitchListTile] itself but by the [Material] widget ancestor. In this /// case, one can wrap a [Material] widget around the [SwitchListTile], e.g.: /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -85,7 +85,7 @@ enum _SwitchListTileType { material, adaptive } /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// ## Performance considerations when wrapping [SwitchListTile] with [Material] /// @@ -324,8 +324,8 @@ class SwitchListTile extends StatelessWidget { /// [StatefulWidget] using the [State.setState] method, so that the parent /// gets rebuilt; for example: /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -341,7 +341,7 @@ class SwitchListTile extends StatelessWidget { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// final ValueChanged? onChanged; /// {@macro flutter.material.switch.activeColor} diff --git a/packages/material_ui/lib/src/tab_controller.dart b/packages/material_ui/lib/src/tab_controller.dart index d9d39d2cdb6b..30da89d70c51 100644 --- a/packages/material_ui/lib/src/tab_controller.dart +++ b/packages/material_ui/lib/src/tab_controller.dart @@ -32,8 +32,8 @@ import 'constants.dart'; /// /// {@animation 700 540 https://flutter.github.io/assets-for-api-docs/assets/material/tabs.mp4} /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -92,7 +92,7 @@ import 'constants.dart'; /// } /// ``` /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 @@ -400,8 +400,8 @@ class DefaultTabController extends StatefulWidget { /// The closest instance of [DefaultTabController] that encloses the given /// context, or null if none is found. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// Typical usage is as follows: @@ -410,7 +410,7 @@ class DefaultTabController extends StatefulWidget { /// TabController? controller = DefaultTabController.maybeOf(context); /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// Calling this method will create a dependency on the closest /// [DefaultTabController] in the [context], if there is one. @@ -432,8 +432,8 @@ class DefaultTabController extends StatefulWidget { /// Calling this method will create a dependency on the closest /// [DefaultTabController] in the [context]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// Typical usage is as follows: @@ -442,7 +442,7 @@ class DefaultTabController extends StatefulWidget { /// TabController controller = DefaultTabController.of(context); /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// diff --git a/packages/material_ui/lib/src/tabs.dart b/packages/material_ui/lib/src/tabs.dart index de3acbc6dc34..7b4dff2ba3eb 100644 --- a/packages/material_ui/lib/src/tabs.dart +++ b/packages/material_ui/lib/src/tabs.dart @@ -159,8 +159,8 @@ class Tab extends StatelessWidget implements PreferredSizeWidget { /// null along with `child` or `text`, the default height is 72.0 pixels. Without an `icon`, the /// height is 46.0 pixels. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -186,7 +186,7 @@ class Tab extends StatelessWidget implements PreferredSizeWidget { /// ), /// ``` /// - // TODO(framework): End of the blue example container. + /// final double? height; Widget _buildLabelText() { diff --git a/packages/material_ui/lib/src/text_field.dart b/packages/material_ui/lib/src/text_field.dart index f2af4fc6c2c8..8b9e717688c5 100644 --- a/packages/material_ui/lib/src/text_field.dart +++ b/packages/material_ui/lib/src/text_field.dart @@ -808,8 +808,8 @@ class TextField extends StatefulWidget { /// accessibility, but it also needs to be accessible itself. For example, /// if returning a Text widget, set the [Text.semanticsLabel] property. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -829,7 +829,7 @@ class TextField extends StatefulWidget { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// If buildCounter returns null, then no counter and no Semantics widget will /// be created at all. diff --git a/packages/material_ui/lib/src/text_form_field.dart b/packages/material_ui/lib/src/text_form_field.dart index d835c830e64c..abca0b5e0d25 100644 --- a/packages/material_ui/lib/src/text_form_field.dart +++ b/packages/material_ui/lib/src/text_form_field.dart @@ -47,8 +47,8 @@ export 'package:flutter/services.dart' show SmartDashesType, SmartQuotesType; /// /// For a documentation about the various parameters, see [TextField]. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -75,7 +75,7 @@ export 'package:flutter/services.dart' show SmartDashesType, SmartQuotesType; /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 diff --git a/packages/material_ui/lib/src/text_selection_theme.dart b/packages/material_ui/lib/src/text_selection_theme.dart index c9801d98024a..a90d96eba5d7 100644 --- a/packages/material_ui/lib/src/text_selection_theme.dart +++ b/packages/material_ui/lib/src/text_selection_theme.dart @@ -124,8 +124,8 @@ class TextSelectionThemeData with Diagnosticable { /// Values specified here are used for [TextField] and [SelectableText] /// properties that are not given an explicit non-null value. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -142,7 +142,7 @@ class TextSelectionThemeData with Diagnosticable { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// This widget also creates a [DefaultSelectionStyle] for its subtree with /// [data]. diff --git a/packages/material_ui/lib/src/text_theme.dart b/packages/material_ui/lib/src/text_theme.dart index 64bab53769a1..6fcce4c14322 100644 --- a/packages/material_ui/lib/src/text_theme.dart +++ b/packages/material_ui/lib/src/text_theme.dart @@ -237,8 +237,8 @@ class TextTheme with Diagnosticable { /// the typography styles in the Material Design specification, as a starting /// point. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -268,7 +268,7 @@ class TextTheme with Diagnosticable { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// @@ -329,8 +329,8 @@ class TextTheme with Diagnosticable { /// [TextTheme] has only some fields defined, and you want to define the rest /// by merging it with a default theme. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -358,7 +358,7 @@ class TextTheme with Diagnosticable { /// } /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See also: /// diff --git a/packages/material_ui/lib/src/theme_data.dart b/packages/material_ui/lib/src/theme_data.dart index b2326966eeca..5e9bd0ac40b7 100644 --- a/packages/material_ui/lib/src/theme_data.dart +++ b/packages/material_ui/lib/src/theme_data.dart @@ -832,8 +832,8 @@ class ThemeData with Diagnosticable { /// forward we will be converting all the widget implementations to only use /// colors or colors derived from those in [ColorScheme]. /// - // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// + /// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -847,7 +847,7 @@ class ThemeData with Diagnosticable { /// ) /// ``` /// - // TODO(framework): End of the blue example container. + /// /// /// See for /// more discussion on how to pick the right colors. diff --git a/packages/material_ui/lib/src/time.dart b/packages/material_ui/lib/src/time.dart index 2f99a7f4d77f..ca8820f5c08c 100644 --- a/packages/material_ui/lib/src/time.dart +++ b/packages/material_ui/lib/src/time.dart @@ -30,8 +30,8 @@ enum DayPeriod { /// minute or using [DateTime] object. /// Hours are specified between 0 and 23, as in a 24-hour clock. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -41,7 +41,7 @@ enum DayPeriod { /// TimeOfDay roomBooked = TimeOfDay.fromDateTime(DateTime.parse('2018-10-20 16:30:04Z')); // 4:30pm /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: /// diff --git a/packages/material_ui/lib/src/time_picker.dart b/packages/material_ui/lib/src/time_picker.dart index 783e012a2bc9..5f3259e21284 100644 --- a/packages/material_ui/lib/src/time_picker.dart +++ b/packages/material_ui/lib/src/time_picker.dart @@ -3142,8 +3142,8 @@ class _TimePickerState extends State<_TimePicker> with RestorationMixin { /// The returned Future resolves to the time selected by the user when the user /// closes the dialog. If the user cancels the dialog, null is returned. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// Show a dialog with [initialTime] equal to the current time. @@ -3155,7 +3155,7 @@ class _TimePickerState extends State<_TimePicker> with RestorationMixin { /// ); /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// The [context], [barrierDismissible], [barrierColor], [barrierLabel], /// [useRootNavigator] and [routeSettings] arguments are passed to [showDialog], @@ -3201,8 +3201,8 @@ class _TimePickerState extends State<_TimePicker> with RestorationMixin { /// [ColorScheme]. The time picker can be further customized by providing a /// [TimePickerThemeData] to the overall theme. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// Show a dialog with the text direction overridden to be @@ -3221,10 +3221,10 @@ class _TimePickerState extends State<_TimePicker> with RestorationMixin { /// ); /// ``` /// -// TODO(framework): End of the blue example container. +/// +/// +/// /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// Show a dialog with time unconditionally displayed in 24 hour @@ -3243,7 +3243,7 @@ class _TimePickerState extends State<_TimePicker> with RestorationMixin { /// ); /// ``` /// -// TODO(framework): End of the blue example container. +/// /// // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 diff --git a/packages/material_ui/lib/src/tooltip_theme.dart b/packages/material_ui/lib/src/tooltip_theme.dart index f2bba12ffda5..4b130d2e75c0 100644 --- a/packages/material_ui/lib/src/tooltip_theme.dart +++ b/packages/material_ui/lib/src/tooltip_theme.dart @@ -297,8 +297,8 @@ class TooltipThemeData with Diagnosticable { /// Descendant widgets obtain the ambient tooltip theme, a [TooltipThemeData], /// using [TooltipTheme.of]. /// -// TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// +/// // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -324,7 +324,7 @@ class TooltipThemeData with Diagnosticable { /// ) /// ``` /// -// TODO(framework): End of the blue example container. +/// /// /// See also: ///