From 6207aefadf4b271219cb32bf0bad2e1143a18ac0 Mon Sep 17 00:00:00 2001 From: Kate Lovett Date: Mon, 29 Jun 2026 14:56:28 -0500 Subject: [PATCH 1/7] Migrate cupertino_ui doc comments to @example --- analysis_options.yaml | 3 ++ .../lib/src/activity_indicator.dart | 18 ++++--- packages/cupertino_ui/lib/src/app.dart | 45 ++++++++++++---- .../cupertino_ui/lib/src/bottom_tab_bar.dart | 9 ++-- packages/cupertino_ui/lib/src/button.dart | 9 ++-- packages/cupertino_ui/lib/src/checkbox.dart | 18 +++++-- packages/cupertino_ui/lib/src/colors.dart | 27 +++++++--- .../cupertino_ui/lib/src/context_menu.dart | 45 +++++++++++----- .../cupertino_ui/lib/src/date_picker.dart | 36 +++++++++---- packages/cupertino_ui/lib/src/dialog.dart | 27 ++++++---- .../cupertino_ui/lib/src/expansion_tile.dart | 9 ++-- packages/cupertino_ui/lib/src/form_row.dart | 9 ++-- packages/cupertino_ui/lib/src/icons.dart | 9 +++- .../cupertino_ui/lib/src/list_section.dart | 18 ++++--- packages/cupertino_ui/lib/src/list_tile.dart | 9 ++-- packages/cupertino_ui/lib/src/magnifier.dart | 18 +++++-- .../cupertino_ui/lib/src/menu_anchor.dart | 36 ++++++++----- packages/cupertino_ui/lib/src/nav_bar.dart | 54 ++++++++++++------- .../cupertino_ui/lib/src/page_scaffold.dart | 9 ++-- packages/cupertino_ui/lib/src/picker.dart | 9 ++-- packages/cupertino_ui/lib/src/radio.dart | 18 ++++--- packages/cupertino_ui/lib/src/refresh.dart | 9 ++-- packages/cupertino_ui/lib/src/route.dart | 18 ++++--- packages/cupertino_ui/lib/src/scrollbar.dart | 18 ++++--- .../cupertino_ui/lib/src/search_field.dart | 18 ++++--- .../lib/src/segmented_control.dart | 9 ++-- packages/cupertino_ui/lib/src/sheet.dart | 45 ++++++++++------ packages/cupertino_ui/lib/src/slider.dart | 27 +++++++--- .../lib/src/sliding_segmented_control.dart | 27 +++++++--- packages/cupertino_ui/lib/src/switch.dart | 54 ++++++++++++++----- .../cupertino_ui/lib/src/tab_scaffold.dart | 18 ++++--- packages/cupertino_ui/lib/src/text_field.dart | 18 +++++-- .../lib/src/text_form_field_row.dart | 18 +++++-- 33 files changed, 503 insertions(+), 211 deletions(-) diff --git a/analysis_options.yaml b/analysis_options.yaml index 212c3e2fd157..ddbf5764b899 100644 --- a/analysis_options.yaml +++ b/analysis_options.yaml @@ -16,6 +16,9 @@ analyzer: # something (https://github.com/flutter/flutter/issues/143312) deprecated_member_use: ignore deprecated_member_use_from_same_package: ignore + # `dart analyze` hasn't recognized this new directive yet. + # Remove it once https://github.com/dart-lang/sdk/pull/63646 is landed. + doc_directive_unknown: ignore exclude: # DIFFERENT FROM FLUTTER/FLUTTER # Ignore generated files - '**/*.pb.dart' diff --git a/packages/cupertino_ui/lib/src/activity_indicator.dart b/packages/cupertino_ui/lib/src/activity_indicator.dart index 14d213227705..9fc2f01d1143 100644 --- a/packages/cupertino_ui/lib/src/activity_indicator.dart +++ b/packages/cupertino_ui/lib/src/activity_indicator.dart @@ -21,11 +21,14 @@ const Color _kActiveTickColor = CupertinoDynamicColor.withBrightness( /// /// {@youtube 560 315 https://www.youtube.com/watch?v=AENVH-ZqKDQ} /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows how [CupertinoActivityIndicator] can be customized. /// -/// ** See code in examples/api/lib/cupertino/activity_indicator/cupertino_activity_indicator.0.dart ** -/// {@end-tool} +/// {@example /example/lib/activity_indicator/cupertino_activity_indicator.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -201,11 +204,14 @@ class _CupertinoActivityIndicatorPainter extends CustomPainter { /// The [CupertinoLinearActivityIndicator] is a linear progress bar that /// displays a colored bar to indicate the progress of an ongoing task. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows how [CupertinoLinearActivityIndicator] can be customized. /// -/// ** See code in examples/api/lib/cupertino/activity_indicator/cupertino_linear_activity_indicator.0.dart ** -/// {@end-tool} +/// {@example /example/lib/activity_indicator/cupertino_linear_activity_indicator.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/app.dart b/packages/cupertino_ui/lib/src/app.dart index 91591a598b1a..58e21df3c689 100644 --- a/packages/cupertino_ui/lib/src/app.dart +++ b/packages/cupertino_ui/lib/src/app.dart @@ -67,7 +67,11 @@ import 'theme.dart'; /// * The San Francisco font family is unavailable on Android and can result /// in undefined font behavior. /// -/// {@tool snippet} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// This example shows how to create a [CupertinoApp] that disables the "debug" /// banner with a [home] route that will be displayed when the app is launched. /// @@ -84,9 +88,14 @@ import 'theme.dart'; /// debugShowCheckedModeBanner: false, /// ) /// ``` -/// {@end-tool} /// -/// {@tool snippet} +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// This example shows how to create a [CupertinoApp] that uses the [routes] /// `Map` to define the "home" route and an "about" route. /// @@ -112,9 +121,14 @@ import 'theme.dart'; /// }, /// ) /// ``` -/// {@end-tool} /// -/// {@tool snippet} +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// This example shows how to create a [CupertinoApp] that defines a [theme] that /// will be used for Cupertino widgets in the app. /// @@ -134,7 +148,8 @@ import 'theme.dart'; /// ), /// ) /// ``` -/// {@end-tool} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -357,7 +372,11 @@ class CupertinoApp extends StatefulWidget { final bool debugShowCheckedModeBanner; /// {@macro flutter.widgets.widgetsApp.shortcuts} - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// This example shows how to add a single shortcut for /// [LogicalKeyboardKey.select] to the default shortcuts without needing to /// add your own [Shortcuts] widget. @@ -380,12 +399,17 @@ class CupertinoApp extends StatefulWidget { /// ); /// } /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. /// {@macro flutter.widgets.widgetsApp.shortcuts.seeAlso} final Map? shortcuts; /// {@macro flutter.widgets.widgetsApp.actions} - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// This example shows how to add a single action handling an /// [ActivateAction] to the default actions without needing to /// add your own [Actions] widget. @@ -413,7 +437,8 @@ class CupertinoApp extends StatefulWidget { /// ); /// } /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. /// {@macro flutter.widgets.widgetsApp.actions.seeAlso} final Map>? actions; diff --git a/packages/cupertino_ui/lib/src/bottom_tab_bar.dart b/packages/cupertino_ui/lib/src/bottom_tab_bar.dart index 91216def0cc6..9de51ddf7568 100644 --- a/packages/cupertino_ui/lib/src/bottom_tab_bar.dart +++ b/packages/cupertino_ui/lib/src/bottom_tab_bar.dart @@ -46,11 +46,14 @@ const Color _kDefaultTabBarInactiveColor = CupertinoColors.inactiveGray; /// this behavior, wrap each of the `navigationBar`'s components inside a /// [MediaQuery] with the desired [TextScaler]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a [CupertinoTabBar] placed in a [CupertinoTabScaffold]. /// -/// ** See code in examples/api/lib/cupertino/bottom_tab_bar/cupertino_tab_bar.0.dart ** -/// {@end-tool} +/// {@example /example/lib/bottom_tab_bar/cupertino_tab_bar.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/button.dart b/packages/cupertino_ui/lib/src/button.dart index f87df8c1d6fd..b39fc5fd5bca 100644 --- a/packages/cupertino_ui/lib/src/button.dart +++ b/packages/cupertino_ui/lib/src/button.dart @@ -58,12 +58,15 @@ enum _CupertinoButtonStyle { /// with the [CupertinoThemeData.primaryColor] (or /// [CupertinoThemeData.primaryContrastingColor] if the button is disabled). /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample shows produces an enabled and disabled [CupertinoButton] and /// [CupertinoButton.filled]. /// -/// ** See code in examples/api/lib/cupertino/button/cupertino_button.0.dart ** -/// {@end-tool} +/// {@example /example/lib/button/cupertino_button.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/checkbox.dart b/packages/cupertino_ui/lib/src/checkbox.dart index 7feb65121fa9..0e09232884e8 100644 --- a/packages/cupertino_ui/lib/src/checkbox.dart +++ b/packages/cupertino_ui/lib/src/checkbox.dart @@ -73,11 +73,14 @@ const List _kDisabledDarkGradientOpacities = [0.08, 0.14]; /// [kMinInteractiveDimensionCupertino] pixels to meet accessibility /// guidelines. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a toggleable [CupertinoCheckbox]. /// -/// ** See code in examples/api/lib/cupertino/checkbox/cupertino_checkbox.0.dart ** -/// {@end-tool} +/// {@example /example/lib/checkbox/cupertino_checkbox.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -202,7 +205,11 @@ class CupertinoCheckbox extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// This example resolves the [fillColor] based on the current [WidgetState] /// of the [CupertinoCheckbox], providing a different [Color] when it is /// [WidgetState.disabled]. @@ -219,7 +226,8 @@ class CupertinoCheckbox extends StatefulWidget { /// }) /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): 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 2c93f5559e48..c6a808309e46 100644 --- a/packages/cupertino_ui/lib/src/colors.dart +++ b/packages/cupertino_ui/lib/src/colors.dart @@ -661,7 +661,11 @@ abstract final class CupertinoColors { /// [CupertinoDynamicColor.resolve] against its own [BuildContext], on a best-effort /// basis. /// -/// {@tool snippet} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// By default a [CupertinoButton] has no background color. The following sample /// code shows how to build a [CupertinoButton] that appears white in light mode, /// and changes automatically to black in dark mode. @@ -677,7 +681,8 @@ abstract final class CupertinoColors { /// child: child, /// ) /// ``` -/// {@end-tool} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// ### Using a [CupertinoDynamicColor] from a [CupertinoTheme] /// @@ -686,7 +691,11 @@ abstract final class CupertinoColors { /// implicitly resolves all the colors used in the retrieved [CupertinoThemeData], /// before returning it. /// -/// {@tool snippet} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// The following code sample creates a [Container] with the `primaryColor` of the /// current theme. If `primaryColor` is a [CupertinoDynamicColor], the container /// will be adaptive, thanks to [CupertinoTheme.of]: it will switch to `primaryColor`'s @@ -701,7 +710,8 @@ abstract final class CupertinoColors { /// color: CupertinoTheme.of(context).primaryColor, /// ) /// ``` -/// {@end-tool} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// ### Manually Resolving a [CupertinoDynamicColor] /// @@ -712,7 +722,11 @@ abstract final class CupertinoColors { /// the colors used in the [Border] have to be resolved manually before being passed /// to [CupertinoNavigationBar]'s constructor. /// -/// {@tool snippet} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// /// The following code samples demonstrate two cases where you have to manually /// resolve a [CupertinoDynamicColor]. @@ -735,7 +749,8 @@ abstract final class CupertinoColors { /// color: CupertinoDynamicColor.resolve(CupertinoColors.systemBlue, context), /// ) /// ``` -/// {@end-tool} +/// +// TODO(dkwingsmt): 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 e8e15af266a6..10c04490b518 100644 --- a/packages/cupertino_ui/lib/src/context_menu.dart +++ b/packages/cupertino_ui/lib/src/context_menu.dart @@ -96,19 +96,25 @@ enum _ContextMenuLocation { center, left, right } /// background or by calling `Navigator.pop(context)`. Unlike [PopupRoute], it can /// also be closed by swiping downwards. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample shows a very simple [CupertinoContextMenu] for the Flutter logo. /// Long press on it to open. /// -/// ** See code in examples/api/lib/cupertino/context_menu/cupertino_context_menu.0.dart ** -/// {@end-tool} +/// {@example /example/lib/context_menu/cupertino_context_menu.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// This sample shows a similar CupertinoContextMenu, this time using [builder] /// to add a border radius to the widget. /// -/// ** See code in examples/api/lib/cupertino/context_menu/cupertino_context_menu.1.dart ** -/// {@end-tool} +/// {@example /example/lib/context_menu/cupertino_context_menu.1.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -142,7 +148,11 @@ 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. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// /// Below is example code in order to match the default border radius for an /// iOS 16.0 open preview. @@ -205,7 +215,8 @@ class CupertinoContextMenu extends StatefulWidget { /// ) /// ``` /// - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. static const double kOpenBorderRadius = _previewBorderRadiusRatio; /// Exposes the final box shadow of the opening animation of the child widget @@ -248,7 +259,11 @@ 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. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// /// Below is an example of using [builder] to show an image tile setup to be /// opened in the default way to match a native iOS 16.0 app. The behavior @@ -314,9 +329,12 @@ class CupertinoContextMenu extends StatefulWidget { /// ) /// ``` /// - /// {@end-tool} /// - /// {@tool dartpad} + // TODO(dkwingsmt): End of the blue example container. + /// + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// /// Additionally below is an example of a real world use case for [builder]. /// /// If a widget is passed to the [child] parameter with properties that @@ -327,8 +345,9 @@ class CupertinoContextMenu extends StatefulWidget { /// like [CupertinoContextMenu.kEndBoxShadow], to match the native iOS /// animation as close as desired. /// - /// ** See code in examples/api/lib/cupertino/context_menu/cupertino_context_menu.1.dart ** - /// {@end-tool} + /// {@example /example/lib/context_menu/cupertino_context_menu.1.dart} + /// + // TODO(dkwingsmt): End of the blue example container. final CupertinoContextMenuBuilder builder; // TODO(mitchgoodwin): deprecate [child] with builder refactor https://github.com/flutter/flutter/issues/116306 diff --git a/packages/cupertino_ui/lib/src/date_picker.dart b/packages/cupertino_ui/lib/src/date_picker.dart index 073221be2577..a962e7f84f20 100644 --- a/packages/cupertino_ui/lib/src/date_picker.dart +++ b/packages/cupertino_ui/lib/src/date_picker.dart @@ -230,15 +230,18 @@ enum _PickerColumnType { /// full screen width. Content texts are shown with /// [CupertinoTextThemeData.dateTimePickerTextStyle]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample shows how to implement CupertinoDatePicker with different picker modes. /// We can provide initial dateTime value for the picker to display. When user changes /// the drag the date or time wheels, the picker will call onDateTimeChanged callback. /// /// CupertinoDatePicker can be displayed directly on a screen or in a popup. /// -/// ** See code in examples/api/lib/cupertino/date_picker/cupertino_date_picker.0.dart ** -/// {@end-tool} +/// {@example /example/lib/date_picker/cupertino_date_picker.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -480,7 +483,11 @@ class CupertinoDatePicker extends StatefulWidget { /// /// If the selection overlay builder returns null, no overlay will be drawn. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// /// This example shows how to recreate the default selection overlay /// with selectionOverlayBuilder. @@ -511,7 +518,8 @@ class CupertinoDatePicker extends StatefulWidget { /// }, /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. final SelectionOverlayBuilder? selectionOverlayBuilder; /// The behavior of reporting the selected date. @@ -2165,11 +2173,14 @@ enum CupertinoTimerPickerMode { /// provides more space than it needs, the picker will position itself according /// to its [alignment] property. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a [CupertinoTimerPicker] that returns a countdown duration. /// -/// ** See code in examples/api/lib/cupertino/date_picker/cupertino_timer_picker.0.dart ** -/// {@end-tool} +/// {@example /example/lib/date_picker/cupertino_timer_picker.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -2256,7 +2267,11 @@ class CupertinoTimerPicker extends StatefulWidget { /// /// If the selection overlay builder returns null, no overlay will be drawn. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// /// This example shows how to recreate the default selection overlay /// with selectionOverlayBuilder. @@ -2285,7 +2300,8 @@ class CupertinoTimerPicker extends StatefulWidget { /// }, /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. final SelectionOverlayBuilder? selectionOverlayBuilder; /// The behavior of reporting the selected duration. diff --git a/packages/cupertino_ui/lib/src/dialog.dart b/packages/cupertino_ui/lib/src/dialog.dart index fd7bc8b1f9e7..4fc964ac0a99 100644 --- a/packages/cupertino_ui/lib/src/dialog.dart +++ b/packages/cupertino_ui/lib/src/dialog.dart @@ -213,13 +213,16 @@ bool _isInAccessibilityMode(BuildContext context) { /// Typically passed as the child widget to [showDialog], which displays the /// dialog. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample shows how to use a [CupertinoAlertDialog]. /// The [CupertinoAlertDialog] shows an alert with a set of two choices /// when [CupertinoButton] is pressed. /// -/// ** See code in examples/api/lib/cupertino/dialog/cupertino_alert_dialog.0.dart ** -/// {@end-tool} +/// {@example /example/lib/dialog/cupertino_alert_dialog.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -517,13 +520,16 @@ class _CupertinoAlertDialogState extends State { /// which is useful for more complicated layouts, such as rendering divider gaps /// in [CupertinoAlertDialog] or rendering custom surface colors. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample shows how to use a [CupertinoPopupSurface]. The [CupertinoPopupSurface] /// shows a modal popup from the bottom of the screen. /// Toggle the switch to configure its surface color. /// -/// ** See code in examples/api/lib/cupertino/dialog/cupertino_popup_surface.0.dart ** -/// {@end-tool} +/// {@example /example/lib/dialog/cupertino_popup_surface.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -1052,13 +1058,16 @@ class _ActionSheetGestureDetector extends StatelessWidget { /// [showCupertinoModalPopup], which displays the action sheet by sliding it up /// from the bottom of the screen. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample shows how to use a [CupertinoActionSheet]. /// The [CupertinoActionSheet] shows a modal popup that slides in from the /// bottom when [CupertinoButton] is pressed. /// -/// ** See code in examples/api/lib/cupertino/dialog/cupertino_action_sheet.0.dart ** -/// {@end-tool} +/// {@example /example/lib/dialog/cupertino_action_sheet.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/expansion_tile.dart b/packages/cupertino_ui/lib/src/expansion_tile.dart index 14e06f10c8ea..cf6d255c3363 100644 --- a/packages/cupertino_ui/lib/src/expansion_tile.dart +++ b/packages/cupertino_ui/lib/src/expansion_tile.dart @@ -59,11 +59,14 @@ enum ExpansionTileTransitionMode { /// A single-line [CupertinoListTile] with an expansion arrow icon that expands /// or collapses the tile to reveal or hide the [child]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows how to use [CupertinoExpansionTile] with different transition modes. /// -/// ** See code in examples/api/lib/cupertino/expansion_tile/cupertino_expansion_tile.0.dart ** -/// {@end-tool} +/// {@example /example/lib/expansion_tile/cupertino_expansion_tile.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/form_row.dart b/packages/cupertino_ui/lib/src/form_row.dart index 1257a8c984fd..ea37cec1fdb0 100644 --- a/packages/cupertino_ui/lib/src/form_row.dart +++ b/packages/cupertino_ui/lib/src/form_row.dart @@ -36,12 +36,15 @@ const EdgeInsetsGeometry _kDefaultPadding = EdgeInsetsDirectional.fromSTEB(20.0, /// be shown in [CupertinoColors.destructiveRed] coloring and /// medium-weighted font. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// Creates a [CupertinoFormSection] containing a [CupertinoFormRow] with [prefix], /// [child], [helper] and [error] specified. /// -/// ** See code in examples/api/lib/cupertino/form_row/cupertino_form_row.0.dart ** -/// {@end-tool} +/// {@example /example/lib/form_row/cupertino_form_row.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// class CupertinoFormRow extends StatelessWidget { /// Creates an iOS-style split form row with a standard prefix and child widget. diff --git a/packages/cupertino_ui/lib/src/icons.dart b/packages/cupertino_ui/lib/src/icons.dart index 1306f0de868f..dd7ec7cbf393 100644 --- a/packages/cupertino_ui/lib/src/icons.dart +++ b/packages/cupertino_ui/lib/src/icons.dart @@ -21,7 +21,11 @@ import 'package:flutter/widgets.dart'; /// cupertino_icons: ^1.0.0 /// ``` /// -/// {@tool snippet} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// /// This example shows how to create a [Row] of Cupertino [Icon]s in different colors and /// sizes. The first [Icon] uses a [Icon.semanticLabel] to announce in accessibility @@ -52,7 +56,8 @@ import 'package:flutter/widgets.dart'; /// ], /// ) /// ``` -/// {@end-tool} +/// +// TODO(dkwingsmt): 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/list_section.dart b/packages/cupertino_ui/lib/src/list_section.dart index 14f75fd85947..00a988a763cc 100644 --- a/packages/cupertino_ui/lib/src/list_section.dart +++ b/packages/cupertino_ui/lib/src/list_section.dart @@ -161,20 +161,26 @@ enum CupertinoListSectionType { /// /// {@macro flutter.material.Material.clipBehavior} /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// Creates a base [CupertinoListSection] containing [CupertinoListTile]s with /// `leading`, `title`, `additionalInfo` and `trailing` widgets. /// -/// ** See code in examples/api/lib/cupertino/list_section/list_section_base.0.dart ** -/// {@end-tool} +/// {@example /example/lib/list_section/list_section_base.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// Creates an "Inset Grouped" [CupertinoListSection] containing /// notched [CupertinoListTile]s with `leading`, `title`, `additionalInfo` and /// `trailing` widgets. /// -/// ** See code in examples/api/lib/cupertino/list_section/list_section_inset.0.dart ** -/// {@end-tool} +/// {@example /example/lib/list_section/list_section_inset.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/list_tile.dart b/packages/cupertino_ui/lib/src/list_tile.dart index 2b726e1de294..92fa156ad9eb 100644 --- a/packages/cupertino_ui/lib/src/list_tile.dart +++ b/packages/cupertino_ui/lib/src/list_tile.dart @@ -78,12 +78,15 @@ enum _CupertinoListTileType { base, notched } /// behavior it should not be used for example to toggle the [CupertinoSwitch] /// in the trailing widget. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example uses a [ListView] to demonstrate different configurations of /// [CupertinoListTile]s. /// -/// ** See code in examples/api/lib/cupertino/list_tile/cupertino_list_tile.0.dart ** -/// {@end-tool} +/// {@example /example/lib/list_tile/cupertino_list_tile.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/magnifier.dart b/packages/cupertino_ui/lib/src/magnifier.dart index 322aeaaaffa7..a679e6fd02f0 100644 --- a/packages/cupertino_ui/lib/src/magnifier.dart +++ b/packages/cupertino_ui/lib/src/magnifier.dart @@ -14,11 +14,16 @@ 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. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// This sample demonstrates how to use [CupertinoTextMagnifier]. /// /// ** See code in examples/api/lib/widgets/magnifier/cupertino_text_magnifier.0.dart ** -/// {@end-tool} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// Delegates styling to [CupertinoMagnifier] with its position depending on /// [magnifierInfo]. @@ -221,11 +226,16 @@ 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. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// This sample demonstrates how to use [CupertinoMagnifier]. /// /// ** See code in examples/api/lib/widgets/magnifier/cupertino_magnifier.0.dart ** -/// {@end-tool} +/// +// TODO(dkwingsmt): 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 1a99b5c4c397..da908d954108 100644 --- a/packages/cupertino_ui/lib/src/menu_anchor.dart +++ b/packages/cupertino_ui/lib/src/menu_anchor.dart @@ -295,19 +295,25 @@ typedef CupertinoMenuAnimationStatusChangedCallback = void Function(AnimationSta /// invoked every time the [AnimationStatus] of the menu animation changes. /// /// ## Usage -/// {@tool sample} +// TODO(dkwingsmt): 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. /// -/// ** See code in examples/api/lib/cupertino/menu_anchor/menu_anchor.0.dart ** -/// {@end-tool} +/// {@example /example/lib/menu_anchor/menu_anchor.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// This example demonstrates a [CupertinoMenuAnchor] that wraps a button and /// shows a menu with three [CupertinoMenuItem]s and one [CupertinoMenuDivider]. /// -/// ** See code in examples/api/lib/cupertino/menu_anchor/menu_anchor.1.dart ** -/// {@end-tool} +/// {@example /example/lib/menu_anchor/menu_anchor.1.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -1695,19 +1701,25 @@ class _CupertinoDividerPainter extends CustomPainter { /// will perform a destructive action, and will color the text of the menu item /// [CupertinoColors.systemRed]. /// -/// {@tool sample} +// TODO(dkwingsmt): 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. /// -/// ** See code in examples/api/lib/cupertino/menu_anchor/menu_anchor.0.dart ** -/// {@end-tool} +/// {@example /example/lib/menu_anchor/menu_anchor.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// This example demonstrates a [CupertinoMenuAnchor] that wraps a button and /// shows a menu with three [CupertinoMenuItem]s and one [CupertinoMenuDivider]. /// -/// ** See code in examples/api/lib/cupertino/menu_anchor/menu_anchor.1.dart ** -/// {@end-tool} +/// {@example /example/lib/menu_anchor/menu_anchor.1.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// * [CupertinoMenuAnchor], a Cupertino-style widget that shows a menu of diff --git a/packages/cupertino_ui/lib/src/nav_bar.dart b/packages/cupertino_ui/lib/src/nav_bar.dart index 4bc4175aa04a..0b30a9dfc11e 100644 --- a/packages/cupertino_ui/lib/src/nav_bar.dart +++ b/packages/cupertino_ui/lib/src/nav_bar.dart @@ -330,21 +330,27 @@ bool _isTransitionable(BuildContext context) { /// this behavior, wrap each of the `navigationBar`'s components inside a /// [MediaQuery] with the desired [TextScaler]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a [CupertinoNavigationBar] placed in a [CupertinoPageScaffold]. /// Since [backgroundColor]'s opacity is not 1.0, there is a blur effect and /// content slides underneath. /// -/// ** See code in examples/api/lib/cupertino/nav_bar/cupertino_navigation_bar.0.dart ** -/// {@end-tool} +/// {@example /example/lib/nav_bar/cupertino_navigation_bar.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// This example shows the resulting layout from [CupertinoNavigationBar.large] /// constructor, showing a large title similar to the expanded state of /// [CupertinoSliverNavigationBar]. /// -/// ** See code in examples/api/lib/cupertino/nav_bar/cupertino_navigation_bar.2.dart ** -/// {@end-tool} +/// {@example /example/lib/nav_bar/cupertino_navigation_bar.2.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -620,12 +626,15 @@ class CupertinoNavigationBar extends StatefulWidget implements ObstructingPrefer /// Only widgets that implement [PreferredSizeWidget] can be used at the /// bottom of a navigation bar. /// - /// {@tool dartpad} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// /// This example shows a [CupertinoSearchTextField] at the bottom of a /// [CupertinoNavigationBar]. /// - /// ** See code in examples/api/lib/cupertino/nav_bar/cupertino_navigation_bar.1.dart ** - /// {@end-tool} + /// {@example /example/lib/nav_bar/cupertino_navigation_bar.1.dart} + /// + // TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -926,17 +935,23 @@ class _CupertinoNavigationBarState extends State { /// user scrolls, but it will also stretch when the user over-scrolls if the /// [stretch] value is `true`. Defaults to `false`. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows [CupertinoSliverNavigationBar] in action inside a [CustomScrollView]. /// -/// ** See code in examples/api/lib/cupertino/nav_bar/cupertino_sliver_nav_bar.0.dart ** -/// {@end-tool} +/// {@example /example/lib/nav_bar/cupertino_sliver_nav_bar.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// To add a widget to the bottom of the nav bar, wrap it with [PreferredSize] and provide its fully extended size. /// -/// ** See code in examples/api/lib/cupertino/nav_bar/cupertino_sliver_nav_bar.2.dart ** -/// {@end-tool} +/// {@example /example/lib/nav_bar/cupertino_sliver_nav_bar.2.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -1000,12 +1015,15 @@ class CupertinoSliverNavigationBar extends StatefulWidget { /// If [automaticallyImplyTitle] is false, then the [largeTitle] argument is /// required. /// - /// {@tool dartpad} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// /// This example demonstrates how to use a /// [CupertinoSliverNavigationBar.search] to manage a search view. /// - /// ** See code in examples/api/lib/cupertino/nav_bar/cupertino_sliver_nav_bar.1.dart ** - /// {@end-tool} + /// {@example /example/lib/nav_bar/cupertino_sliver_nav_bar.1.dart} + /// + // TODO(dkwingsmt): End of the blue example container. const CupertinoSliverNavigationBar.search({ super.key, required Widget this.searchField, diff --git a/packages/cupertino_ui/lib/src/page_scaffold.dart b/packages/cupertino_ui/lib/src/page_scaffold.dart index 02e6fc9244db..776f6bc51cc3 100644 --- a/packages/cupertino_ui/lib/src/page_scaffold.dart +++ b/packages/cupertino_ui/lib/src/page_scaffold.dart @@ -25,13 +25,16 @@ import 'theme.dart'; /// encloses the [ScrollView]. The [ScrollView.primary] flag is used to connect /// a [ScrollView] to the enclosing [PrimaryScrollController]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a [CupertinoPageScaffold] with a [Center] as a [child]. /// The [CupertinoButton] is connected to a callback that increments a counter. /// The [backgroundColor] can be changed. /// -/// ** See code in examples/api/lib/cupertino/page_scaffold/cupertino_page_scaffold.0.dart ** -/// {@end-tool} +/// {@example /example/lib/page_scaffold/cupertino_page_scaffold.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/picker.dart b/packages/cupertino_ui/lib/src/picker.dart index 73e876af3118..aa89867abbe4 100644 --- a/packages/cupertino_ui/lib/src/picker.dart +++ b/packages/cupertino_ui/lib/src/picker.dart @@ -50,12 +50,15 @@ const Curve _kCupertinoPickerTapToScrollCurve = Curves.easeInOut; /// /// By default, descendent texts are shown with [CupertinoTextThemeData.pickerTextStyle]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a [CupertinoPicker] that displays a list of fruits on a wheel for /// selection. /// -/// ** See code in examples/api/lib/cupertino/picker/cupertino_picker.0.dart ** -/// {@end-tool} +/// {@example /example/lib/picker/cupertino_picker.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/radio.dart b/packages/cupertino_ui/lib/src/radio.dart index 02ef7a9bee8c..909d4ff59379 100644 --- a/packages/cupertino_ui/lib/src/radio.dart +++ b/packages/cupertino_ui/lib/src/radio.dart @@ -70,7 +70,9 @@ const List _kDisabledDarkGradientOpacities = [0.08, 0.14]; /// [RadioGroup.groupValue], and the [CupertinoRadio] under it with matching /// [value] will be selected. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// Here is an example of CupertinoRadio widgets wrapped in CupertinoListTiles. /// /// The currently selected character is passed into `RadioGroup.groupValue`, which is @@ -83,8 +85,9 @@ const List _kDisabledDarkGradientOpacities = [0.08, 0.14]; /// This causes the buttons to rebuild with the updated `RadioGroup.groupValue`, and /// therefore the selection of the second button. /// -/// ** See code in examples/api/lib/cupertino/radio/cupertino_radio.0.dart ** -/// {@end-tool} +/// {@example /example/lib/radio/cupertino_radio.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -174,12 +177,15 @@ class CupertinoRadio extends StatefulWidget { /// {@macro flutter.widget.RawRadio.toggleable} /// - /// {@tool dartpad} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// /// This example shows how to enable deselecting a radio button by setting the /// [toggleable] attribute. /// - /// ** See code in examples/api/lib/cupertino/radio/cupertino_radio.toggleable.0.dart ** - /// {@end-tool} + /// {@example /example/lib/radio/cupertino_radio.toggleable.0.dart} + /// + // TODO(dkwingsmt): End of the blue example container. final bool toggleable; /// Controls whether the radio displays in a checkbox style or the default iOS diff --git a/packages/cupertino_ui/lib/src/refresh.dart b/packages/cupertino_ui/lib/src/refresh.dart index 333e52cf8cd1..edf017881143 100644 --- a/packages/cupertino_ui/lib/src/refresh.dart +++ b/packages/cupertino_ui/lib/src/refresh.dart @@ -266,13 +266,16 @@ typedef RefreshCallback = Future Function(); /// sliver such as [CupertinoSliverNavigationBar] and your main scrollable /// content's sliver. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// When the user scrolls past [refreshTriggerPullDistance], /// this sample shows the default iOS pull to refresh indicator for 1 second and /// adds a new item to the top of the list view. /// -/// ** See code in examples/api/lib/cupertino/refresh/cupertino_sliver_refresh_control.0.dart ** -/// {@end-tool} +/// {@example /example/lib/refresh/cupertino_sliver_refresh_control.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/route.dart b/packages/cupertino_ui/lib/src/route.dart index 9469628230c7..fb4393be5274 100644 --- a/packages/cupertino_ui/lib/src/route.dart +++ b/packages/cupertino_ui/lib/src/route.dart @@ -1294,7 +1294,9 @@ class CupertinoModalPopupRoute extends PopupRoute { /// /// For more information about state restoration, see [RestorationManager]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample demonstrates how to create a restorable Cupertino modal route. /// This is accomplished by enabling state restoration by specifying /// [CupertinoApp.restorationScopeId] and using [Navigator.restorablePush] to @@ -1302,8 +1304,9 @@ class CupertinoModalPopupRoute extends PopupRoute { /// /// {@macro flutter.widgets.RestorationManager} /// -/// ** See code in examples/api/lib/cupertino/route/show_cupertino_modal_popup.0.dart ** -/// {@end-tool} +/// {@example /example/lib/route/show_cupertino_modal_popup.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -1387,7 +1390,9 @@ Widget _buildCupertinoDialogTransitions( /// /// For more information about state restoration, see [RestorationManager]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample demonstrates how to create a restorable Cupertino dialog. This is /// accomplished by enabling state restoration by specifying /// [CupertinoApp.restorationScopeId] and using [Navigator.restorablePush] to @@ -1395,8 +1400,9 @@ Widget _buildCupertinoDialogTransitions( /// /// {@macro flutter.widgets.RestorationManager} /// -/// ** See code in examples/api/lib/cupertino/route/show_cupertino_dialog.0.dart ** -/// {@end-tool} +/// {@example /example/lib/route/show_cupertino_dialog.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/scrollbar.dart b/packages/cupertino_ui/lib/src/scrollbar.dart index 7c17da2aac2b..deb8a0c9b327 100644 --- a/packages/cupertino_ui/lib/src/scrollbar.dart +++ b/packages/cupertino_ui/lib/src/scrollbar.dart @@ -43,23 +43,29 @@ const double _kScrollbarCrossAxisMargin = 3.0; /// animate from [thickness] and [radius] to [thicknessWhileDragging] and /// [radiusWhileDragging], respectively. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This sample shows a [CupertinoScrollbar] that fades in and out of view as scrolling occurs. /// The scrollbar will fade into view as the user scrolls, and fade out when scrolling stops. /// The `thickness` of the scrollbar will animate from 6 pixels to the `thicknessWhileDragging` of 10 /// when it is dragged by the user. The `radius` of the scrollbar thumb corners will animate from 34 /// to the `radiusWhileDragging` of 0 when the scrollbar is being dragged by the user. /// -/// ** See code in examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.0.dart ** -/// {@end-tool} +/// {@example /example/lib/scrollbar/cupertino_scrollbar.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// When [thumbVisibility] is true, the scrollbar thumb will remain visible without the /// fade animation. This requires that a [ScrollController] is provided to controller, /// or that the [PrimaryScrollController] is available. /// -/// ** See code in examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.1.dart ** -/// {@end-tool} +/// {@example /example/lib/scrollbar/cupertino_scrollbar.1.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/search_field.dart b/packages/cupertino_ui/lib/src/search_field.dart index 38be52d88bcf..0c43c6ad8259 100644 --- a/packages/cupertino_ui/lib/src/search_field.dart +++ b/packages/cupertino_ui/lib/src/search_field.dart @@ -38,23 +38,29 @@ const double _kMaxPrefixIconSize = 30.0; /// [controller]. For example, to set the initial value of the text field, use /// a [controller] that already contains some text such as: /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This examples shows how to provide initial text to a [CupertinoSearchTextField] /// using the [controller] property. /// -/// ** See code in examples/api/lib/cupertino/search_field/cupertino_search_field.0.dart ** -/// {@end-tool} +/// {@example /example/lib/search_field/cupertino_search_field.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// It is recommended to pass a [ValueChanged] to both [onChanged] and /// [onSubmitted] parameters in order to be notified once the value of the /// field changes or is submitted by the keyboard: /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This examples shows how to be notified of field changes or submitted text from /// a [CupertinoSearchTextField]. /// -/// ** See code in examples/api/lib/cupertino/search_field/cupertino_search_field.1.dart ** -/// {@end-tool} +/// {@example /example/lib/search_field/cupertino_search_field.1.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/segmented_control.dart b/packages/cupertino_ui/lib/src/segmented_control.dart index 25c3230bae88..a56d4be4a15d 100644 --- a/packages/cupertino_ui/lib/src/segmented_control.dart +++ b/packages/cupertino_ui/lib/src/segmented_control.dart @@ -70,7 +70,9 @@ const Duration _kFadeDuration = Duration(milliseconds: 165); /// [disabledChildren]. If the child is not present in the [Set], it is enabled /// by default. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a [CupertinoSegmentedControl] with an enum type. /// /// The callback provided to [onValueChanged] should update the state of @@ -80,8 +82,9 @@ const Duration _kFadeDuration = Duration(milliseconds: 165); /// This example also demonstrates how to use the [disabledChildren] property by /// toggling each [CupertinoSwitch] to enable or disable the segments. /// -/// ** See code in examples/api/lib/cupertino/segmented_control/cupertino_segmented_control.0.dart ** -/// {@end-tool} +/// {@example /example/lib/segmented_control/cupertino_segmented_control.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/sheet.dart b/packages/cupertino_ui/lib/src/sheet.dart index 60bb2a6b1844..5f70814690e9 100644 --- a/packages/cupertino_ui/lib/src/sheet.dart +++ b/packages/cupertino_ui/lib/src/sheet.dart @@ -158,12 +158,15 @@ typedef _GetSheetDragged = bool Function(); /// Returns a [Future] that resolves to the value (if any) that was passed to /// [Navigator.pop] when the sheet was closed. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows how to navigate to use [showCupertinoSheet] to display a /// Cupertino sheet widget with nested navigation. /// -/// ** See code in examples/api/lib/cupertino/sheet/cupertino_sheet.1.dart ** -/// {@end-tool} +/// {@example /example/lib/sheet/cupertino_sheet.1.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -608,25 +611,34 @@ class _StretchDragControllerProvider extends InheritedWidget { /// scrollable area within the sheet, this parameter can be ignored. See below /// for an example. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows how to navigate to [CupertinoSheetRoute] by using it the /// same as a regular route. /// -/// ** See code in examples/api/lib/cupertino/sheet/cupertino_sheet.0.dart ** -/// {@end-tool} +/// {@example /example/lib/sheet/cupertino_sheet.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// This example shows how to show a Cupertino Sheet with nested navigation manually /// set up in order to enable restorable state. /// -/// ** See code in examples/api/lib/cupertino/sheet/cupertino_sheet.2.dart ** -/// {@end-tool} +/// {@example /example/lib/sheet/cupertino_sheet.2.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// -/// {@tool dartpad} /// This example shows how to show a Cupertino Sheet with scrollable content. /// -/// ** See code in examples/api/lib/cupertino/sheet/cupertino_sheet.3.dart ** -/// {@end-tool} +/// {@example /example/lib/sheet/cupertino_sheet.3.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// * [showCupertinoSheet], which is a convenience method for pushing a @@ -667,11 +679,14 @@ class CupertinoSheetRoute extends PageRoute with _CupertinoSheetRouteTrans /// then when a downward drag is applied to the scrollable area while the content /// is scrolled to the top, the drag to dismiss behavior of the sheet will be triggered. /// - /// {@tool dartpad} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// /// This example shows how to show a Cupertino Sheet with scrollable content. /// - /// ** See code in examples/api/lib/cupertino/sheet/cupertino_sheet.3.dart ** - /// {@end-tool} + /// {@example /example/lib/sheet/cupertino_sheet.3.dart} + /// + // TODO(dkwingsmt): End of the blue example container. final ScrollableWidgetBuilder? scrollableBuilder; ScrollableWidgetBuilder get _effectiveBuilder { diff --git a/packages/cupertino_ui/lib/src/slider.dart b/packages/cupertino_ui/lib/src/slider.dart index e66129ab2d1e..7a895f315a19 100644 --- a/packages/cupertino_ui/lib/src/slider.dart +++ b/packages/cupertino_ui/lib/src/slider.dart @@ -52,11 +52,14 @@ const double _kVelocityThreshold = 1.0; /// that use a slider will listen for the [onChanged] callback and rebuild the /// slider with a new [value] to update the visual appearance of the slider. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows how to show the current slider value as it changes. /// -/// ** See code in examples/api/lib/cupertino/slider/cupertino_slider.0.dart ** -/// {@end-tool} +/// {@example /example/lib/slider/cupertino_slider.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -137,7 +140,11 @@ class CupertinoSlider extends StatefulWidget { /// The value passed will be the last [value] that the slider had before the /// change began. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// /// ```dart /// CupertinoSlider( @@ -155,7 +162,8 @@ class CupertinoSlider extends StatefulWidget { /// }, /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -169,7 +177,11 @@ class CupertinoSlider extends StatefulWidget { /// [onChanged] for that), but rather to know when the user has completed /// selecting a new [value] by ending a drag. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// /// ```dart /// CupertinoSlider( @@ -187,7 +199,8 @@ class CupertinoSlider extends StatefulWidget { /// }, /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): 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 d4be322cafb8..43df5a476766 100644 --- a/packages/cupertino_ui/lib/src/sliding_segmented_control.dart +++ b/packages/cupertino_ui/lib/src/sliding_segmented_control.dart @@ -340,15 +340,18 @@ class _SegmentSeparatorState extends State<_SegmentSeparator> /// [thumbColor], [backgroundColor] arguments can be used to override the /// segmented control's colors from its defaults. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a [CupertinoSlidingSegmentedControl] with an enum type. /// /// The callback provided to [onValueChanged] should update the state of /// the parent [StatefulWidget] using the [State.setState] method, so that /// the parent gets rebuilt; for example: /// -/// ** See code in examples/api/lib/cupertino/segmented_control/cupertino_sliding_segmented_control.0.dart ** -/// {@end-tool} +/// {@example /example/lib/segmented_control/cupertino_sliding_segmented_control.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// See also: /// /// * @@ -424,7 +427,11 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// the parent [StatefulWidget] using the [State.setState] method, so that /// the parent gets rebuilt; for example: /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// /// ```dart /// class SegmentedControlExample extends StatefulWidget { @@ -456,7 +463,8 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// } /// } /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. final ValueChanged onValueChanged; /// The color used to paint the rounded rect behind the [children] and the separators. @@ -500,13 +508,16 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// /// Defaults to false. /// - /// {@tool dartpad} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + /// /// This example shows a [CupertinoSlidingSegmentedControl] with [isMomentary] set /// to true, providing feedback to the user when the segment is selected with a /// text scaling effect. /// - /// ** See code in examples/api/lib/cupertino/segmented_control/cupertino_sliding_segmented_control.0.dart ** - /// {@end-tool} + /// {@example /example/lib/segmented_control/cupertino_sliding_segmented_control.0.dart} + /// + // TODO(dkwingsmt): End of the blue example container. final bool isMomentary; @override diff --git a/packages/cupertino_ui/lib/src/switch.dart b/packages/cupertino_ui/lib/src/switch.dart index fbf3f0a68c4b..9636701c902d 100644 --- a/packages/cupertino_ui/lib/src/switch.dart +++ b/packages/cupertino_ui/lib/src/switch.dart @@ -77,14 +77,21 @@ const CupertinoDynamicColor _kOffLabelColor = CupertinoDynamicColor.withBrightne /// callback and rebuild the switch with a new [value] to update the visual /// appearance of the switch. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows a toggleable [CupertinoSwitch]. When the thumb slides to /// the other side of the track, the switch is toggled between on/off. /// -/// ** See code in examples/api/lib/cupertino/switch/cupertino_switch.0.dart ** -/// {@end-tool} +/// {@example /example/lib/switch/cupertino_switch.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 /// -/// {@tool snippet} /// /// This sample shows how to use a [CupertinoSwitch] in a [CupertinoListTile]. The /// [MergeSemantics] is used to turn the entire [CupertinoListTile] into a single item @@ -102,7 +109,8 @@ const CupertinoDynamicColor _kOffLabelColor = CupertinoDynamicColor.withBrightne /// ), /// ) /// ``` -/// {@end-tool} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -297,7 +305,11 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// This example resolves the [trackOutlineColor] based on the current /// [WidgetState] of the [CupertinoSwitch], providing a different [Color] when it is /// [WidgetState.disabled]. @@ -314,7 +326,8 @@ class CupertinoSwitch extends StatefulWidget { /// }), /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. /// /// The [CupertinoSwitch] track has no outline by default. final WidgetStateProperty? trackOutlineColor; @@ -327,7 +340,11 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// This example resolves the [trackOutlineWidth] based on the current /// [WidgetState] of the [CupertinoSwitch], providing a different outline width when it is /// [WidgetState.disabled]. @@ -344,7 +361,8 @@ class CupertinoSwitch extends StatefulWidget { /// }), /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. /// /// Since a [CupertinoSwitch] has no track outline by default, this parameter /// is set only if [trackOutlineColor] is provided. @@ -360,7 +378,11 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// This example resolves the [thumbIcon] based on the current /// [WidgetState] of the [CupertinoSwitch], providing a different [Icon] when it is /// [WidgetState.disabled]. @@ -377,7 +399,8 @@ class CupertinoSwitch extends StatefulWidget { /// }), /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): End of the blue example container. /// /// If null, then the [CupertinoSwitch] does not have any icons on the thumb. final WidgetStateProperty? thumbIcon; @@ -391,7 +414,11 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - /// {@tool snippet} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// This example resolves the [mouseCursor] based on the current /// [WidgetState] of the [CupertinoSwitch], providing a different [mouseCursor] when it is /// [WidgetState.disabled]. @@ -408,7 +435,8 @@ class CupertinoSwitch extends StatefulWidget { /// }), /// ) /// ``` - /// {@end-tool} + /// + // TODO(dkwingsmt): 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/tab_scaffold.dart b/packages/cupertino_ui/lib/src/tab_scaffold.dart index 51e1d5aca869..1745723c815a 100644 --- a/packages/cupertino_ui/lib/src/tab_scaffold.dart +++ b/packages/cupertino_ui/lib/src/tab_scaffold.dart @@ -22,12 +22,15 @@ import 'theme.dart'; /// [CupertinoTabController] controls, as well as the currently selected tab item of /// its [CupertinoTabBar]. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This samples shows how [CupertinoTabController] can be used to switch tabs in /// [CupertinoTabScaffold]. /// -/// ** See code in examples/api/lib/cupertino/tab_scaffold/cupertino_tab_controller.0.dart ** -/// {@end-tool} +/// {@example /example/lib/tab_scaffold/cupertino_tab_controller.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// See also: /// @@ -105,11 +108,14 @@ class CupertinoTabController extends ChangeNotifier { /// (via [State.setState], for instance) from its descendant rather than from /// its ancestor. /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// A sample code implementing a typical iOS information architecture with tabs. /// -/// ** See code in examples/api/lib/cupertino/tab_scaffold/cupertino_tab_scaffold.0.dart ** -/// {@end-tool} +/// {@example /example/lib/tab_scaffold/cupertino_tab_scaffold.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// To push a route above all tabs instead of inside the currently selected one /// (such as when showing a dialog on top of this scaffold), use diff --git a/packages/cupertino_ui/lib/src/text_field.dart b/packages/cupertino_ui/lib/src/text_field.dart index 8156cea8f1ed..3746c097594c 100644 --- a/packages/cupertino_ui/lib/src/text_field.dart +++ b/packages/cupertino_ui/lib/src/text_field.dart @@ -147,12 +147,15 @@ class _CupertinoTextFieldSelectionGestureDetectorBuilder /// /// {@macro flutter.widgets.EditableText.onChanged} /// -/// {@tool dartpad} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows how to set the initial value of the [CupertinoTextField] using /// a [controller] that already contains some text. /// -/// ** See code in examples/api/lib/cupertino/text_field/cupertino_text_field.0.dart ** -/// {@end-tool} +/// {@example /example/lib/text_field/cupertino_text_field.0.dart} +/// +// TODO(dkwingsmt): End of the blue example container. /// /// The [controller] can also control the selection and composing region (and to /// observe changes to the text, selection, and composing region). @@ -834,11 +837,16 @@ class CupertinoTextField extends StatefulWidget { /// /// {@macro flutter.widgets.magnifier.intro} /// - /// {@tool dartpad} + // TODO(dkwingsmt): Replace the following block with a blue example container + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // TODO(dkwingsmt): Add unit tests to this code snippet. + // https://github.com/flutter/flutter/issues/188530 + /// /// This sample demonstrates how to customize the magnifier that this text field uses. /// /// ** See code in examples/api/lib/widgets/text_magnifier/text_magnifier.0.dart ** - /// {@end-tool} + /// + // TODO(dkwingsmt): 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 51517091cf40..94f0553ba576 100644 --- a/packages/cupertino_ui/lib/src/text_form_field_row.dart +++ b/packages/cupertino_ui/lib/src/text_form_field_row.dart @@ -48,7 +48,11 @@ import 'text_field.dart'; /// [CupertinoTextField] class and [CupertinoTextField.borderless], /// the constructor. /// -/// {@tool snippet} +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// TODO(dkwingsmt): Add unit tests to this code snippet. +// https://github.com/flutter/flutter/issues/188530 +/// /// /// Creates a [CupertinoTextFormFieldRow] with a leading text and validator /// function. @@ -71,14 +75,18 @@ import 'text_field.dart'; /// }, /// ) /// ``` -/// {@end-tool} /// -/// {@tool dartpad} +// TODO(dkwingsmt): End of the blue example container. +/// +// TODO(dkwingsmt): Replace the following block with a blue example container +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +/// /// This example shows how to move the focus to the next field when the user /// presses the SPACE key. /// -/// ** See code in examples/api/lib/cupertino/text_form_field_row/cupertino_text_form_field_row.1.dart ** -/// {@end-tool} +/// {@example /example/lib/text_form_field_row/cupertino_text_form_field_row.1.dart} +/// +// TODO(dkwingsmt): End of the blue example container. class CupertinoTextFormFieldRow extends FormField { /// Creates a [CupertinoFormRow] containing a [FormField] that wraps /// a [CupertinoTextField]. From 7e5c974a0e55ba7deb504bcde22563bf6368d601 Mon Sep 17 00:00:00 2001 From: Kate Lovett Date: Mon, 29 Jun 2026 18:17:46 -0500 Subject: [PATCH 2/7] Update analysis comment --- packages/cupertino_ui/example/analysis_options.yaml | 2 -- 1 file changed, 2 deletions(-) diff --git a/packages/cupertino_ui/example/analysis_options.yaml b/packages/cupertino_ui/example/analysis_options.yaml index 561497259820..16500c69a9ca 100644 --- a/packages/cupertino_ui/example/analysis_options.yaml +++ b/packages/cupertino_ui/example/analysis_options.yaml @@ -1,5 +1,3 @@ -# This file is also used by dev/bots/analyze_snippet_code.dart to analyze code snippets (`{@tool snippet}` sections). - # The following line activates a set of recommended lints for Flutter apps, # packages, and plugins designed to encourage good coding practices. analyzer: From d615ec573d4bf778a5c4ec515a5ffc8a13a2c29c Mon Sep 17 00:00:00 2001 From: Kate Lovett Date: Tue, 30 Jun 2026 10:35:27 -0500 Subject: [PATCH 3/7] Update cupertino_ui sample code migration TODOs --- .../lib/src/activity_indicator.dart | 8 ++--- packages/cupertino_ui/lib/src/app.dart | 30 ++++++++-------- .../cupertino_ui/lib/src/bottom_tab_bar.dart | 4 +-- packages/cupertino_ui/lib/src/button.dart | 4 +-- packages/cupertino_ui/lib/src/checkbox.dart | 10 +++--- packages/cupertino_ui/lib/src/colors.dart | 18 +++++----- .../cupertino_ui/lib/src/context_menu.dart | 24 ++++++------- .../cupertino_ui/lib/src/date_picker.dart | 20 +++++------ packages/cupertino_ui/lib/src/dialog.dart | 14 ++++---- .../cupertino_ui/lib/src/expansion_tile.dart | 4 +-- packages/cupertino_ui/lib/src/form_row.dart | 4 +-- packages/cupertino_ui/lib/src/icons.dart | 6 ++-- .../cupertino_ui/lib/src/list_section.dart | 8 ++--- packages/cupertino_ui/lib/src/list_tile.dart | 4 +-- packages/cupertino_ui/lib/src/magnifier.dart | 12 +++---- .../cupertino_ui/lib/src/menu_anchor.dart | 16 ++++----- packages/cupertino_ui/lib/src/nav_bar.dart | 24 ++++++------- .../cupertino_ui/lib/src/page_scaffold.dart | 4 +-- packages/cupertino_ui/lib/src/picker.dart | 4 +-- packages/cupertino_ui/lib/src/radio.dart | 8 ++--- packages/cupertino_ui/lib/src/refresh.dart | 4 +-- packages/cupertino_ui/lib/src/route.dart | 8 ++--- packages/cupertino_ui/lib/src/scrollbar.dart | 8 ++--- .../cupertino_ui/lib/src/search_field.dart | 8 ++--- .../lib/src/segmented_control.dart | 4 +-- packages/cupertino_ui/lib/src/sheet.dart | 20 +++++------ packages/cupertino_ui/lib/src/slider.dart | 16 ++++----- .../lib/src/sliding_segmented_control.dart | 14 ++++---- packages/cupertino_ui/lib/src/switch.dart | 34 +++++++++---------- .../cupertino_ui/lib/src/tab_scaffold.dart | 8 ++--- packages/cupertino_ui/lib/src/text_field.dart | 10 +++--- .../lib/src/text_form_field_row.dart | 10 +++--- 32 files changed, 185 insertions(+), 185 deletions(-) diff --git a/packages/cupertino_ui/lib/src/activity_indicator.dart b/packages/cupertino_ui/lib/src/activity_indicator.dart index 9fc2f01d1143..ceb3b5ec4995 100644 --- a/packages/cupertino_ui/lib/src/activity_indicator.dart +++ b/packages/cupertino_ui/lib/src/activity_indicator.dart @@ -21,14 +21,14 @@ const Color _kActiveTickColor = CupertinoDynamicColor.withBrightness( /// /// {@youtube 560 315 https://www.youtube.com/watch?v=AENVH-ZqKDQ} /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how [CupertinoActivityIndicator] can be customized. /// /// {@example /example/lib/activity_indicator/cupertino_activity_indicator.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -204,14 +204,14 @@ class _CupertinoActivityIndicatorPainter extends CustomPainter { /// The [CupertinoLinearActivityIndicator] is a linear progress bar that /// displays a colored bar to indicate the progress of an ongoing task. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how [CupertinoLinearActivityIndicator] can be customized. /// /// {@example /example/lib/activity_indicator/cupertino_linear_activity_indicator.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/app.dart b/packages/cupertino_ui/lib/src/app.dart index 58e21df3c689..a3cb84be1af2 100644 --- a/packages/cupertino_ui/lib/src/app.dart +++ b/packages/cupertino_ui/lib/src/app.dart @@ -67,9 +67,9 @@ import 'theme.dart'; /// * The San Francisco font family is unavailable on Android and can result /// in undefined font behavior. /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example shows how to create a [CupertinoApp] that disables the "debug" @@ -89,11 +89,11 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the blue example container. /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example shows how to create a [CupertinoApp] that uses the [routes] @@ -122,11 +122,11 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the blue example container. /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example shows how to create a [CupertinoApp] that defines a [theme] that @@ -149,7 +149,7 @@ import 'theme.dart'; /// ) /// ``` /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the blue example container. /// /// See also: /// @@ -372,9 +372,9 @@ class CupertinoApp extends StatefulWidget { final bool debugShowCheckedModeBanner; /// {@macro flutter.widgets.widgetsApp.shortcuts} - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example shows how to add a single shortcut for @@ -400,14 +400,14 @@ class CupertinoApp extends StatefulWidget { /// } /// ``` /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the blue example container. /// {@macro flutter.widgets.widgetsApp.shortcuts.seeAlso} final Map? shortcuts; /// {@macro flutter.widgets.widgetsApp.actions} - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example shows how to add a single action handling an @@ -438,7 +438,7 @@ class CupertinoApp extends StatefulWidget { /// } /// ``` /// - // TODO(dkwingsmt): End of the blue example container. + // 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/bottom_tab_bar.dart b/packages/cupertino_ui/lib/src/bottom_tab_bar.dart index 9de51ddf7568..9d3da912db35 100644 --- a/packages/cupertino_ui/lib/src/bottom_tab_bar.dart +++ b/packages/cupertino_ui/lib/src/bottom_tab_bar.dart @@ -46,14 +46,14 @@ const Color _kDefaultTabBarInactiveColor = CupertinoColors.inactiveGray; /// this behavior, wrap each of the `navigationBar`'s components inside a /// [MediaQuery] with the desired [TextScaler]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoTabBar] placed in a [CupertinoTabScaffold]. /// /// {@example /example/lib/bottom_tab_bar/cupertino_tab_bar.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/button.dart b/packages/cupertino_ui/lib/src/button.dart index b39fc5fd5bca..34ddaeb5a5a3 100644 --- a/packages/cupertino_ui/lib/src/button.dart +++ b/packages/cupertino_ui/lib/src/button.dart @@ -58,7 +58,7 @@ enum _CupertinoButtonStyle { /// with the [CupertinoThemeData.primaryColor] (or /// [CupertinoThemeData.primaryContrastingColor] if the button is disabled). /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample shows produces an enabled and disabled [CupertinoButton] and @@ -66,7 +66,7 @@ enum _CupertinoButtonStyle { /// /// {@example /example/lib/button/cupertino_button.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/checkbox.dart b/packages/cupertino_ui/lib/src/checkbox.dart index 0e09232884e8..baf5c5f69514 100644 --- a/packages/cupertino_ui/lib/src/checkbox.dart +++ b/packages/cupertino_ui/lib/src/checkbox.dart @@ -73,14 +73,14 @@ const List _kDisabledDarkGradientOpacities = [0.08, 0.14]; /// [kMinInteractiveDimensionCupertino] pixels to meet accessibility /// guidelines. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a toggleable [CupertinoCheckbox]. /// /// {@example /example/lib/checkbox/cupertino_checkbox.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -205,9 +205,9 @@ class CupertinoCheckbox extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example resolves the [fillColor] based on the current [WidgetState] @@ -227,7 +227,7 @@ class CupertinoCheckbox extends StatefulWidget { /// ) /// ``` /// - // TODO(dkwingsmt): End of the blue example container. + // 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 c6a808309e46..a82cb600b426 100644 --- a/packages/cupertino_ui/lib/src/colors.dart +++ b/packages/cupertino_ui/lib/src/colors.dart @@ -661,9 +661,9 @@ abstract final class CupertinoColors { /// [CupertinoDynamicColor.resolve] against its own [BuildContext], on a best-effort /// basis. /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// By default a [CupertinoButton] has no background color. The following sample @@ -682,7 +682,7 @@ abstract final class CupertinoColors { /// ) /// ``` /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the blue example container. /// /// ### Using a [CupertinoDynamicColor] from a [CupertinoTheme] /// @@ -691,9 +691,9 @@ abstract final class CupertinoColors { /// implicitly resolves all the colors used in the retrieved [CupertinoThemeData], /// before returning it. /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// The following code sample creates a [Container] with the `primaryColor` of the @@ -711,7 +711,7 @@ abstract final class CupertinoColors { /// ) /// ``` /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the blue example container. /// /// ### Manually Resolving a [CupertinoDynamicColor] /// @@ -722,9 +722,9 @@ abstract final class CupertinoColors { /// the colors used in the [Border] have to be resolved manually before being passed /// to [CupertinoNavigationBar]'s constructor. /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// 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(dkwingsmt): End of the blue example container. +// 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 10c04490b518..274aedf225ae 100644 --- a/packages/cupertino_ui/lib/src/context_menu.dart +++ b/packages/cupertino_ui/lib/src/context_menu.dart @@ -96,7 +96,7 @@ enum _ContextMenuLocation { center, left, right } /// background or by calling `Navigator.pop(context)`. Unlike [PopupRoute], it can /// also be closed by swiping downwards. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample shows a very simple [CupertinoContextMenu] for the Flutter logo. @@ -104,9 +104,9 @@ enum _ContextMenuLocation { center, left, right } /// /// {@example /example/lib/context_menu/cupertino_context_menu.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample shows a similar CupertinoContextMenu, this time using [builder] @@ -114,7 +114,7 @@ enum _ContextMenuLocation { center, left, right } /// /// {@example /example/lib/context_menu/cupertino_context_menu.1.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -148,9 +148,9 @@ 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(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// @@ -216,7 +216,7 @@ class CupertinoContextMenu extends StatefulWidget { /// ``` /// /// - // TODO(dkwingsmt): End of the blue example container. + // 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,9 +259,9 @@ 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(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// @@ -330,9 +330,9 @@ class CupertinoContextMenu extends StatefulWidget { /// ``` /// /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the blue example container. /// - // TODO(dkwingsmt): Replace the following block with a blue example container + // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// Additionally below is an example of a real world use case for [builder]. @@ -347,7 +347,7 @@ class CupertinoContextMenu extends StatefulWidget { /// /// {@example /example/lib/context_menu/cupertino_context_menu.1.dart} /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the @dartpad directive. final CupertinoContextMenuBuilder builder; // TODO(mitchgoodwin): deprecate [child] with builder refactor https://github.com/flutter/flutter/issues/116306 diff --git a/packages/cupertino_ui/lib/src/date_picker.dart b/packages/cupertino_ui/lib/src/date_picker.dart index a962e7f84f20..da5c584a7b75 100644 --- a/packages/cupertino_ui/lib/src/date_picker.dart +++ b/packages/cupertino_ui/lib/src/date_picker.dart @@ -230,7 +230,7 @@ enum _PickerColumnType { /// full screen width. Content texts are shown with /// [CupertinoTextThemeData.dateTimePickerTextStyle]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample shows how to implement CupertinoDatePicker with different picker modes. @@ -241,7 +241,7 @@ enum _PickerColumnType { /// /// {@example /example/lib/date_picker/cupertino_date_picker.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -483,9 +483,9 @@ class CupertinoDatePicker extends StatefulWidget { /// /// If the selection overlay builder returns null, no overlay will be drawn. /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // 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(dkwingsmt): End of the blue example container. + // TODO(framework): End of the blue example container. final SelectionOverlayBuilder? selectionOverlayBuilder; /// The behavior of reporting the selected date. @@ -2173,14 +2173,14 @@ enum CupertinoTimerPickerMode { /// provides more space than it needs, the picker will position itself according /// to its [alignment] property. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoTimerPicker] that returns a countdown duration. /// /// {@example /example/lib/date_picker/cupertino_timer_picker.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -2267,9 +2267,9 @@ class CupertinoTimerPicker extends StatefulWidget { /// /// If the selection overlay builder returns null, no overlay will be drawn. /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // 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(dkwingsmt): End of the blue example container. + // 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/dialog.dart b/packages/cupertino_ui/lib/src/dialog.dart index 4fc964ac0a99..2cf27c7a9395 100644 --- a/packages/cupertino_ui/lib/src/dialog.dart +++ b/packages/cupertino_ui/lib/src/dialog.dart @@ -213,7 +213,7 @@ bool _isInAccessibilityMode(BuildContext context) { /// Typically passed as the child widget to [showDialog], which displays the /// dialog. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample shows how to use a [CupertinoAlertDialog]. @@ -222,7 +222,7 @@ bool _isInAccessibilityMode(BuildContext context) { /// /// {@example /example/lib/dialog/cupertino_alert_dialog.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -520,7 +520,7 @@ class _CupertinoAlertDialogState extends State { /// which is useful for more complicated layouts, such as rendering divider gaps /// in [CupertinoAlertDialog] or rendering custom surface colors. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample shows how to use a [CupertinoPopupSurface]. The [CupertinoPopupSurface] @@ -529,7 +529,7 @@ class _CupertinoAlertDialogState extends State { /// /// {@example /example/lib/dialog/cupertino_popup_surface.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -888,7 +888,7 @@ abstract class _SlideTarget { // Recognizes sliding taps and thereupon interacts with // `_SlideTarget`s. // -// TODO(dkwingsmt): It should recompute hit testing when the app is updated, +// TODO(framework): It should recompute hit testing when the app is updated, // or better, share code with `MouseTracker`. // https://github.com/flutter/flutter/issues/155266 class _TargetSelectionGestureRecognizer extends GestureRecognizer { @@ -1058,7 +1058,7 @@ class _ActionSheetGestureDetector extends StatelessWidget { /// [showCupertinoModalPopup], which displays the action sheet by sliding it up /// from the bottom of the screen. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample shows how to use a [CupertinoActionSheet]. @@ -1067,7 +1067,7 @@ class _ActionSheetGestureDetector extends StatelessWidget { /// /// {@example /example/lib/dialog/cupertino_action_sheet.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/expansion_tile.dart b/packages/cupertino_ui/lib/src/expansion_tile.dart index cf6d255c3363..1f70694f8da5 100644 --- a/packages/cupertino_ui/lib/src/expansion_tile.dart +++ b/packages/cupertino_ui/lib/src/expansion_tile.dart @@ -59,14 +59,14 @@ enum ExpansionTileTransitionMode { /// A single-line [CupertinoListTile] with an expansion arrow icon that expands /// or collapses the tile to reveal or hide the [child]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to use [CupertinoExpansionTile] with different transition modes. /// /// {@example /example/lib/expansion_tile/cupertino_expansion_tile.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/form_row.dart b/packages/cupertino_ui/lib/src/form_row.dart index ea37cec1fdb0..e06d8c6bdd45 100644 --- a/packages/cupertino_ui/lib/src/form_row.dart +++ b/packages/cupertino_ui/lib/src/form_row.dart @@ -36,7 +36,7 @@ const EdgeInsetsGeometry _kDefaultPadding = EdgeInsetsDirectional.fromSTEB(20.0, /// be shown in [CupertinoColors.destructiveRed] coloring and /// medium-weighted font. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// Creates a [CupertinoFormSection] containing a [CupertinoFormRow] with [prefix], @@ -44,7 +44,7 @@ const EdgeInsetsGeometry _kDefaultPadding = EdgeInsetsDirectional.fromSTEB(20.0, /// /// {@example /example/lib/form_row/cupertino_form_row.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// class CupertinoFormRow extends StatelessWidget { /// Creates an iOS-style split form row with a standard prefix and child widget. diff --git a/packages/cupertino_ui/lib/src/icons.dart b/packages/cupertino_ui/lib/src/icons.dart index dd7ec7cbf393..4a973f70f80d 100644 --- a/packages/cupertino_ui/lib/src/icons.dart +++ b/packages/cupertino_ui/lib/src/icons.dart @@ -21,9 +21,9 @@ import 'package:flutter/widgets.dart'; /// cupertino_icons: ^1.0.0 /// ``` /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// 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(dkwingsmt): End of the blue example container. +// 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/list_section.dart b/packages/cupertino_ui/lib/src/list_section.dart index 00a988a763cc..4758ce37c60e 100644 --- a/packages/cupertino_ui/lib/src/list_section.dart +++ b/packages/cupertino_ui/lib/src/list_section.dart @@ -161,7 +161,7 @@ enum CupertinoListSectionType { /// /// {@macro flutter.material.Material.clipBehavior} /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// Creates a base [CupertinoListSection] containing [CupertinoListTile]s with @@ -169,9 +169,9 @@ enum CupertinoListSectionType { /// /// {@example /example/lib/list_section/list_section_base.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// Creates an "Inset Grouped" [CupertinoListSection] containing @@ -180,7 +180,7 @@ enum CupertinoListSectionType { /// /// {@example /example/lib/list_section/list_section_inset.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/list_tile.dart b/packages/cupertino_ui/lib/src/list_tile.dart index 92fa156ad9eb..a2cb229cbc26 100644 --- a/packages/cupertino_ui/lib/src/list_tile.dart +++ b/packages/cupertino_ui/lib/src/list_tile.dart @@ -78,7 +78,7 @@ enum _CupertinoListTileType { base, notched } /// behavior it should not be used for example to toggle the [CupertinoSwitch] /// in the trailing widget. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example uses a [ListView] to demonstrate different configurations of @@ -86,7 +86,7 @@ enum _CupertinoListTileType { base, notched } /// /// {@example /example/lib/list_tile/cupertino_list_tile.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/magnifier.dart b/packages/cupertino_ui/lib/src/magnifier.dart index a679e6fd02f0..74046cfcc4d1 100644 --- a/packages/cupertino_ui/lib/src/magnifier.dart +++ b/packages/cupertino_ui/lib/src/magnifier.dart @@ -14,16 +14,16 @@ 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(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This sample demonstrates how to use [CupertinoTextMagnifier]. /// /// ** See code in examples/api/lib/widgets/magnifier/cupertino_text_magnifier.0.dart ** /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the blue example container. /// /// Delegates styling to [CupertinoMagnifier] with its position depending on /// [magnifierInfo]. @@ -226,16 +226,16 @@ 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(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This sample demonstrates how to use [CupertinoMagnifier]. /// /// ** See code in examples/api/lib/widgets/magnifier/cupertino_magnifier.0.dart ** /// -// TODO(dkwingsmt): End of the blue example container. +// 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 da908d954108..0318f3ba74dd 100644 --- a/packages/cupertino_ui/lib/src/menu_anchor.dart +++ b/packages/cupertino_ui/lib/src/menu_anchor.dart @@ -295,7 +295,7 @@ typedef CupertinoMenuAnimationStatusChangedCallback = void Function(AnimationSta /// invoked every time the [AnimationStatus] of the menu animation changes. /// /// ## Usage -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example demonstrates a simple [CupertinoMenuAnchor] that wraps @@ -303,9 +303,9 @@ typedef CupertinoMenuAnimationStatusChangedCallback = void Function(AnimationSta /// /// {@example /example/lib/menu_anchor/menu_anchor.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example demonstrates a [CupertinoMenuAnchor] that wraps a button and @@ -313,7 +313,7 @@ typedef CupertinoMenuAnimationStatusChangedCallback = void Function(AnimationSta /// /// {@example /example/lib/menu_anchor/menu_anchor.1.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -1701,7 +1701,7 @@ class _CupertinoDividerPainter extends CustomPainter { /// will perform a destructive action, and will color the text of the menu item /// [CupertinoColors.systemRed]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example demonstrates a simple [CupertinoMenuAnchor] that wraps @@ -1709,9 +1709,9 @@ class _CupertinoDividerPainter extends CustomPainter { /// /// {@example /example/lib/menu_anchor/menu_anchor.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example demonstrates a [CupertinoMenuAnchor] that wraps a button and @@ -1719,7 +1719,7 @@ class _CupertinoDividerPainter extends CustomPainter { /// /// {@example /example/lib/menu_anchor/menu_anchor.1.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// * [CupertinoMenuAnchor], a Cupertino-style widget that shows a menu of diff --git a/packages/cupertino_ui/lib/src/nav_bar.dart b/packages/cupertino_ui/lib/src/nav_bar.dart index 0b30a9dfc11e..33638c071ae9 100644 --- a/packages/cupertino_ui/lib/src/nav_bar.dart +++ b/packages/cupertino_ui/lib/src/nav_bar.dart @@ -330,7 +330,7 @@ bool _isTransitionable(BuildContext context) { /// this behavior, wrap each of the `navigationBar`'s components inside a /// [MediaQuery] with the desired [TextScaler]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoNavigationBar] placed in a [CupertinoPageScaffold]. @@ -339,9 +339,9 @@ bool _isTransitionable(BuildContext context) { /// /// {@example /example/lib/nav_bar/cupertino_navigation_bar.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows the resulting layout from [CupertinoNavigationBar.large] @@ -350,7 +350,7 @@ bool _isTransitionable(BuildContext context) { /// /// {@example /example/lib/nav_bar/cupertino_navigation_bar.2.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -626,7 +626,7 @@ class CupertinoNavigationBar extends StatefulWidget implements ObstructingPrefer /// Only widgets that implement [PreferredSizeWidget] can be used at the /// bottom of a navigation bar. /// - // TODO(dkwingsmt): Replace the following block with a blue example container + // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoSearchTextField] at the bottom of a @@ -634,7 +634,7 @@ class CupertinoNavigationBar extends StatefulWidget implements ObstructingPrefer /// /// {@example /example/lib/nav_bar/cupertino_navigation_bar.1.dart} /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -935,23 +935,23 @@ class _CupertinoNavigationBarState extends State { /// user scrolls, but it will also stretch when the user over-scrolls if the /// [stretch] value is `true`. Defaults to `false`. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows [CupertinoSliverNavigationBar] in action inside a [CustomScrollView]. /// /// {@example /example/lib/nav_bar/cupertino_sliver_nav_bar.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// To add a widget to the bottom of the nav bar, wrap it with [PreferredSize] and provide its fully extended size. /// /// {@example /example/lib/nav_bar/cupertino_sliver_nav_bar.2.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -1015,7 +1015,7 @@ class CupertinoSliverNavigationBar extends StatefulWidget { /// If [automaticallyImplyTitle] is false, then the [largeTitle] argument is /// required. /// - // TODO(dkwingsmt): Replace the following block with a blue example container + // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example demonstrates how to use a @@ -1023,7 +1023,7 @@ class CupertinoSliverNavigationBar extends StatefulWidget { /// /// {@example /example/lib/nav_bar/cupertino_sliver_nav_bar.1.dart} /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the @dartpad directive. const CupertinoSliverNavigationBar.search({ super.key, required Widget this.searchField, diff --git a/packages/cupertino_ui/lib/src/page_scaffold.dart b/packages/cupertino_ui/lib/src/page_scaffold.dart index 776f6bc51cc3..4751dc2de2d6 100644 --- a/packages/cupertino_ui/lib/src/page_scaffold.dart +++ b/packages/cupertino_ui/lib/src/page_scaffold.dart @@ -25,7 +25,7 @@ import 'theme.dart'; /// encloses the [ScrollView]. The [ScrollView.primary] flag is used to connect /// a [ScrollView] to the enclosing [PrimaryScrollController]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoPageScaffold] with a [Center] as a [child]. @@ -34,7 +34,7 @@ import 'theme.dart'; /// /// {@example /example/lib/page_scaffold/cupertino_page_scaffold.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/picker.dart b/packages/cupertino_ui/lib/src/picker.dart index aa89867abbe4..079f1faf6dd3 100644 --- a/packages/cupertino_ui/lib/src/picker.dart +++ b/packages/cupertino_ui/lib/src/picker.dart @@ -50,7 +50,7 @@ const Curve _kCupertinoPickerTapToScrollCurve = Curves.easeInOut; /// /// By default, descendent texts are shown with [CupertinoTextThemeData.pickerTextStyle]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoPicker] that displays a list of fruits on a wheel for @@ -58,7 +58,7 @@ const Curve _kCupertinoPickerTapToScrollCurve = Curves.easeInOut; /// /// {@example /example/lib/picker/cupertino_picker.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/radio.dart b/packages/cupertino_ui/lib/src/radio.dart index 909d4ff59379..95b29bb8eee6 100644 --- a/packages/cupertino_ui/lib/src/radio.dart +++ b/packages/cupertino_ui/lib/src/radio.dart @@ -70,7 +70,7 @@ const List _kDisabledDarkGradientOpacities = [0.08, 0.14]; /// [RadioGroup.groupValue], and the [CupertinoRadio] under it with matching /// [value] will be selected. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// Here is an example of CupertinoRadio widgets wrapped in CupertinoListTiles. @@ -87,7 +87,7 @@ const List _kDisabledDarkGradientOpacities = [0.08, 0.14]; /// /// {@example /example/lib/radio/cupertino_radio.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -177,7 +177,7 @@ class CupertinoRadio extends StatefulWidget { /// {@macro flutter.widget.RawRadio.toggleable} /// - // TODO(dkwingsmt): Replace the following block with a blue example container + // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to enable deselecting a radio button by setting the @@ -185,7 +185,7 @@ class CupertinoRadio extends StatefulWidget { /// /// {@example /example/lib/radio/cupertino_radio.toggleable.0.dart} /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the @dartpad directive. final bool toggleable; /// Controls whether the radio displays in a checkbox style or the default iOS diff --git a/packages/cupertino_ui/lib/src/refresh.dart b/packages/cupertino_ui/lib/src/refresh.dart index edf017881143..fbf03b31531e 100644 --- a/packages/cupertino_ui/lib/src/refresh.dart +++ b/packages/cupertino_ui/lib/src/refresh.dart @@ -266,7 +266,7 @@ typedef RefreshCallback = Future Function(); /// sliver such as [CupertinoSliverNavigationBar] and your main scrollable /// content's sliver. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// When the user scrolls past [refreshTriggerPullDistance], @@ -275,7 +275,7 @@ typedef RefreshCallback = Future Function(); /// /// {@example /example/lib/refresh/cupertino_sliver_refresh_control.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/route.dart b/packages/cupertino_ui/lib/src/route.dart index fb4393be5274..435fb0f39884 100644 --- a/packages/cupertino_ui/lib/src/route.dart +++ b/packages/cupertino_ui/lib/src/route.dart @@ -1294,7 +1294,7 @@ class CupertinoModalPopupRoute extends PopupRoute { /// /// For more information about state restoration, see [RestorationManager]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample demonstrates how to create a restorable Cupertino modal route. @@ -1306,7 +1306,7 @@ class CupertinoModalPopupRoute extends PopupRoute { /// /// {@example /example/lib/route/show_cupertino_modal_popup.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -1390,7 +1390,7 @@ Widget _buildCupertinoDialogTransitions( /// /// For more information about state restoration, see [RestorationManager]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample demonstrates how to create a restorable Cupertino dialog. This is @@ -1402,7 +1402,7 @@ Widget _buildCupertinoDialogTransitions( /// /// {@example /example/lib/route/show_cupertino_dialog.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/scrollbar.dart b/packages/cupertino_ui/lib/src/scrollbar.dart index deb8a0c9b327..c9998b84e210 100644 --- a/packages/cupertino_ui/lib/src/scrollbar.dart +++ b/packages/cupertino_ui/lib/src/scrollbar.dart @@ -43,7 +43,7 @@ const double _kScrollbarCrossAxisMargin = 3.0; /// animate from [thickness] and [radius] to [thicknessWhileDragging] and /// [radiusWhileDragging], respectively. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This sample shows a [CupertinoScrollbar] that fades in and out of view as scrolling occurs. @@ -54,9 +54,9 @@ const double _kScrollbarCrossAxisMargin = 3.0; /// /// {@example /example/lib/scrollbar/cupertino_scrollbar.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// When [thumbVisibility] is true, the scrollbar thumb will remain visible without the @@ -65,7 +65,7 @@ const double _kScrollbarCrossAxisMargin = 3.0; /// /// {@example /example/lib/scrollbar/cupertino_scrollbar.1.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/search_field.dart b/packages/cupertino_ui/lib/src/search_field.dart index 0c43c6ad8259..c369a1a283e8 100644 --- a/packages/cupertino_ui/lib/src/search_field.dart +++ b/packages/cupertino_ui/lib/src/search_field.dart @@ -38,7 +38,7 @@ const double _kMaxPrefixIconSize = 30.0; /// [controller]. For example, to set the initial value of the text field, use /// a [controller] that already contains some text such as: /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This examples shows how to provide initial text to a [CupertinoSearchTextField] @@ -46,13 +46,13 @@ const double _kMaxPrefixIconSize = 30.0; /// /// {@example /example/lib/search_field/cupertino_search_field.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// It is recommended to pass a [ValueChanged] to both [onChanged] and /// [onSubmitted] parameters in order to be notified once the value of the /// field changes or is submitted by the keyboard: /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This examples shows how to be notified of field changes or submitted text from @@ -60,7 +60,7 @@ const double _kMaxPrefixIconSize = 30.0; /// /// {@example /example/lib/search_field/cupertino_search_field.1.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/segmented_control.dart b/packages/cupertino_ui/lib/src/segmented_control.dart index a56d4be4a15d..ef8f296eb7a6 100644 --- a/packages/cupertino_ui/lib/src/segmented_control.dart +++ b/packages/cupertino_ui/lib/src/segmented_control.dart @@ -70,7 +70,7 @@ const Duration _kFadeDuration = Duration(milliseconds: 165); /// [disabledChildren]. If the child is not present in the [Set], it is enabled /// by default. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoSegmentedControl] with an enum type. @@ -84,7 +84,7 @@ const Duration _kFadeDuration = Duration(milliseconds: 165); /// /// {@example /example/lib/segmented_control/cupertino_segmented_control.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// diff --git a/packages/cupertino_ui/lib/src/sheet.dart b/packages/cupertino_ui/lib/src/sheet.dart index 5f70814690e9..08faed43188e 100644 --- a/packages/cupertino_ui/lib/src/sheet.dart +++ b/packages/cupertino_ui/lib/src/sheet.dart @@ -158,7 +158,7 @@ typedef _GetSheetDragged = bool Function(); /// Returns a [Future] that resolves to the value (if any) that was passed to /// [Navigator.pop] when the sheet was closed. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to navigate to use [showCupertinoSheet] to display a @@ -166,7 +166,7 @@ typedef _GetSheetDragged = bool Function(); /// /// {@example /example/lib/sheet/cupertino_sheet.1.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -611,7 +611,7 @@ class _StretchDragControllerProvider extends InheritedWidget { /// scrollable area within the sheet, this parameter can be ignored. See below /// for an example. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to navigate to [CupertinoSheetRoute] by using it the @@ -619,9 +619,9 @@ class _StretchDragControllerProvider extends InheritedWidget { /// /// {@example /example/lib/sheet/cupertino_sheet.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to show a Cupertino Sheet with nested navigation manually @@ -629,16 +629,16 @@ class _StretchDragControllerProvider extends InheritedWidget { /// /// {@example /example/lib/sheet/cupertino_sheet.2.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to show a Cupertino Sheet with scrollable content. /// /// {@example /example/lib/sheet/cupertino_sheet.3.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// * [showCupertinoSheet], which is a convenience method for pushing a @@ -679,14 +679,14 @@ class CupertinoSheetRoute extends PageRoute with _CupertinoSheetRouteTrans /// then when a downward drag is applied to the scrollable area while the content /// is scrolled to the top, the drag to dismiss behavior of the sheet will be triggered. /// - // TODO(dkwingsmt): Replace the following block with a blue example container + // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to show a Cupertino Sheet with scrollable content. /// /// {@example /example/lib/sheet/cupertino_sheet.3.dart} /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the @dartpad directive. final ScrollableWidgetBuilder? scrollableBuilder; ScrollableWidgetBuilder get _effectiveBuilder { diff --git a/packages/cupertino_ui/lib/src/slider.dart b/packages/cupertino_ui/lib/src/slider.dart index 7a895f315a19..baac88fb2e7d 100644 --- a/packages/cupertino_ui/lib/src/slider.dart +++ b/packages/cupertino_ui/lib/src/slider.dart @@ -52,14 +52,14 @@ const double _kVelocityThreshold = 1.0; /// that use a slider will listen for the [onChanged] callback and rebuild the /// slider with a new [value] to update the visual appearance of the slider. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to show the current slider value as it changes. /// /// {@example /example/lib/slider/cupertino_slider.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -140,9 +140,9 @@ class CupertinoSlider extends StatefulWidget { /// The value passed will be the last [value] that the slider had before the /// change began. /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // 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(dkwingsmt): End of the blue example container. + // TODO(framework): End of the blue example container. /// /// See also: /// @@ -177,9 +177,9 @@ 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(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // 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(dkwingsmt): End of the blue example container. + // 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 43df5a476766..2b1b81b1324e 100644 --- a/packages/cupertino_ui/lib/src/sliding_segmented_control.dart +++ b/packages/cupertino_ui/lib/src/sliding_segmented_control.dart @@ -340,7 +340,7 @@ class _SegmentSeparatorState extends State<_SegmentSeparator> /// [thumbColor], [backgroundColor] arguments can be used to override the /// segmented control's colors from its defaults. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoSlidingSegmentedControl] with an enum type. @@ -351,7 +351,7 @@ class _SegmentSeparatorState extends State<_SegmentSeparator> /// /// {@example /example/lib/segmented_control/cupertino_sliding_segmented_control.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// See also: /// /// * @@ -427,9 +427,9 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// the parent [StatefulWidget] using the [State.setState] method, so that /// the parent gets rebuilt; for example: /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // 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(dkwingsmt): End of the blue example container. + // 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. @@ -508,7 +508,7 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// /// Defaults to false. /// - // TODO(dkwingsmt): Replace the following block with a blue example container + // TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a [CupertinoSlidingSegmentedControl] with [isMomentary] set @@ -517,7 +517,7 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// /// {@example /example/lib/segmented_control/cupertino_sliding_segmented_control.0.dart} /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the @dartpad directive. final bool isMomentary; @override diff --git a/packages/cupertino_ui/lib/src/switch.dart b/packages/cupertino_ui/lib/src/switch.dart index 9636701c902d..5ac83d31d9f7 100644 --- a/packages/cupertino_ui/lib/src/switch.dart +++ b/packages/cupertino_ui/lib/src/switch.dart @@ -77,7 +77,7 @@ const CupertinoDynamicColor _kOffLabelColor = CupertinoDynamicColor.withBrightne /// callback and rebuild the switch with a new [value] to update the visual /// appearance of the switch. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows a toggleable [CupertinoSwitch]. When the thumb slides to @@ -85,11 +85,11 @@ const CupertinoDynamicColor _kOffLabelColor = CupertinoDynamicColor.withBrightne /// /// {@example /example/lib/switch/cupertino_switch.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// 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(dkwingsmt): End of the blue example container. +// TODO(framework): End of the blue example container. /// /// See also: /// @@ -305,9 +305,9 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example resolves the [trackOutlineColor] based on the current @@ -327,7 +327,7 @@ class CupertinoSwitch extends StatefulWidget { /// ) /// ``` /// - // TODO(dkwingsmt): End of the blue example container. + // TODO(framework): End of the blue example container. /// /// The [CupertinoSwitch] track has no outline by default. final WidgetStateProperty? trackOutlineColor; @@ -340,9 +340,9 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example resolves the [trackOutlineWidth] based on the current @@ -362,7 +362,7 @@ class CupertinoSwitch extends StatefulWidget { /// ) /// ``` /// - // TODO(dkwingsmt): End of the blue example container. + // 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,9 +378,9 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example resolves the [thumbIcon] based on the current @@ -400,7 +400,7 @@ class CupertinoSwitch extends StatefulWidget { /// ) /// ``` /// - // TODO(dkwingsmt): End of the blue example container. + // 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,9 +414,9 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.focused]. /// * [WidgetState.disabled]. /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This example resolves the [mouseCursor] based on the current @@ -436,7 +436,7 @@ class CupertinoSwitch extends StatefulWidget { /// ) /// ``` /// - // TODO(dkwingsmt): End of the blue example container. + // 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/tab_scaffold.dart b/packages/cupertino_ui/lib/src/tab_scaffold.dart index 1745723c815a..74daf1545131 100644 --- a/packages/cupertino_ui/lib/src/tab_scaffold.dart +++ b/packages/cupertino_ui/lib/src/tab_scaffold.dart @@ -22,7 +22,7 @@ import 'theme.dart'; /// [CupertinoTabController] controls, as well as the currently selected tab item of /// its [CupertinoTabBar]. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This samples shows how [CupertinoTabController] can be used to switch tabs in @@ -30,7 +30,7 @@ import 'theme.dart'; /// /// {@example /example/lib/tab_scaffold/cupertino_tab_controller.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// See also: /// @@ -108,14 +108,14 @@ class CupertinoTabController extends ChangeNotifier { /// (via [State.setState], for instance) from its descendant rather than from /// its ancestor. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// A sample code implementing a typical iOS information architecture with tabs. /// /// {@example /example/lib/tab_scaffold/cupertino_tab_scaffold.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// To push a route above all tabs instead of inside the currently selected one /// (such as when showing a dialog on top of this scaffold), use diff --git a/packages/cupertino_ui/lib/src/text_field.dart b/packages/cupertino_ui/lib/src/text_field.dart index 3746c097594c..e4b50e32de5b 100644 --- a/packages/cupertino_ui/lib/src/text_field.dart +++ b/packages/cupertino_ui/lib/src/text_field.dart @@ -147,7 +147,7 @@ class _CupertinoTextFieldSelectionGestureDetectorBuilder /// /// {@macro flutter.widgets.EditableText.onChanged} /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to set the initial value of the [CupertinoTextField] using @@ -155,7 +155,7 @@ class _CupertinoTextFieldSelectionGestureDetectorBuilder /// /// {@example /example/lib/text_field/cupertino_text_field.0.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. /// /// The [controller] can also control the selection and composing region (and to /// observe changes to the text, selection, and composing region). @@ -837,16 +837,16 @@ class CupertinoTextField extends StatefulWidget { /// /// {@macro flutter.widgets.magnifier.intro} /// - // TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. + // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// This sample demonstrates how to customize the magnifier that this text field uses. /// /// ** See code in examples/api/lib/widgets/text_magnifier/text_magnifier.0.dart ** /// - // TODO(dkwingsmt): End of the blue example container. + // 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 94f0553ba576..082863a46b36 100644 --- a/packages/cupertino_ui/lib/src/text_form_field_row.dart +++ b/packages/cupertino_ui/lib/src/text_form_field_row.dart @@ -48,9 +48,9 @@ import 'text_field.dart'; /// [CupertinoTextField] class and [CupertinoTextField.borderless], /// the constructor. /// -// TODO(dkwingsmt): Replace the following block with a 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(dkwingsmt): Add unit tests to this code snippet. +// TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// /// @@ -76,9 +76,9 @@ import 'text_field.dart'; /// ) /// ``` /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the blue example container. /// -// TODO(dkwingsmt): Replace the following block with a blue example container +// TODO(framework): Replace the following block with a @dartpad directive // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 /// /// This example shows how to move the focus to the next field when the user @@ -86,7 +86,7 @@ import 'text_field.dart'; /// /// {@example /example/lib/text_form_field_row/cupertino_text_form_field_row.1.dart} /// -// TODO(dkwingsmt): End of the blue example container. +// TODO(framework): End of the @dartpad directive. class CupertinoTextFormFieldRow extends FormField { /// Creates a [CupertinoFormRow] containing a [FormField] that wraps /// a [CupertinoTextField]. From 762ce227c6d50cb781cc0b0bf53e9fbe138e6154 Mon Sep 17 00:00:00 2001 From: Kate Lovett Date: Wed, 1 Jul 2026 11:47:49 -0500 Subject: [PATCH 4/7] Update dart-lang issue links --- .../cupertino_ui/lib/src/activity_indicator.dart | 4 ++-- packages/cupertino_ui/lib/src/app.dart | 10 +++++----- packages/cupertino_ui/lib/src/bottom_tab_bar.dart | 2 +- packages/cupertino_ui/lib/src/button.dart | 2 +- packages/cupertino_ui/lib/src/checkbox.dart | 4 ++-- packages/cupertino_ui/lib/src/colors.dart | 6 +++--- packages/cupertino_ui/lib/src/context_menu.dart | 10 +++++----- packages/cupertino_ui/lib/src/date_picker.dart | 8 ++++---- packages/cupertino_ui/lib/src/dialog.dart | 6 +++--- packages/cupertino_ui/lib/src/expansion_tile.dart | 2 +- packages/cupertino_ui/lib/src/form_row.dart | 2 +- packages/cupertino_ui/lib/src/icons.dart | 2 +- packages/cupertino_ui/lib/src/list_section.dart | 4 ++-- packages/cupertino_ui/lib/src/list_tile.dart | 2 +- packages/cupertino_ui/lib/src/magnifier.dart | 4 ++-- packages/cupertino_ui/lib/src/menu_anchor.dart | 8 ++++---- packages/cupertino_ui/lib/src/nav_bar.dart | 12 ++++++------ packages/cupertino_ui/lib/src/page_scaffold.dart | 2 +- packages/cupertino_ui/lib/src/picker.dart | 2 +- packages/cupertino_ui/lib/src/radio.dart | 4 ++-- packages/cupertino_ui/lib/src/refresh.dart | 2 +- packages/cupertino_ui/lib/src/route.dart | 4 ++-- packages/cupertino_ui/lib/src/scrollbar.dart | 4 ++-- packages/cupertino_ui/lib/src/search_field.dart | 4 ++-- packages/cupertino_ui/lib/src/segmented_control.dart | 2 +- packages/cupertino_ui/lib/src/sheet.dart | 10 +++++----- packages/cupertino_ui/lib/src/slider.dart | 6 +++--- .../lib/src/sliding_segmented_control.dart | 6 +++--- packages/cupertino_ui/lib/src/switch.dart | 12 ++++++------ packages/cupertino_ui/lib/src/tab_scaffold.dart | 4 ++-- packages/cupertino_ui/lib/src/text_field.dart | 4 ++-- .../cupertino_ui/lib/src/text_form_field_row.dart | 4 ++-- 32 files changed, 79 insertions(+), 79 deletions(-) diff --git a/packages/cupertino_ui/lib/src/activity_indicator.dart b/packages/cupertino_ui/lib/src/activity_indicator.dart index ceb3b5ec4995..e4e2ff138070 100644 --- a/packages/cupertino_ui/lib/src/activity_indicator.dart +++ b/packages/cupertino_ui/lib/src/activity_indicator.dart @@ -22,7 +22,7 @@ const Color _kActiveTickColor = CupertinoDynamicColor.withBrightness( /// {@youtube 560 315 https://www.youtube.com/watch?v=AENVH-ZqKDQ} /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how [CupertinoActivityIndicator] can be customized. /// @@ -205,7 +205,7 @@ class _CupertinoActivityIndicatorPainter extends CustomPainter { /// displays a colored bar to indicate the progress of an ongoing task. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how [CupertinoLinearActivityIndicator] can be customized. /// diff --git a/packages/cupertino_ui/lib/src/app.dart b/packages/cupertino_ui/lib/src/app.dart index a3cb84be1af2..21a1a2bac788 100644 --- a/packages/cupertino_ui/lib/src/app.dart +++ b/packages/cupertino_ui/lib/src/app.dart @@ -68,7 +68,7 @@ import 'theme.dart'; /// 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -92,7 +92,7 @@ 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -125,7 +125,7 @@ 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -373,7 +373,7 @@ class CupertinoApp extends StatefulWidget { /// {@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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -406,7 +406,7 @@ class CupertinoApp extends StatefulWidget { /// {@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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// diff --git a/packages/cupertino_ui/lib/src/bottom_tab_bar.dart b/packages/cupertino_ui/lib/src/bottom_tab_bar.dart index 9d3da912db35..aef0f1ac0516 100644 --- a/packages/cupertino_ui/lib/src/bottom_tab_bar.dart +++ b/packages/cupertino_ui/lib/src/bottom_tab_bar.dart @@ -47,7 +47,7 @@ const Color _kDefaultTabBarInactiveColor = CupertinoColors.inactiveGray; /// [MediaQuery] with the desired [TextScaler]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoTabBar] placed in a [CupertinoTabScaffold]. /// diff --git a/packages/cupertino_ui/lib/src/button.dart b/packages/cupertino_ui/lib/src/button.dart index 34ddaeb5a5a3..8b4d02a5c5fe 100644 --- a/packages/cupertino_ui/lib/src/button.dart +++ b/packages/cupertino_ui/lib/src/button.dart @@ -59,7 +59,7 @@ enum _CupertinoButtonStyle { /// [CupertinoThemeData.primaryContrastingColor] if the button is disabled). /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample shows produces an enabled and disabled [CupertinoButton] and /// [CupertinoButton.filled]. diff --git a/packages/cupertino_ui/lib/src/checkbox.dart b/packages/cupertino_ui/lib/src/checkbox.dart index baf5c5f69514..ade43c067cd0 100644 --- a/packages/cupertino_ui/lib/src/checkbox.dart +++ b/packages/cupertino_ui/lib/src/checkbox.dart @@ -74,7 +74,7 @@ const List _kDisabledDarkGradientOpacities = [0.08, 0.14]; /// guidelines. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a toggleable [CupertinoCheckbox]. /// @@ -206,7 +206,7 @@ class CupertinoCheckbox extends StatefulWidget { /// * [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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// diff --git a/packages/cupertino_ui/lib/src/colors.dart b/packages/cupertino_ui/lib/src/colors.dart index a82cb600b426..bfdc16c3cad2 100644 --- a/packages/cupertino_ui/lib/src/colors.dart +++ b/packages/cupertino_ui/lib/src/colors.dart @@ -662,7 +662,7 @@ abstract final class CupertinoColors { /// basis. /// // TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -692,7 +692,7 @@ abstract final class CupertinoColors { /// 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -723,7 +723,7 @@ abstract final class CupertinoColors { /// 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// diff --git a/packages/cupertino_ui/lib/src/context_menu.dart b/packages/cupertino_ui/lib/src/context_menu.dart index 274aedf225ae..86d809ab3afa 100644 --- a/packages/cupertino_ui/lib/src/context_menu.dart +++ b/packages/cupertino_ui/lib/src/context_menu.dart @@ -97,7 +97,7 @@ enum _ContextMenuLocation { center, left, right } /// also be closed by swiping downwards. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample shows a very simple [CupertinoContextMenu] for the Flutter logo. /// Long press on it to open. @@ -107,7 +107,7 @@ enum _ContextMenuLocation { center, left, right } // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample shows a similar CupertinoContextMenu, this time using [builder] /// to add a border radius to the widget. @@ -149,7 +149,7 @@ class CupertinoContextMenu extends StatefulWidget { /// 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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -260,7 +260,7 @@ class CupertinoContextMenu extends StatefulWidget { /// 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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -333,7 +333,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/4243 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// Additionally below is an example of a real world use case for [builder]. /// diff --git a/packages/cupertino_ui/lib/src/date_picker.dart b/packages/cupertino_ui/lib/src/date_picker.dart index da5c584a7b75..ff97016cc16c 100644 --- a/packages/cupertino_ui/lib/src/date_picker.dart +++ b/packages/cupertino_ui/lib/src/date_picker.dart @@ -231,7 +231,7 @@ enum _PickerColumnType { /// [CupertinoTextThemeData.dateTimePickerTextStyle]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample shows how to implement CupertinoDatePicker with different picker modes. /// We can provide initial dateTime value for the picker to display. When user changes @@ -484,7 +484,7 @@ 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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -2174,7 +2174,7 @@ enum CupertinoTimerPickerMode { /// to its [alignment] property. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoTimerPicker] that returns a countdown duration. /// @@ -2268,7 +2268,7 @@ 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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// diff --git a/packages/cupertino_ui/lib/src/dialog.dart b/packages/cupertino_ui/lib/src/dialog.dart index 2cf27c7a9395..27f79c4d7c9d 100644 --- a/packages/cupertino_ui/lib/src/dialog.dart +++ b/packages/cupertino_ui/lib/src/dialog.dart @@ -214,7 +214,7 @@ bool _isInAccessibilityMode(BuildContext context) { /// dialog. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample shows how to use a [CupertinoAlertDialog]. /// The [CupertinoAlertDialog] shows an alert with a set of two choices @@ -521,7 +521,7 @@ class _CupertinoAlertDialogState extends State { /// in [CupertinoAlertDialog] or rendering custom surface colors. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample shows how to use a [CupertinoPopupSurface]. The [CupertinoPopupSurface] /// shows a modal popup from the bottom of the screen. @@ -1059,7 +1059,7 @@ class _ActionSheetGestureDetector extends StatelessWidget { /// from the bottom of the screen. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample shows how to use a [CupertinoActionSheet]. /// The [CupertinoActionSheet] shows a modal popup that slides in from the diff --git a/packages/cupertino_ui/lib/src/expansion_tile.dart b/packages/cupertino_ui/lib/src/expansion_tile.dart index 1f70694f8da5..162d76621d61 100644 --- a/packages/cupertino_ui/lib/src/expansion_tile.dart +++ b/packages/cupertino_ui/lib/src/expansion_tile.dart @@ -60,7 +60,7 @@ enum ExpansionTileTransitionMode { /// or collapses the tile to reveal or hide the [child]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to use [CupertinoExpansionTile] with different transition modes. /// diff --git a/packages/cupertino_ui/lib/src/form_row.dart b/packages/cupertino_ui/lib/src/form_row.dart index e06d8c6bdd45..33e90d360ca9 100644 --- a/packages/cupertino_ui/lib/src/form_row.dart +++ b/packages/cupertino_ui/lib/src/form_row.dart @@ -37,7 +37,7 @@ const EdgeInsetsGeometry _kDefaultPadding = EdgeInsetsDirectional.fromSTEB(20.0, /// medium-weighted font. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// Creates a [CupertinoFormSection] containing a [CupertinoFormRow] with [prefix], /// [child], [helper] and [error] specified. diff --git a/packages/cupertino_ui/lib/src/icons.dart b/packages/cupertino_ui/lib/src/icons.dart index 4a973f70f80d..9a624aff667c 100644 --- a/packages/cupertino_ui/lib/src/icons.dart +++ b/packages/cupertino_ui/lib/src/icons.dart @@ -22,7 +22,7 @@ import 'package:flutter/widgets.dart'; /// ``` /// // TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// diff --git a/packages/cupertino_ui/lib/src/list_section.dart b/packages/cupertino_ui/lib/src/list_section.dart index 4758ce37c60e..58283edfdf05 100644 --- a/packages/cupertino_ui/lib/src/list_section.dart +++ b/packages/cupertino_ui/lib/src/list_section.dart @@ -162,7 +162,7 @@ enum CupertinoListSectionType { /// {@macro flutter.material.Material.clipBehavior} /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// Creates a base [CupertinoListSection] containing [CupertinoListTile]s with /// `leading`, `title`, `additionalInfo` and `trailing` widgets. @@ -172,7 +172,7 @@ enum CupertinoListSectionType { // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// Creates an "Inset Grouped" [CupertinoListSection] containing /// notched [CupertinoListTile]s with `leading`, `title`, `additionalInfo` and diff --git a/packages/cupertino_ui/lib/src/list_tile.dart b/packages/cupertino_ui/lib/src/list_tile.dart index a2cb229cbc26..060ca933b1a0 100644 --- a/packages/cupertino_ui/lib/src/list_tile.dart +++ b/packages/cupertino_ui/lib/src/list_tile.dart @@ -79,7 +79,7 @@ enum _CupertinoListTileType { base, notched } /// in the trailing widget. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example uses a [ListView] to demonstrate different configurations of /// [CupertinoListTile]s. diff --git a/packages/cupertino_ui/lib/src/magnifier.dart b/packages/cupertino_ui/lib/src/magnifier.dart index 74046cfcc4d1..4f03882d7498 100644 --- a/packages/cupertino_ui/lib/src/magnifier.dart +++ b/packages/cupertino_ui/lib/src/magnifier.dart @@ -15,7 +15,7 @@ import 'theme.dart'; /// 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -227,7 +227,7 @@ class _CupertinoTextMagnifierState extends State /// 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// diff --git a/packages/cupertino_ui/lib/src/menu_anchor.dart b/packages/cupertino_ui/lib/src/menu_anchor.dart index 0318f3ba74dd..99dd55345be3 100644 --- a/packages/cupertino_ui/lib/src/menu_anchor.dart +++ b/packages/cupertino_ui/lib/src/menu_anchor.dart @@ -296,7 +296,7 @@ typedef CupertinoMenuAnimationStatusChangedCallback = void Function(AnimationSta /// /// ## Usage // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example demonstrates a simple [CupertinoMenuAnchor] that wraps /// a button. @@ -306,7 +306,7 @@ typedef CupertinoMenuAnimationStatusChangedCallback = void Function(AnimationSta // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example demonstrates a [CupertinoMenuAnchor] that wraps a button and /// shows a menu with three [CupertinoMenuItem]s and one [CupertinoMenuDivider]. @@ -1702,7 +1702,7 @@ class _CupertinoDividerPainter extends CustomPainter { /// [CupertinoColors.systemRed]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example demonstrates a simple [CupertinoMenuAnchor] that wraps /// a button. @@ -1712,7 +1712,7 @@ class _CupertinoDividerPainter extends CustomPainter { // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example demonstrates a [CupertinoMenuAnchor] that wraps a button and /// shows a menu with three [CupertinoMenuItem]s and one [CupertinoMenuDivider]. diff --git a/packages/cupertino_ui/lib/src/nav_bar.dart b/packages/cupertino_ui/lib/src/nav_bar.dart index 33638c071ae9..85e8acd084f2 100644 --- a/packages/cupertino_ui/lib/src/nav_bar.dart +++ b/packages/cupertino_ui/lib/src/nav_bar.dart @@ -331,7 +331,7 @@ bool _isTransitionable(BuildContext context) { /// [MediaQuery] with the desired [TextScaler]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoNavigationBar] placed in a [CupertinoPageScaffold]. /// Since [backgroundColor]'s opacity is not 1.0, there is a blur effect and @@ -342,7 +342,7 @@ bool _isTransitionable(BuildContext context) { // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows the resulting layout from [CupertinoNavigationBar.large] /// constructor, showing a large title similar to the expanded state of @@ -627,7 +627,7 @@ class CupertinoNavigationBar extends StatefulWidget implements ObstructingPrefer /// bottom of a navigation bar. /// // TODO(framework): Replace the following block with a @dartpad directive - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoSearchTextField] at the bottom of a /// [CupertinoNavigationBar]. @@ -936,7 +936,7 @@ class _CupertinoNavigationBarState extends State { /// [stretch] value is `true`. Defaults to `false`. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows [CupertinoSliverNavigationBar] in action inside a [CustomScrollView]. /// @@ -945,7 +945,7 @@ class _CupertinoNavigationBarState extends State { // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// To add a widget to the bottom of the nav bar, wrap it with [PreferredSize] and provide its fully extended size. /// @@ -1016,7 +1016,7 @@ class CupertinoSliverNavigationBar extends StatefulWidget { /// required. /// // TODO(framework): Replace the following block with a @dartpad directive - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example demonstrates how to use a /// [CupertinoSliverNavigationBar.search] to manage a search view. diff --git a/packages/cupertino_ui/lib/src/page_scaffold.dart b/packages/cupertino_ui/lib/src/page_scaffold.dart index 4751dc2de2d6..0c844fb5dbd4 100644 --- a/packages/cupertino_ui/lib/src/page_scaffold.dart +++ b/packages/cupertino_ui/lib/src/page_scaffold.dart @@ -26,7 +26,7 @@ import 'theme.dart'; /// a [ScrollView] to the enclosing [PrimaryScrollController]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoPageScaffold] with a [Center] as a [child]. /// The [CupertinoButton] is connected to a callback that increments a counter. diff --git a/packages/cupertino_ui/lib/src/picker.dart b/packages/cupertino_ui/lib/src/picker.dart index 079f1faf6dd3..2baccf0f3e38 100644 --- a/packages/cupertino_ui/lib/src/picker.dart +++ b/packages/cupertino_ui/lib/src/picker.dart @@ -51,7 +51,7 @@ const Curve _kCupertinoPickerTapToScrollCurve = Curves.easeInOut; /// By default, descendent texts are shown with [CupertinoTextThemeData.pickerTextStyle]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoPicker] that displays a list of fruits on a wheel for /// selection. diff --git a/packages/cupertino_ui/lib/src/radio.dart b/packages/cupertino_ui/lib/src/radio.dart index 95b29bb8eee6..fc4cc59b9685 100644 --- a/packages/cupertino_ui/lib/src/radio.dart +++ b/packages/cupertino_ui/lib/src/radio.dart @@ -71,7 +71,7 @@ const List _kDisabledDarkGradientOpacities = [0.08, 0.14]; /// [value] will be selected. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// Here is an example of CupertinoRadio widgets wrapped in CupertinoListTiles. /// @@ -178,7 +178,7 @@ class CupertinoRadio extends StatefulWidget { /// {@macro flutter.widget.RawRadio.toggleable} /// // TODO(framework): Replace the following block with a @dartpad directive - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to enable deselecting a radio button by setting the /// [toggleable] attribute. diff --git a/packages/cupertino_ui/lib/src/refresh.dart b/packages/cupertino_ui/lib/src/refresh.dart index fbf03b31531e..e046f0687211 100644 --- a/packages/cupertino_ui/lib/src/refresh.dart +++ b/packages/cupertino_ui/lib/src/refresh.dart @@ -267,7 +267,7 @@ typedef RefreshCallback = Future Function(); /// content's sliver. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// When the user scrolls past [refreshTriggerPullDistance], /// this sample shows the default iOS pull to refresh indicator for 1 second and diff --git a/packages/cupertino_ui/lib/src/route.dart b/packages/cupertino_ui/lib/src/route.dart index 435fb0f39884..0baf10285d03 100644 --- a/packages/cupertino_ui/lib/src/route.dart +++ b/packages/cupertino_ui/lib/src/route.dart @@ -1295,7 +1295,7 @@ class CupertinoModalPopupRoute extends PopupRoute { /// For more information about state restoration, see [RestorationManager]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample demonstrates how to create a restorable Cupertino modal route. /// This is accomplished by enabling state restoration by specifying @@ -1391,7 +1391,7 @@ Widget _buildCupertinoDialogTransitions( /// For more information about state restoration, see [RestorationManager]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample demonstrates how to create a restorable Cupertino dialog. This is /// accomplished by enabling state restoration by specifying diff --git a/packages/cupertino_ui/lib/src/scrollbar.dart b/packages/cupertino_ui/lib/src/scrollbar.dart index c9998b84e210..4f08927be983 100644 --- a/packages/cupertino_ui/lib/src/scrollbar.dart +++ b/packages/cupertino_ui/lib/src/scrollbar.dart @@ -44,7 +44,7 @@ const double _kScrollbarCrossAxisMargin = 3.0; /// [radiusWhileDragging], respectively. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This sample shows a [CupertinoScrollbar] that fades in and out of view as scrolling occurs. /// The scrollbar will fade into view as the user scrolls, and fade out when scrolling stops. @@ -57,7 +57,7 @@ const double _kScrollbarCrossAxisMargin = 3.0; // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// When [thumbVisibility] is true, the scrollbar thumb will remain visible without the /// fade animation. This requires that a [ScrollController] is provided to controller, diff --git a/packages/cupertino_ui/lib/src/search_field.dart b/packages/cupertino_ui/lib/src/search_field.dart index c369a1a283e8..7216749f4c6d 100644 --- a/packages/cupertino_ui/lib/src/search_field.dart +++ b/packages/cupertino_ui/lib/src/search_field.dart @@ -39,7 +39,7 @@ const double _kMaxPrefixIconSize = 30.0; /// a [controller] that already contains some text such as: /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This examples shows how to provide initial text to a [CupertinoSearchTextField] /// using the [controller] property. @@ -53,7 +53,7 @@ const double _kMaxPrefixIconSize = 30.0; /// field changes or is submitted by the keyboard: /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This examples shows how to be notified of field changes or submitted text from /// a [CupertinoSearchTextField]. diff --git a/packages/cupertino_ui/lib/src/segmented_control.dart b/packages/cupertino_ui/lib/src/segmented_control.dart index ef8f296eb7a6..d527f930f2b7 100644 --- a/packages/cupertino_ui/lib/src/segmented_control.dart +++ b/packages/cupertino_ui/lib/src/segmented_control.dart @@ -71,7 +71,7 @@ const Duration _kFadeDuration = Duration(milliseconds: 165); /// by default. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoSegmentedControl] with an enum type. /// diff --git a/packages/cupertino_ui/lib/src/sheet.dart b/packages/cupertino_ui/lib/src/sheet.dart index 08faed43188e..9f2bedb650d5 100644 --- a/packages/cupertino_ui/lib/src/sheet.dart +++ b/packages/cupertino_ui/lib/src/sheet.dart @@ -159,7 +159,7 @@ typedef _GetSheetDragged = bool Function(); /// [Navigator.pop] when the sheet was closed. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to navigate to use [showCupertinoSheet] to display a /// Cupertino sheet widget with nested navigation. @@ -612,7 +612,7 @@ class _StretchDragControllerProvider extends InheritedWidget { /// for an example. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to navigate to [CupertinoSheetRoute] by using it the /// same as a regular route. @@ -622,7 +622,7 @@ class _StretchDragControllerProvider extends InheritedWidget { // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to show a Cupertino Sheet with nested navigation manually /// set up in order to enable restorable state. @@ -632,7 +632,7 @@ class _StretchDragControllerProvider extends InheritedWidget { // TODO(framework): End of the @dartpad directive. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to show a Cupertino Sheet with scrollable content. /// @@ -680,7 +680,7 @@ class CupertinoSheetRoute extends PageRoute with _CupertinoSheetRouteTrans /// is scrolled to the top, the drag to dismiss behavior of the sheet will be triggered. /// // TODO(framework): Replace the following block with a @dartpad directive - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to show a Cupertino Sheet with scrollable content. /// diff --git a/packages/cupertino_ui/lib/src/slider.dart b/packages/cupertino_ui/lib/src/slider.dart index baac88fb2e7d..32be1fb1c2d0 100644 --- a/packages/cupertino_ui/lib/src/slider.dart +++ b/packages/cupertino_ui/lib/src/slider.dart @@ -53,7 +53,7 @@ const double _kVelocityThreshold = 1.0; /// slider with a new [value] to update the visual appearance of the slider. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to show the current slider value as it changes. /// @@ -141,7 +141,7 @@ class CupertinoSlider extends StatefulWidget { /// 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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -178,7 +178,7 @@ class CupertinoSlider extends StatefulWidget { /// 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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// diff --git a/packages/cupertino_ui/lib/src/sliding_segmented_control.dart b/packages/cupertino_ui/lib/src/sliding_segmented_control.dart index 2b1b81b1324e..d9c0349e0a8e 100644 --- a/packages/cupertino_ui/lib/src/sliding_segmented_control.dart +++ b/packages/cupertino_ui/lib/src/sliding_segmented_control.dart @@ -341,7 +341,7 @@ class _SegmentSeparatorState extends State<_SegmentSeparator> /// segmented control's colors from its defaults. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoSlidingSegmentedControl] with an enum type. /// @@ -428,7 +428,7 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// 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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -509,7 +509,7 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// Defaults to false. /// // TODO(framework): Replace the following block with a @dartpad directive - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a [CupertinoSlidingSegmentedControl] with [isMomentary] set /// to true, providing feedback to the user when the segment is selected with a diff --git a/packages/cupertino_ui/lib/src/switch.dart b/packages/cupertino_ui/lib/src/switch.dart index 5ac83d31d9f7..f648b1e5949e 100644 --- a/packages/cupertino_ui/lib/src/switch.dart +++ b/packages/cupertino_ui/lib/src/switch.dart @@ -78,7 +78,7 @@ const CupertinoDynamicColor _kOffLabelColor = CupertinoDynamicColor.withBrightne /// appearance of the switch. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows a toggleable [CupertinoSwitch]. When the thumb slides to /// the other side of the track, the switch is toggled between on/off. @@ -88,7 +88,7 @@ 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -306,7 +306,7 @@ class CupertinoSwitch extends StatefulWidget { /// * [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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -341,7 +341,7 @@ class CupertinoSwitch extends StatefulWidget { /// * [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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -379,7 +379,7 @@ class CupertinoSwitch extends StatefulWidget { /// * [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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -415,7 +415,7 @@ class CupertinoSwitch extends StatefulWidget { /// * [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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// diff --git a/packages/cupertino_ui/lib/src/tab_scaffold.dart b/packages/cupertino_ui/lib/src/tab_scaffold.dart index 74daf1545131..55ca8e30cc30 100644 --- a/packages/cupertino_ui/lib/src/tab_scaffold.dart +++ b/packages/cupertino_ui/lib/src/tab_scaffold.dart @@ -23,7 +23,7 @@ import 'theme.dart'; /// its [CupertinoTabBar]. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This samples shows how [CupertinoTabController] can be used to switch tabs in /// [CupertinoTabScaffold]. @@ -109,7 +109,7 @@ class CupertinoTabController extends ChangeNotifier { /// its ancestor. /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// A sample code implementing a typical iOS information architecture with tabs. /// diff --git a/packages/cupertino_ui/lib/src/text_field.dart b/packages/cupertino_ui/lib/src/text_field.dart index e4b50e32de5b..627a139b7353 100644 --- a/packages/cupertino_ui/lib/src/text_field.dart +++ b/packages/cupertino_ui/lib/src/text_field.dart @@ -148,7 +148,7 @@ class _CupertinoTextFieldSelectionGestureDetectorBuilder /// {@macro flutter.widgets.EditableText.onChanged} /// // TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to set the initial value of the [CupertinoTextField] using /// a [controller] that already contains some text. @@ -838,7 +838,7 @@ 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 + // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// 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 082863a46b36..a669720d7f28 100644 --- a/packages/cupertino_ui/lib/src/text_form_field_row.dart +++ b/packages/cupertino_ui/lib/src/text_form_field_row.dart @@ -49,7 +49,7 @@ import 'text_field.dart'; /// 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 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 // TODO(framework): Add unit tests to this code snippet. // https://github.com/flutter/flutter/issues/188530 /// @@ -79,7 +79,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/4243 +// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 /// /// This example shows how to move the focus to the next field when the user /// presses the SPACE key. From 402446e7e584a40885987972e36af510624bc1da Mon Sep 17 00:00:00 2001 From: Kate Lovett Date: Wed, 1 Jul 2026 17:01:33 -0500 Subject: [PATCH 5/7] Update missing sample directives --- analysis_options.yaml | 2 +- packages/cupertino_ui/lib/src/magnifier.dart | 4 ++-- packages/cupertino_ui/lib/src/text_field.dart | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/analysis_options.yaml b/analysis_options.yaml index ddbf5764b899..daadedd6d5fb 100644 --- a/analysis_options.yaml +++ b/analysis_options.yaml @@ -16,7 +16,7 @@ analyzer: # something (https://github.com/flutter/flutter/issues/143312) deprecated_member_use: ignore deprecated_member_use_from_same_package: ignore - # `dart analyze` hasn't recognized this new directive yet. + # `dart analyze` hasn't recognized the @example directive yet. # Remove it once https://github.com/dart-lang/sdk/pull/63646 is landed. doc_directive_unknown: ignore exclude: # DIFFERENT FROM FLUTTER/FLUTTER diff --git a/packages/cupertino_ui/lib/src/magnifier.dart b/packages/cupertino_ui/lib/src/magnifier.dart index 4f03882d7498..8bf80c7e6238 100644 --- a/packages/cupertino_ui/lib/src/magnifier.dart +++ b/packages/cupertino_ui/lib/src/magnifier.dart @@ -21,7 +21,7 @@ import 'theme.dart'; /// /// This sample demonstrates how to use [CupertinoTextMagnifier]. /// -/// ** See code in examples/api/lib/widgets/magnifier/cupertino_text_magnifier.0.dart ** +/// {@example example/lib/magnifier/cupertino_text_magnifier.0.dart} /// // TODO(framework): End of the blue example container. /// @@ -233,7 +233,7 @@ class _CupertinoTextMagnifierState extends State /// /// This sample demonstrates how to use [CupertinoMagnifier]. /// -/// ** See code in examples/api/lib/widgets/magnifier/cupertino_magnifier.0.dart ** +/// {@example example/lib/magnifier/cupertino_magnifier.0.dart} /// // TODO(framework): End of the blue example container. /// diff --git a/packages/cupertino_ui/lib/src/text_field.dart b/packages/cupertino_ui/lib/src/text_field.dart index 627a139b7353..9910a0a596de 100644 --- a/packages/cupertino_ui/lib/src/text_field.dart +++ b/packages/cupertino_ui/lib/src/text_field.dart @@ -844,7 +844,7 @@ class CupertinoTextField extends StatefulWidget { /// /// This sample demonstrates how to customize the magnifier that this text field uses. /// - /// ** See code in examples/api/lib/widgets/text_magnifier/text_magnifier.0.dart ** + /// {@example example/lib/magnifier/text_magnifier.0.dart} /// // TODO(framework): End of the blue example container. final TextMagnifierConfiguration? magnifierConfiguration; From ce9f17ddf4338063b70e1efcfdfbcba817956d21 Mon Sep 17 00:00:00 2001 From: Kate Lovett Date: Wed, 1 Jul 2026 17:06:31 -0500 Subject: [PATCH 6/7] Update prior @sample directives to proper wrappers --- packages/cupertino_ui/lib/src/menu_anchor.dart | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/packages/cupertino_ui/lib/src/menu_anchor.dart b/packages/cupertino_ui/lib/src/menu_anchor.dart index 99dd55345be3..762861815e0c 100644 --- a/packages/cupertino_ui/lib/src/menu_anchor.dart +++ b/packages/cupertino_ui/lib/src/menu_anchor.dart @@ -295,15 +295,15 @@ typedef CupertinoMenuAnimationStatusChangedCallback = void Function(AnimationSta /// invoked every time the [AnimationStatus] of the menu animation changes. /// /// ## Usage -// TODO(framework): Replace the following block with a @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 +// 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 @dartpad directive. +// 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 +1701,15 @@ 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 @dartpad directive -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 +// 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 @dartpad directive. +// 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 From 832b54879b9fdf8d132bbaf2834b1a49e0558f33 Mon Sep 17 00:00:00 2001 From: Kate Lovett Date: Wed, 1 Jul 2026 17:28:01 -0500 Subject: [PATCH 7/7] Correct dart issue links for blue containers --- packages/cupertino_ui/lib/src/app.dart | 10 +++++----- packages/cupertino_ui/lib/src/checkbox.dart | 2 +- packages/cupertino_ui/lib/src/colors.dart | 6 +++--- packages/cupertino_ui/lib/src/context_menu.dart | 4 ++-- packages/cupertino_ui/lib/src/date_picker.dart | 4 ++-- packages/cupertino_ui/lib/src/icons.dart | 2 +- packages/cupertino_ui/lib/src/magnifier.dart | 4 ++-- packages/cupertino_ui/lib/src/slider.dart | 4 ++-- .../lib/src/sliding_segmented_control.dart | 2 +- packages/cupertino_ui/lib/src/switch.dart | 10 +++++----- packages/cupertino_ui/lib/src/text_field.dart | 2 +- packages/cupertino_ui/lib/src/text_form_field_row.dart | 2 +- 12 files changed, 26 insertions(+), 26 deletions(-) diff --git a/packages/cupertino_ui/lib/src/app.dart b/packages/cupertino_ui/lib/src/app.dart index 21a1a2bac788..a3cb84be1af2 100644 --- a/packages/cupertino_ui/lib/src/app.dart +++ b/packages/cupertino_ui/lib/src/app.dart @@ -68,7 +68,7 @@ import 'theme.dart'; /// 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/4123 +// 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 '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/4123 +// 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 /// @@ -125,7 +125,7 @@ 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/4123 +// 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 /// @@ -373,7 +373,7 @@ class CupertinoApp extends StatefulWidget { /// {@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/4123 + // 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 /// @@ -406,7 +406,7 @@ class CupertinoApp extends StatefulWidget { /// {@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/4123 + // 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 /// diff --git a/packages/cupertino_ui/lib/src/checkbox.dart b/packages/cupertino_ui/lib/src/checkbox.dart index ade43c067cd0..c917fdb4aece 100644 --- a/packages/cupertino_ui/lib/src/checkbox.dart +++ b/packages/cupertino_ui/lib/src/checkbox.dart @@ -206,7 +206,7 @@ class CupertinoCheckbox extends StatefulWidget { /// * [WidgetState.disabled]. /// // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 + // 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 /// diff --git a/packages/cupertino_ui/lib/src/colors.dart b/packages/cupertino_ui/lib/src/colors.dart index bfdc16c3cad2..a82cb600b426 100644 --- a/packages/cupertino_ui/lib/src/colors.dart +++ b/packages/cupertino_ui/lib/src/colors.dart @@ -662,7 +662,7 @@ abstract final class CupertinoColors { /// basis. /// // TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 +// 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 /// @@ -692,7 +692,7 @@ abstract final class CupertinoColors { /// 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/4123 +// 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 /// @@ -723,7 +723,7 @@ abstract final class CupertinoColors { /// 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/4123 +// 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 /// diff --git a/packages/cupertino_ui/lib/src/context_menu.dart b/packages/cupertino_ui/lib/src/context_menu.dart index 86d809ab3afa..72e87b3b0212 100644 --- a/packages/cupertino_ui/lib/src/context_menu.dart +++ b/packages/cupertino_ui/lib/src/context_menu.dart @@ -149,7 +149,7 @@ class CupertinoContextMenu extends StatefulWidget { /// 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/4123 + // 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 CupertinoContextMenu extends StatefulWidget { /// 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/4123 + // 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 /// diff --git a/packages/cupertino_ui/lib/src/date_picker.dart b/packages/cupertino_ui/lib/src/date_picker.dart index ff97016cc16c..bac359f2a314 100644 --- a/packages/cupertino_ui/lib/src/date_picker.dart +++ b/packages/cupertino_ui/lib/src/date_picker.dart @@ -484,7 +484,7 @@ 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/4123 + // 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 /// @@ -2268,7 +2268,7 @@ 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/4123 + // 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 /// diff --git a/packages/cupertino_ui/lib/src/icons.dart b/packages/cupertino_ui/lib/src/icons.dart index 9a624aff667c..4a973f70f80d 100644 --- a/packages/cupertino_ui/lib/src/icons.dart +++ b/packages/cupertino_ui/lib/src/icons.dart @@ -22,7 +22,7 @@ import 'package:flutter/widgets.dart'; /// ``` /// // TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 +// 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 /// diff --git a/packages/cupertino_ui/lib/src/magnifier.dart b/packages/cupertino_ui/lib/src/magnifier.dart index 8bf80c7e6238..16fbaf427dc0 100644 --- a/packages/cupertino_ui/lib/src/magnifier.dart +++ b/packages/cupertino_ui/lib/src/magnifier.dart @@ -15,7 +15,7 @@ import 'theme.dart'; /// 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/4123 +// 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 _CupertinoTextMagnifierState extends State /// 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/4123 +// 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 /// diff --git a/packages/cupertino_ui/lib/src/slider.dart b/packages/cupertino_ui/lib/src/slider.dart index 32be1fb1c2d0..33047c757022 100644 --- a/packages/cupertino_ui/lib/src/slider.dart +++ b/packages/cupertino_ui/lib/src/slider.dart @@ -141,7 +141,7 @@ class CupertinoSlider extends StatefulWidget { /// change began. /// // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 + // 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 /// @@ -178,7 +178,7 @@ class CupertinoSlider extends StatefulWidget { /// 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/4123 + // 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 /// diff --git a/packages/cupertino_ui/lib/src/sliding_segmented_control.dart b/packages/cupertino_ui/lib/src/sliding_segmented_control.dart index d9c0349e0a8e..d06ac15a3408 100644 --- a/packages/cupertino_ui/lib/src/sliding_segmented_control.dart +++ b/packages/cupertino_ui/lib/src/sliding_segmented_control.dart @@ -428,7 +428,7 @@ class CupertinoSlidingSegmentedControl extends StatefulWidget /// 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/4123 + // 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 /// diff --git a/packages/cupertino_ui/lib/src/switch.dart b/packages/cupertino_ui/lib/src/switch.dart index f648b1e5949e..4db1901d3222 100644 --- a/packages/cupertino_ui/lib/src/switch.dart +++ b/packages/cupertino_ui/lib/src/switch.dart @@ -88,7 +88,7 @@ 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/4123 +// 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 CupertinoSwitch extends StatefulWidget { /// * [WidgetState.disabled]. /// // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 + // 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 CupertinoSwitch extends StatefulWidget { /// * [WidgetState.disabled]. /// // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 + // 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 /// @@ -379,7 +379,7 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.disabled]. /// // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 + // 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 /// @@ -415,7 +415,7 @@ class CupertinoSwitch extends StatefulWidget { /// * [WidgetState.disabled]. /// // TODO(framework): Replace the following block with a blue example container - // when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 + // 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 /// diff --git a/packages/cupertino_ui/lib/src/text_field.dart b/packages/cupertino_ui/lib/src/text_field.dart index 9910a0a596de..32612565d1f3 100644 --- a/packages/cupertino_ui/lib/src/text_field.dart +++ b/packages/cupertino_ui/lib/src/text_field.dart @@ -838,7 +838,7 @@ 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/4123 + // 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 /// 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 a669720d7f28..9de408b852a2 100644 --- a/packages/cupertino_ui/lib/src/text_form_field_row.dart +++ b/packages/cupertino_ui/lib/src/text_form_field_row.dart @@ -49,7 +49,7 @@ import 'text_field.dart'; /// the constructor. /// // TODO(framework): Replace the following block with a blue example container -// when it's supported. https://github.com/dart-lang/dartdoc/issues/4123 +// 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 ///