diff --git a/examples/api/lib/animation/curves/curve2_d.0.dart b/examples/api/lib/animation/curves/curve2_d.0.dart index 7ac5261ecf..b4f3c1bba4 100644 --- a/examples/api/lib/animation/curves/curve2_d.0.dart +++ b/examples/api/lib/animation/curves/curve2_d.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Curve2D +/// Flutter code sample for [Curve2D]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/cupertino/activity_indicator/cupertino_activity_indicator.0.dart b/examples/api/lib/cupertino/activity_indicator/cupertino_activity_indicator.0.dart index 8445ceaf12..22cfcf2e75 100644 --- a/examples/api/lib/cupertino/activity_indicator/cupertino_activity_indicator.0.dart +++ b/examples/api/lib/cupertino/activity_indicator/cupertino_activity_indicator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoActivityIndicator +/// Flutter code sample for [CupertinoActivityIndicator]. import 'package:flutter/cupertino.dart'; @@ -57,7 +57,8 @@ class CupertinoIndicatorExample extends StatelessWidget { Column( mainAxisAlignment: MainAxisAlignment.center, children: const [ - // Cupertino activity indicator with custom radius and disabled animation. + // Cupertino activity indicator with custom radius and disabled + // animation. CupertinoActivityIndicator(radius: 20.0, animating: false), SizedBox(height: 10), Text( diff --git a/examples/api/lib/cupertino/bottom_tab_bar/cupertino_tab_bar.0.dart b/examples/api/lib/cupertino/bottom_tab_bar/cupertino_tab_bar.0.dart index ad23ad6dd8..0efdca3b5f 100644 --- a/examples/api/lib/cupertino/bottom_tab_bar/cupertino_tab_bar.0.dart +++ b/examples/api/lib/cupertino/bottom_tab_bar/cupertino_tab_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoTabBar +/// Flutter code sample for [CupertinoTabBar]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/button/cupertino_button.0.dart b/examples/api/lib/cupertino/button/cupertino_button.0.dart index 974a66c6d8..02dc8894b3 100644 --- a/examples/api/lib/cupertino/button/cupertino_button.0.dart +++ b/examples/api/lib/cupertino/button/cupertino_button.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoButton +/// Flutter code sample for [CupertinoButton]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/context_menu/cupertino_context_menu.0.dart b/examples/api/lib/cupertino/context_menu/cupertino_context_menu.0.dart index 7240d93c60..53f0f1912d 100644 --- a/examples/api/lib/cupertino/context_menu/cupertino_context_menu.0.dart +++ b/examples/api/lib/cupertino/context_menu/cupertino_context_menu.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoContextMenu +/// Flutter code sample for [CupertinoContextMenu]. import 'package:flutter/cupertino.dart'; import 'package:flutter/material.dart'; diff --git a/examples/api/lib/cupertino/date_picker/cupertino_date_picker.0.dart b/examples/api/lib/cupertino/date_picker/cupertino_date_picker.0.dart index dcef469556..026dbe0c55 100644 --- a/examples/api/lib/cupertino/date_picker/cupertino_date_picker.0.dart +++ b/examples/api/lib/cupertino/date_picker/cupertino_date_picker.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoDatePicker +/// Flutter code sample for [CupertinoDatePicker]. import 'package:flutter/cupertino.dart'; @@ -32,14 +32,16 @@ class _DatePickerExampleState extends State { DateTime time = DateTime(2016, 5, 10, 22, 35); DateTime dateTime = DateTime(2016, 8, 3, 17, 45); - // This shows a CupertinoModalPopup with a reasonable fixed height which hosts CupertinoDatePicker. + // This function displays a CupertinoModalPopup with a reasonable fixed height + // which hosts CupertinoDatePicker. void _showDialog(Widget child) { showCupertinoModalPopup( context: context, builder: (BuildContext context) => Container( height: 216, padding: const EdgeInsets.only(top: 6.0), - // The Bottom margin is provided to align the popup above the system navigation bar. + // The Bottom margin is provided to align the popup above the system + // navigation bar. margin: EdgeInsets.only( bottom: MediaQuery.of(context).viewInsets.bottom, ), @@ -85,8 +87,9 @@ class _DatePickerExampleState extends State { }, ), ), - // In this example, the date value is formatted manually. You can use intl package - // to format the value based on user's locale settings. + // In this example, the date is formatted manually. You can + // use the intl package to format the value based on the + // user's locale settings. child: Text('${date.month}-${date.day}-${date.year}', style: const TextStyle( fontSize: 22.0, @@ -111,8 +114,9 @@ class _DatePickerExampleState extends State { }, ), ), - // In this example, the time value is formatted manually. You can use intl package to - // format the value based on the user's locale settings. + // In this example, the time value is formatted manually. + // You can use the intl package to format the value based on + // the user's locale settings. child: Text('${time.hour}:${time.minute}', style: const TextStyle( fontSize: 22.0, @@ -136,8 +140,9 @@ class _DatePickerExampleState extends State { }, ), ), - // In this example, time value is formatted manually. You can use intl package to - // format the value based on the user's locale settings. + // In this example, the time value is formatted manually. You + // can use the intl package to format the value based on the + // user's locale settings. child: Text('${dateTime.month}-${dateTime.day}-${dateTime.year} ${dateTime.hour}:${dateTime.minute}', style: const TextStyle( fontSize: 22.0, diff --git a/examples/api/lib/cupertino/date_picker/cupertino_timer_picker.0.dart b/examples/api/lib/cupertino/date_picker/cupertino_timer_picker.0.dart index a3191f973c..511fb5f4ea 100644 --- a/examples/api/lib/cupertino/date_picker/cupertino_timer_picker.0.dart +++ b/examples/api/lib/cupertino/date_picker/cupertino_timer_picker.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoTimerPicker +/// Flutter code sample for [CupertinoTimerPicker]. import 'package:flutter/cupertino.dart'; @@ -30,14 +30,16 @@ class TimerPickerExample extends StatefulWidget { class _TimerPickerExampleState extends State { Duration duration = const Duration(hours: 1, minutes: 23); - // This shows a CupertinoModalPopup with a reasonable fixed height which hosts CupertinoTimerPicker. + // This shows a CupertinoModalPopup with a reasonable fixed height which hosts + // a CupertinoTimerPicker. void _showDialog(Widget child) { showCupertinoModalPopup( context: context, builder: (BuildContext context) => Container( height: 216, padding: const EdgeInsets.only(top: 6.0), - // The Bottom margin is provided to align the popup above the system navigation bar. + // The bottom margin is provided to align the popup above the system + // navigation bar. margin: EdgeInsets.only( bottom: MediaQuery.of(context).viewInsets.bottom, ), @@ -76,14 +78,16 @@ class _TimerPickerExampleState extends State { CupertinoTimerPicker( mode: CupertinoTimerPickerMode.hm, initialTimerDuration: duration, - // This is called when the user changes the timer duration. + // This is called when the user changes the timer's + // duration. onTimerDurationChanged: (Duration newDuration) { setState(() => duration = newDuration); }, ), ), - // In this example, the timer value is formatted manually. You can use intl package - // to format the value based on user's locale settings. + // In this example, the timer's value is formatted manually. + // You can use the intl package to format the value based on + // the user's locale settings. child: Text('$duration', style: const TextStyle( fontSize: 22.0, diff --git a/examples/api/lib/cupertino/dialog/cupertino_action_sheet.0.dart b/examples/api/lib/cupertino/dialog/cupertino_action_sheet.0.dart index f9ac845088..7116b991d2 100644 --- a/examples/api/lib/cupertino/dialog/cupertino_action_sheet.0.dart +++ b/examples/api/lib/cupertino/dialog/cupertino_action_sheet.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoActionSheet +/// Flutter code sample for [CupertinoActionSheet]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/dialog/cupertino_alert_dialog.0.dart b/examples/api/lib/cupertino/dialog/cupertino_alert_dialog.0.dart index ffe536f732..246a1f90e7 100644 --- a/examples/api/lib/cupertino/dialog/cupertino_alert_dialog.0.dart +++ b/examples/api/lib/cupertino/dialog/cupertino_alert_dialog.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoAlertDialog +/// Flutter code sample for [CupertinoAlertDialog]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/form_row/cupertino_form_row.0.dart b/examples/api/lib/cupertino/form_row/cupertino_form_row.0.dart index 4c46b6d601..7f4731de34 100644 --- a/examples/api/lib/cupertino/form_row/cupertino_form_row.0.dart +++ b/examples/api/lib/cupertino/form_row/cupertino_form_row.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoFormRow +/// Flutter code sample for [CupertinoFormRow]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/list_section/list_section_base.0.dart b/examples/api/lib/cupertino/list_section/list_section_base.0.dart index 6c0bb8752e..792b38763f 100644 --- a/examples/api/lib/cupertino/list_section/list_section_base.0.dart +++ b/examples/api/lib/cupertino/list_section/list_section_base.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for base CupertinoListSection and CupertinoListTile. +/// Flutter code sample for base [CupertinoListSection] and [CupertinoListTile]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/list_section/list_section_inset.0.dart b/examples/api/lib/cupertino/list_section/list_section_inset.0.dart index c268c6d46e..1120fa5c34 100644 --- a/examples/api/lib/cupertino/list_section/list_section_inset.0.dart +++ b/examples/api/lib/cupertino/list_section/list_section_inset.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for inset CupertinoListSection and CupertinoListTile. +/// Flutter code sample for inset [CupertinoListSection] and [CupertinoListTile]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/nav_bar/cupertino_navigation_bar.0.dart b/examples/api/lib/cupertino/nav_bar/cupertino_navigation_bar.0.dart index 3e53cfb8d0..c185859c82 100644 --- a/examples/api/lib/cupertino/nav_bar/cupertino_navigation_bar.0.dart +++ b/examples/api/lib/cupertino/nav_bar/cupertino_navigation_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoNavigationBar +/// Flutter code sample for [CupertinoNavigationBar]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/nav_bar/cupertino_sliver_nav_bar.0.dart b/examples/api/lib/cupertino/nav_bar/cupertino_sliver_nav_bar.0.dart index a8c6a875f1..9fb484aa60 100644 --- a/examples/api/lib/cupertino/nav_bar/cupertino_sliver_nav_bar.0.dart +++ b/examples/api/lib/cupertino/nav_bar/cupertino_sliver_nav_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoSliverNavigationBar +/// Flutter code sample for [CupertinoSliverNavigationBar]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/page_scaffold/cupertino_page_scaffold.0.dart b/examples/api/lib/cupertino/page_scaffold/cupertino_page_scaffold.0.dart index 9263d70791..2871248b15 100644 --- a/examples/api/lib/cupertino/page_scaffold/cupertino_page_scaffold.0.dart +++ b/examples/api/lib/cupertino/page_scaffold/cupertino_page_scaffold.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoPageScaffold +/// Flutter code sample for [CupertinoPageScaffold]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/picker/cupertino_picker.0.dart b/examples/api/lib/cupertino/picker/cupertino_picker.0.dart index 3520e582fd..c97b707be6 100644 --- a/examples/api/lib/cupertino/picker/cupertino_picker.0.dart +++ b/examples/api/lib/cupertino/picker/cupertino_picker.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoPicker +/// Flutter code sample for [CupertinoPicker]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/refresh/cupertino_sliver_refresh_control.0.dart b/examples/api/lib/cupertino/refresh/cupertino_sliver_refresh_control.0.dart index 17b63dfe58..76a18af232 100644 --- a/examples/api/lib/cupertino/refresh/cupertino_sliver_refresh_control.0.dart +++ b/examples/api/lib/cupertino/refresh/cupertino_sliver_refresh_control.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoSliverRefreshControl +/// Flutter code sample for [CupertinoSliverRefreshControl]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/route/show_cupertino_dialog.0.dart b/examples/api/lib/cupertino/route/show_cupertino_dialog.0.dart index 762acbe484..6acc189e42 100644 --- a/examples/api/lib/cupertino/route/show_cupertino_dialog.0.dart +++ b/examples/api/lib/cupertino/route/show_cupertino_dialog.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showCupertinoDialog +/// Flutter code sample for [showCupertinoDialog]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/route/show_cupertino_modal_popup.0.dart b/examples/api/lib/cupertino/route/show_cupertino_modal_popup.0.dart index 1547487f44..1132c98f1a 100644 --- a/examples/api/lib/cupertino/route/show_cupertino_modal_popup.0.dart +++ b/examples/api/lib/cupertino/route/show_cupertino_modal_popup.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showCupertinoModalPopup +/// Flutter code sample for [showCupertinoModalPopup]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.0.dart b/examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.0.dart index 512497be9a..05721ca18a 100644 --- a/examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.0.dart +++ b/examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoScrollbar +/// Flutter code sample for [CupertinoScrollbar]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.1.dart b/examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.1.dart index b6ec2dc267..58ccfed31e 100644 --- a/examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.1.dart +++ b/examples/api/lib/cupertino/scrollbar/cupertino_scrollbar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoScrollbar +/// Flutter code sample for [CupertinoScrollbar]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/search_field/cupertino_search_field.0.dart b/examples/api/lib/cupertino/search_field/cupertino_search_field.0.dart index b63061a939..d688e3c588 100644 --- a/examples/api/lib/cupertino/search_field/cupertino_search_field.0.dart +++ b/examples/api/lib/cupertino/search_field/cupertino_search_field.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoSearchTextField +/// Flutter code sample for [CupertinoSearchTextField]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/search_field/cupertino_search_field.1.dart b/examples/api/lib/cupertino/search_field/cupertino_search_field.1.dart index 33b8cb427a..eb431eab70 100644 --- a/examples/api/lib/cupertino/search_field/cupertino_search_field.1.dart +++ b/examples/api/lib/cupertino/search_field/cupertino_search_field.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoSearchTextField +/// Flutter code sample for [CupertinoSearchTextField]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/segmented_control/cupertino_segmented_control.0.dart b/examples/api/lib/cupertino/segmented_control/cupertino_segmented_control.0.dart index cb6788c574..8841a1f0d5 100644 --- a/examples/api/lib/cupertino/segmented_control/cupertino_segmented_control.0.dart +++ b/examples/api/lib/cupertino/segmented_control/cupertino_segmented_control.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoSegmentedControl +/// Flutter code sample for [CupertinoSegmentedControl]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/segmented_control/cupertino_sliding_segmented_control.0.dart b/examples/api/lib/cupertino/segmented_control/cupertino_sliding_segmented_control.0.dart index 4405cb4e36..ea363cc1c4 100644 --- a/examples/api/lib/cupertino/segmented_control/cupertino_sliding_segmented_control.0.dart +++ b/examples/api/lib/cupertino/segmented_control/cupertino_sliding_segmented_control.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoSlidingSegmentedControl +/// Flutter code sample for [CupertinoSlidingSegmentedControl]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/slider/cupertino_slider.0.dart b/examples/api/lib/cupertino/slider/cupertino_slider.0.dart index e5eac97f77..fd1dd1f08a 100644 --- a/examples/api/lib/cupertino/slider/cupertino_slider.0.dart +++ b/examples/api/lib/cupertino/slider/cupertino_slider.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoSlider +/// Flutter code sample for [CupertinoSlider]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/switch/cupertino_switch.0.dart b/examples/api/lib/cupertino/switch/cupertino_switch.0.dart index 65bf7cb447..c50b48dff3 100644 --- a/examples/api/lib/cupertino/switch/cupertino_switch.0.dart +++ b/examples/api/lib/cupertino/switch/cupertino_switch.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoSwitch +/// Flutter code sample for [CupertinoSwitch]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/tab_scaffold/cupertino_tab_controller.0.dart b/examples/api/lib/cupertino/tab_scaffold/cupertino_tab_controller.0.dart index 9cb6e91851..e375a50de5 100644 --- a/examples/api/lib/cupertino/tab_scaffold/cupertino_tab_controller.0.dart +++ b/examples/api/lib/cupertino/tab_scaffold/cupertino_tab_controller.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoTabController +/// Flutter code sample for [CupertinoTabController]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/tab_scaffold/cupertino_tab_scaffold.0.dart b/examples/api/lib/cupertino/tab_scaffold/cupertino_tab_scaffold.0.dart index a78024d250..b50e8127ea 100644 --- a/examples/api/lib/cupertino/tab_scaffold/cupertino_tab_scaffold.0.dart +++ b/examples/api/lib/cupertino/tab_scaffold/cupertino_tab_scaffold.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoTabScaffold +/// Flutter code sample for [CupertinoTabScaffold]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/text_field/cupertino_text_field.0.dart b/examples/api/lib/cupertino/text_field/cupertino_text_field.0.dart index 4572cd15c1..dfa6772cf6 100644 --- a/examples/api/lib/cupertino/text_field/cupertino_text_field.0.dart +++ b/examples/api/lib/cupertino/text_field/cupertino_text_field.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoTextField +/// Flutter code sample for [CupertinoTextField]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/cupertino/text_form_field_row/cupertino_text_form_field_row.1.dart b/examples/api/lib/cupertino/text_form_field_row/cupertino_text_form_field_row.1.dart index d0051bd0ec..b363360343 100644 --- a/examples/api/lib/cupertino/text_form_field_row/cupertino_text_form_field_row.1.dart +++ b/examples/api/lib/cupertino/text_form_field_row/cupertino_text_form_field_row.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CupertinoTextFormFieldRow +/// Flutter code sample for [CupertinoTextFormFieldRow]. import 'package:flutter/cupertino.dart'; diff --git a/examples/api/lib/foundation/change_notifier/change_notifier.0.dart b/examples/api/lib/foundation/change_notifier/change_notifier.0.dart index 86bcc21e92..d2cc9f3d03 100644 --- a/examples/api/lib/foundation/change_notifier/change_notifier.0.dart +++ b/examples/api/lib/foundation/change_notifier/change_notifier.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ChangeNotifier with an AnimatedBuilder +/// Flutter code sample for a [ChangeNotifier] with an [AnimatedBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/gestures/pointer_signal_resolver/pointer_signal_resolver.0.dart b/examples/api/lib/gestures/pointer_signal_resolver/pointer_signal_resolver.0.dart index 75287dbff2..a3f4ececff 100644 --- a/examples/api/lib/gestures/pointer_signal_resolver/pointer_signal_resolver.0.dart +++ b/examples/api/lib/gestures/pointer_signal_resolver/pointer_signal_resolver.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PointerSignalResolver +/// Flutter code sample for [PointerSignalResolver]. import 'package:flutter/gestures.dart'; diff --git a/examples/api/lib/material/about/about_list_tile.0.dart b/examples/api/lib/material/about/about_list_tile.0.dart index 15859f2c60..260fd06d40 100644 --- a/examples/api/lib/material/about/about_list_tile.0.dart +++ b/examples/api/lib/material/about/about_list_tile.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AboutListTile +/// Flutter code sample for [AboutListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/action_chip/action_chip.0.dart b/examples/api/lib/material/action_chip/action_chip.0.dart index 9bbc8bc502..f24115a2dd 100644 --- a/examples/api/lib/material/action_chip/action_chip.0.dart +++ b/examples/api/lib/material/action_chip/action_chip.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample ActionChip +/// Flutter code sample [ActionChip]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/app_bar/app_bar.0.dart b/examples/api/lib/material/app_bar/app_bar.0.dart index ce01560389..f39259d7f7 100644 --- a/examples/api/lib/material/app_bar/app_bar.0.dart +++ b/examples/api/lib/material/app_bar/app_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AppBar +/// Flutter code sample for [AppBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/app_bar/app_bar.1.dart b/examples/api/lib/material/app_bar/app_bar.1.dart index 925df09cfb..0b1e5d7428 100644 --- a/examples/api/lib/material/app_bar/app_bar.1.dart +++ b/examples/api/lib/material/app_bar/app_bar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AppBar +/// Flutter code sample for [AppBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/app_bar/app_bar.2.dart b/examples/api/lib/material/app_bar/app_bar.2.dart index 01a7b63be8..fc6d437fcd 100644 --- a/examples/api/lib/material/app_bar/app_bar.2.dart +++ b/examples/api/lib/material/app_bar/app_bar.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AppBar +/// Flutter code sample for [AppBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/app_bar/app_bar.3.dart b/examples/api/lib/material/app_bar/app_bar.3.dart index f312a3d9c5..f58d94d773 100644 --- a/examples/api/lib/material/app_bar/app_bar.3.dart +++ b/examples/api/lib/material/app_bar/app_bar.3.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AppBar +/// Flutter code sample for [AppBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/app_bar/sliver_app_bar.1.dart b/examples/api/lib/material/app_bar/sliver_app_bar.1.dart index 8859c4512e..0ce2273b9c 100644 --- a/examples/api/lib/material/app_bar/sliver_app_bar.1.dart +++ b/examples/api/lib/material/app_bar/sliver_app_bar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverAppBar +/// Flutter code sample for [SliverAppBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/app_bar/sliver_app_bar.2.dart b/examples/api/lib/material/app_bar/sliver_app_bar.2.dart index 77c344da76..4491f8166e 100644 --- a/examples/api/lib/material/app_bar/sliver_app_bar.2.dart +++ b/examples/api/lib/material/app_bar/sliver_app_bar.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverAppBar.medium +/// Flutter code sample for [SliverAppBar.medium]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/app_bar/sliver_app_bar.3.dart b/examples/api/lib/material/app_bar/sliver_app_bar.3.dart index 3c32a47d4e..e30ead81ba 100644 --- a/examples/api/lib/material/app_bar/sliver_app_bar.3.dart +++ b/examples/api/lib/material/app_bar/sliver_app_bar.3.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverAppBar.large +/// Flutter code sample for [SliverAppBar.large]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/autocomplete/autocomplete.0.dart b/examples/api/lib/material/autocomplete/autocomplete.0.dart index 31eca943b6..4a533744de 100644 --- a/examples/api/lib/material/autocomplete/autocomplete.0.dart +++ b/examples/api/lib/material/autocomplete/autocomplete.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Autocomplete +/// Flutter code sample for [Autocomplete]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/autocomplete/autocomplete.1.dart b/examples/api/lib/material/autocomplete/autocomplete.1.dart index 1af404bce2..436301cfe0 100644 --- a/examples/api/lib/material/autocomplete/autocomplete.1.dart +++ b/examples/api/lib/material/autocomplete/autocomplete.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Autocomplete +/// Flutter code sample for [Autocomplete]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/banner/material_banner.0.dart b/examples/api/lib/material/banner/material_banner.0.dart index 3d19206117..f4bbd7d102 100644 --- a/examples/api/lib/material/banner/material_banner.0.dart +++ b/examples/api/lib/material/banner/material_banner.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MaterialBanner +/// Flutter code sample for [MaterialBanner]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/banner/material_banner.1.dart b/examples/api/lib/material/banner/material_banner.1.dart index 6ec7e1c725..0f280e3159 100644 --- a/examples/api/lib/material/banner/material_banner.1.dart +++ b/examples/api/lib/material/banner/material_banner.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MaterialBanner +/// Flutter code sample for [MaterialBanner]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/bottom_app_bar/bottom_app_bar.1.dart b/examples/api/lib/material/bottom_app_bar/bottom_app_bar.1.dart index 169dd340d5..278e3e9662 100644 --- a/examples/api/lib/material/bottom_app_bar/bottom_app_bar.1.dart +++ b/examples/api/lib/material/bottom_app_bar/bottom_app_bar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for BottomAppBar +/// Flutter code sample for [BottomAppBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.0.dart b/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.0.dart index bc8e1ba61c..8d88356429 100644 --- a/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.0.dart +++ b/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for BottomNavigationBar +/// Flutter code sample for [BottomNavigationBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.1.dart b/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.1.dart index df377f80c1..3e0aa4f8e6 100644 --- a/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.1.dart +++ b/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for BottomNavigationBar +/// Flutter code sample for [BottomNavigationBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.2.dart b/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.2.dart index ee5ebed3e5..43c952ea70 100644 --- a/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.2.dart +++ b/examples/api/lib/material/bottom_navigation_bar/bottom_navigation_bar.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for BottomNavigationBar +/// Flutter code sample for [BottomNavigationBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/bottom_sheet/show_modal_bottom_sheet.0.dart b/examples/api/lib/material/bottom_sheet/show_modal_bottom_sheet.0.dart index e8a09fe9e8..a402037ff0 100644 --- a/examples/api/lib/material/bottom_sheet/show_modal_bottom_sheet.0.dart +++ b/examples/api/lib/material/bottom_sheet/show_modal_bottom_sheet.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showModalBottomSheet +/// Flutter code sample for [showModalBottomSheet]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/button_style/button_style.0.dart b/examples/api/lib/material/button_style/button_style.0.dart index c77fdd207c..45f93d3598 100644 --- a/examples/api/lib/material/button_style/button_style.0.dart +++ b/examples/api/lib/material/button_style/button_style.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ElevatedButton +/// Flutter code sample for [ElevatedButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/card/card.0.dart b/examples/api/lib/material/card/card.0.dart index 8d37dcc5b7..d1b72fad5b 100644 --- a/examples/api/lib/material/card/card.0.dart +++ b/examples/api/lib/material/card/card.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Card +/// Flutter code sample for [Card]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/card/card.1.dart b/examples/api/lib/material/card/card.1.dart index ae4761456f..c22069ce13 100644 --- a/examples/api/lib/material/card/card.1.dart +++ b/examples/api/lib/material/card/card.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Card +/// Flutter code sample for [Card]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/card/card.2.dart b/examples/api/lib/material/card/card.2.dart index 85cc61a2fb..9737e6648a 100644 --- a/examples/api/lib/material/card/card.2.dart +++ b/examples/api/lib/material/card/card.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Card +/// Flutter code sample for [Card]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/checkbox/checkbox.0.dart b/examples/api/lib/material/checkbox/checkbox.0.dart index 54f8521dd5..d658e8147d 100644 --- a/examples/api/lib/material/checkbox/checkbox.0.dart +++ b/examples/api/lib/material/checkbox/checkbox.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Checkbox +/// Flutter code sample for [Checkbox]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.0.dart b/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.0.dart index ba23466c9e..33b89664b2 100644 --- a/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.0.dart +++ b/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CheckboxListTile +/// Flutter code sample for [CheckboxListTile]. import 'package:flutter/material.dart'; import 'package:flutter/scheduler.dart' show timeDilation; diff --git a/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.1.dart b/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.1.dart index 64084bd388..c071cf3790 100644 --- a/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.1.dart +++ b/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CheckboxListTile +/// Flutter code sample for [CheckboxListTile]. import 'package:flutter/gestures.dart'; diff --git a/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.2.dart b/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.2.dart index 3b1abdfae9..09d9509654 100644 --- a/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.2.dart +++ b/examples/api/lib/material/checkbox_list_tile/checkbox_list_tile.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CheckboxListTile +/// Flutter code sample for [CheckboxListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/chip/deletable_chip_attributes.on_deleted.0.dart b/examples/api/lib/material/chip/deletable_chip_attributes.on_deleted.0.dart index 44e505e498..f0552ddefa 100644 --- a/examples/api/lib/material/chip/deletable_chip_attributes.on_deleted.0.dart +++ b/examples/api/lib/material/chip/deletable_chip_attributes.on_deleted.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for DeletableChipAttributes.onDeleted +/// Flutter code sample for [DeletableChipAttributes.onDeleted]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/choice_chip/choice_chip.0.dart b/examples/api/lib/material/choice_chip/choice_chip.0.dart index 0a920183f0..72f59b348e 100644 --- a/examples/api/lib/material/choice_chip/choice_chip.0.dart +++ b/examples/api/lib/material/choice_chip/choice_chip.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample ActionChoice +/// Flutter code sample for [ActionChoice]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/data_table/data_table.0.dart b/examples/api/lib/material/data_table/data_table.0.dart index 7b75d17ca4..64ccae015e 100644 --- a/examples/api/lib/material/data_table/data_table.0.dart +++ b/examples/api/lib/material/data_table/data_table.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for DataTable +/// Flutter code sample for [DataTable]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/data_table/data_table.1.dart b/examples/api/lib/material/data_table/data_table.1.dart index 4ec80e6d23..367cb3022b 100644 --- a/examples/api/lib/material/data_table/data_table.1.dart +++ b/examples/api/lib/material/data_table/data_table.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for DataTable +/// Flutter code sample for [DataTable]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/date_picker/show_date_picker.0.dart b/examples/api/lib/material/date_picker/show_date_picker.0.dart index 3d1ec9de5b..17de0260ec 100644 --- a/examples/api/lib/material/date_picker/show_date_picker.0.dart +++ b/examples/api/lib/material/date_picker/show_date_picker.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showDatePicker +/// Flutter code sample for [showDatePicker]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/date_picker/show_date_range_picker.0.dart b/examples/api/lib/material/date_picker/show_date_range_picker.0.dart index f4631be209..ecb7d98a43 100644 --- a/examples/api/lib/material/date_picker/show_date_range_picker.0.dart +++ b/examples/api/lib/material/date_picker/show_date_range_picker.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showDateRangePicker +/// Flutter code sample for [showDateRangePicker]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/dialog/alert_dialog.0.dart b/examples/api/lib/material/dialog/alert_dialog.0.dart index afe737bb34..627e23719c 100644 --- a/examples/api/lib/material/dialog/alert_dialog.0.dart +++ b/examples/api/lib/material/dialog/alert_dialog.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AlertDialog +/// Flutter code sample for [AlertDialog]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/dialog/alert_dialog.1.dart b/examples/api/lib/material/dialog/alert_dialog.1.dart index 3ce7e7e499..22fd0a7e90 100644 --- a/examples/api/lib/material/dialog/alert_dialog.1.dart +++ b/examples/api/lib/material/dialog/alert_dialog.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AlertDialog +/// Flutter code sample for [AlertDialog]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/dialog/show_dialog.0.dart b/examples/api/lib/material/dialog/show_dialog.0.dart index 88ac3a780e..3a6f55375e 100644 --- a/examples/api/lib/material/dialog/show_dialog.0.dart +++ b/examples/api/lib/material/dialog/show_dialog.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showDialog +/// Flutter code sample for [showDialog]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/dialog/show_dialog.1.dart b/examples/api/lib/material/dialog/show_dialog.1.dart index 9e212bb7a5..3a5a856f1e 100644 --- a/examples/api/lib/material/dialog/show_dialog.1.dart +++ b/examples/api/lib/material/dialog/show_dialog.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showDialog +/// Flutter code sample for [showDialog]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/dialog/show_dialog.2.dart b/examples/api/lib/material/dialog/show_dialog.2.dart index 054893485b..d69c624129 100644 --- a/examples/api/lib/material/dialog/show_dialog.2.dart +++ b/examples/api/lib/material/dialog/show_dialog.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showDialog +/// Flutter code sample for [showDialog]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/divider/divider.0.dart b/examples/api/lib/material/divider/divider.0.dart index 604b0d7c24..5912c1f456 100644 --- a/examples/api/lib/material/divider/divider.0.dart +++ b/examples/api/lib/material/divider/divider.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Divider +/// Flutter code sample for [Divider]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/divider/vertical_divider.0.dart b/examples/api/lib/material/divider/vertical_divider.0.dart index 8971c9745b..0a9a5cb71a 100644 --- a/examples/api/lib/material/divider/vertical_divider.0.dart +++ b/examples/api/lib/material/divider/vertical_divider.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for VerticalDivider +/// Flutter code sample for [VerticalDivider]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/dropdown/dropdown_button.0.dart b/examples/api/lib/material/dropdown/dropdown_button.0.dart index a90d5ccf43..fc380befd6 100644 --- a/examples/api/lib/material/dropdown/dropdown_button.0.dart +++ b/examples/api/lib/material/dropdown/dropdown_button.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for DropdownButton +/// Flutter code sample for [DropdownButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/dropdown/dropdown_button.selected_item_builder.0.dart b/examples/api/lib/material/dropdown/dropdown_button.selected_item_builder.0.dart index baf0176591..adbc1fc50b 100644 --- a/examples/api/lib/material/dropdown/dropdown_button.selected_item_builder.0.dart +++ b/examples/api/lib/material/dropdown/dropdown_button.selected_item_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for DropdownButton.selectedItemBuilder +/// Flutter code sample for [DropdownButton.selectedItemBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/dropdown/dropdown_button.style.0.dart b/examples/api/lib/material/dropdown/dropdown_button.style.0.dart index 9dc6557d4b..72c79f9669 100644 --- a/examples/api/lib/material/dropdown/dropdown_button.style.0.dart +++ b/examples/api/lib/material/dropdown/dropdown_button.style.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for DropdownButton.style +/// Flutter code sample for [DropdownButton.style]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/elevated_button/elevated_button.0.dart b/examples/api/lib/material/elevated_button/elevated_button.0.dart index abe601f175..eaa0d4eb4e 100644 --- a/examples/api/lib/material/elevated_button/elevated_button.0.dart +++ b/examples/api/lib/material/elevated_button/elevated_button.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ElevatedButton +/// Flutter code sample for [ElevatedButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/expansion_panel/expansion_panel_list.0.dart b/examples/api/lib/material/expansion_panel/expansion_panel_list.0.dart index 68381376a7..b6e6379815 100644 --- a/examples/api/lib/material/expansion_panel/expansion_panel_list.0.dart +++ b/examples/api/lib/material/expansion_panel/expansion_panel_list.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ExpansionPanelList +/// Flutter code sample for [ExpansionPanelList]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/expansion_panel/expansion_panel_list.expansion_panel_list_radio.0.dart b/examples/api/lib/material/expansion_panel/expansion_panel_list.expansion_panel_list_radio.0.dart index 80e0a67d69..b86c2e8e15 100644 --- a/examples/api/lib/material/expansion_panel/expansion_panel_list.expansion_panel_list_radio.0.dart +++ b/examples/api/lib/material/expansion_panel/expansion_panel_list.expansion_panel_list_radio.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ExpansionPanelList.ExpansionPanelList.radio +/// Flutter code sample for [ExpansionPanelList.ExpansionPanelList.radio]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/expansion_tile/expansion_tile.0.dart b/examples/api/lib/material/expansion_tile/expansion_tile.0.dart index 20dfa47de7..688f772428 100644 --- a/examples/api/lib/material/expansion_tile/expansion_tile.0.dart +++ b/examples/api/lib/material/expansion_tile/expansion_tile.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ExpansionTile +/// Flutter code sample for [ExpansionTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/filled_button/filled_button.0.dart b/examples/api/lib/material/filled_button/filled_button.0.dart index 5c58f79ef4..2f72e0fbfc 100644 --- a/examples/api/lib/material/filled_button/filled_button.0.dart +++ b/examples/api/lib/material/filled_button/filled_button.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FilledButton +/// Flutter code sample for [FilledButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/filter_chip/filter_chip.0.dart b/examples/api/lib/material/filter_chip/filter_chip.0.dart index 622a351dec..ed9f27567e 100644 --- a/examples/api/lib/material/filter_chip/filter_chip.0.dart +++ b/examples/api/lib/material/filter_chip/filter_chip.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample FilterChip +/// Flutter code sample for [FilterChip]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/flexible_space_bar/flexible_space_bar.0.dart b/examples/api/lib/material/flexible_space_bar/flexible_space_bar.0.dart index e37be21baa..86126652ea 100644 --- a/examples/api/lib/material/flexible_space_bar/flexible_space_bar.0.dart +++ b/examples/api/lib/material/flexible_space_bar/flexible_space_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FlexibleSpaceBar +/// Flutter code sample for [FlexibleSpaceBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/floating_action_button/floating_action_button.0.dart b/examples/api/lib/material/floating_action_button/floating_action_button.0.dart index d80e5e5d13..b889ccd331 100644 --- a/examples/api/lib/material/floating_action_button/floating_action_button.0.dart +++ b/examples/api/lib/material/floating_action_button/floating_action_button.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FloatingActionButton +/// Flutter code sample for [FloatingActionButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/floating_action_button/floating_action_button.1.dart b/examples/api/lib/material/floating_action_button/floating_action_button.1.dart index 525cd4e4eb..48c3142812 100644 --- a/examples/api/lib/material/floating_action_button/floating_action_button.1.dart +++ b/examples/api/lib/material/floating_action_button/floating_action_button.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FloatingActionButton +/// Flutter code sample for [FloatingActionButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/floating_action_button/floating_action_button.2.dart b/examples/api/lib/material/floating_action_button/floating_action_button.2.dart index cd39e3992e..b6a8f37e3e 100644 --- a/examples/api/lib/material/floating_action_button/floating_action_button.2.dart +++ b/examples/api/lib/material/floating_action_button/floating_action_button.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FloatingActionButton +/// Flutter code sample for [FloatingActionButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/floating_action_button/floating_action_button.3.dart b/examples/api/lib/material/floating_action_button/floating_action_button.3.dart index 0001ad7938..a0f800b3b2 100644 --- a/examples/api/lib/material/floating_action_button/floating_action_button.3.dart +++ b/examples/api/lib/material/floating_action_button/floating_action_button.3.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FloatingActionButton +/// Flutter code sample for [FloatingActionButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/floating_action_button_location/standard_fab_location.0.dart b/examples/api/lib/material/floating_action_button_location/standard_fab_location.0.dart index 67e68639a2..3d56a38456 100644 --- a/examples/api/lib/material/floating_action_button_location/standard_fab_location.0.dart +++ b/examples/api/lib/material/floating_action_button_location/standard_fab_location.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for StandardFabLocation +/// Flutter code sample for [StandardFabLocation]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/icon_button/icon_button.0.dart b/examples/api/lib/material/icon_button/icon_button.0.dart index 6475602223..08a7c70d05 100644 --- a/examples/api/lib/material/icon_button/icon_button.0.dart +++ b/examples/api/lib/material/icon_button/icon_button.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for IconButton +/// Flutter code sample for [IconButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/icon_button/icon_button.1.dart b/examples/api/lib/material/icon_button/icon_button.1.dart index 71c216aa2c..aa12f4ad98 100644 --- a/examples/api/lib/material/icon_button/icon_button.1.dart +++ b/examples/api/lib/material/icon_button/icon_button.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for IconButton +/// Flutter code sample for [IconButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/icon_button/icon_button.2.dart b/examples/api/lib/material/icon_button/icon_button.2.dart index 95df1eb32c..c00d291389 100644 --- a/examples/api/lib/material/icon_button/icon_button.2.dart +++ b/examples/api/lib/material/icon_button/icon_button.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for IconButton +/// Flutter code sample for [IconButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/icon_button/icon_button.3.dart b/examples/api/lib/material/icon_button/icon_button.3.dart index 1e819a4a71..e7428e2743 100644 --- a/examples/api/lib/material/icon_button/icon_button.3.dart +++ b/examples/api/lib/material/icon_button/icon_button.3.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for IconButton with toggle feature +/// Flutter code sample for [IconButton] with toggle feature. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/ink/ink.image_clip.0.dart b/examples/api/lib/material/ink/ink.image_clip.0.dart index b6fb0992f3..80e3e6979d 100644 --- a/examples/api/lib/material/ink/ink.image_clip.0.dart +++ b/examples/api/lib/material/ink/ink.image_clip.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Image.frameBuilder +/// Flutter code sample for [Image.frameBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/ink/ink.image_clip.1.dart b/examples/api/lib/material/ink/ink.image_clip.1.dart index 2338d9c443..bc8757541f 100644 --- a/examples/api/lib/material/ink/ink.image_clip.1.dart +++ b/examples/api/lib/material/ink/ink.image_clip.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Image.frameBuilder +/// Flutter code sample for [Image.frameBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/ink_well/ink_well.0.dart b/examples/api/lib/material/ink_well/ink_well.0.dart index 8959370a9b..238c8c2304 100644 --- a/examples/api/lib/material/ink_well/ink_well.0.dart +++ b/examples/api/lib/material/ink_well/ink_well.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InkWell +/// Flutter code sample for [InkWell]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_chip/input_chip.0.dart b/examples/api/lib/material/input_chip/input_chip.0.dart index 68e7c6c07b..8ac57d6330 100644 --- a/examples/api/lib/material/input_chip/input_chip.0.dart +++ b/examples/api/lib/material/input_chip/input_chip.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample InputChip +// Flutter code sample InputChip. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.0.dart b/examples/api/lib/material/input_decorator/input_decoration.0.dart index 11cb26f0d8..98e9befb82 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration +/// Flutter code sample for [InputDecoration]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.1.dart b/examples/api/lib/material/input_decorator/input_decoration.1.dart index 5c56ca460e..ff209876e1 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.1.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration +/// Flutter code sample for [InputDecoration]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.2.dart b/examples/api/lib/material/input_decorator/input_decoration.2.dart index 011d76542b..e2b05b1caf 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.2.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration +/// Flutter code sample for [InputDecoration]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.3.dart b/examples/api/lib/material/input_decorator/input_decoration.3.dart index d316144549..3c3b9718db 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.3.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.3.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration +/// Flutter code sample for [InputDecoration]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.floating_label_style_error.0.dart b/examples/api/lib/material/input_decorator/input_decoration.floating_label_style_error.0.dart index e7b0782339..a620114dc9 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.floating_label_style_error.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.floating_label_style_error.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecorator +/// Flutter code sample for [InputDecorator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.label.0.dart b/examples/api/lib/material/input_decorator/input_decoration.label.0.dart index ab7caff859..5f9b39fd92 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.label.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.label.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration.label +/// Flutter code sample for [InputDecoration.label]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.label_style_error.0.dart b/examples/api/lib/material/input_decorator/input_decoration.label_style_error.0.dart index 44ad6ba198..4724436c13 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.label_style_error.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.label_style_error.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecorator +/// Flutter code sample for [InputDecorator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.material_state.0.dart b/examples/api/lib/material/input_decorator/input_decoration.material_state.0.dart index d38e99ad14..7fcf5a561d 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.material_state.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.material_state.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration +/// Flutter code sample for [InputDecoration]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.material_state.1.dart b/examples/api/lib/material/input_decorator/input_decoration.material_state.1.dart index 650f1e2a8a..9c23b03d51 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.material_state.1.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.material_state.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration +/// Flutter code sample for [InputDecoration]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.prefix_icon.0.dart b/examples/api/lib/material/input_decorator/input_decoration.prefix_icon.0.dart index d400f6d71f..681be1ea29 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.prefix_icon.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.prefix_icon.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecorator +/// Flutter code sample for [InputDecorator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.prefix_icon_constraints.0.dart b/examples/api/lib/material/input_decorator/input_decoration.prefix_icon_constraints.0.dart index 067a4df0af..b6355d34ee 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.prefix_icon_constraints.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.prefix_icon_constraints.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration.prefixIconConstraints +/// Flutter code sample for [InputDecoration.prefixIconConstraints]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.suffix_icon.0.dart b/examples/api/lib/material/input_decorator/input_decoration.suffix_icon.0.dart index 627d3c6924..8ad45d52db 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.suffix_icon.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.suffix_icon.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecorator +/// Flutter code sample for [InputDecorator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/input_decorator/input_decoration.suffix_icon_constraints.0.dart b/examples/api/lib/material/input_decorator/input_decoration.suffix_icon_constraints.0.dart index eb8270bdb4..77af958aed 100644 --- a/examples/api/lib/material/input_decorator/input_decoration.suffix_icon_constraints.0.dart +++ b/examples/api/lib/material/input_decorator/input_decoration.suffix_icon_constraints.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InputDecoration.suffixIconConstraints +/// Flutter code sample for [InputDecoration.suffixIconConstraints]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/list_tile/list_tile.0.dart b/examples/api/lib/material/list_tile/list_tile.0.dart index 89def7600d..25b2226292 100644 --- a/examples/api/lib/material/list_tile/list_tile.0.dart +++ b/examples/api/lib/material/list_tile/list_tile.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ListTile +/// Flutter code sample for [ListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/list_tile/list_tile.1.dart b/examples/api/lib/material/list_tile/list_tile.1.dart index b94da2fbb0..ec482eabed 100644 --- a/examples/api/lib/material/list_tile/list_tile.1.dart +++ b/examples/api/lib/material/list_tile/list_tile.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ListTile +/// Flutter code sample for [ListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/list_tile/list_tile.4.dart b/examples/api/lib/material/list_tile/list_tile.4.dart index 238b347c96..403a880b5a 100644 --- a/examples/api/lib/material/list_tile/list_tile.4.dart +++ b/examples/api/lib/material/list_tile/list_tile.4.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ListTile +/// Flutter code sample for [ListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/list_tile/list_tile.5.dart b/examples/api/lib/material/list_tile/list_tile.5.dart index 01c60015a8..60532019f0 100644 --- a/examples/api/lib/material/list_tile/list_tile.5.dart +++ b/examples/api/lib/material/list_tile/list_tile.5.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ListTile +/// Flutter code sample for [ListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/list_tile/list_tile.selected.0.dart b/examples/api/lib/material/list_tile/list_tile.selected.0.dart index 413197c8e4..de74ef0b2d 100644 --- a/examples/api/lib/material/list_tile/list_tile.selected.0.dart +++ b/examples/api/lib/material/list_tile/list_tile.selected.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ListTile.selected +/// Flutter code sample for [ListTile.selected]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/material_state/material_state_border_side.0.dart b/examples/api/lib/material/material_state/material_state_border_side.0.dart index 6a27f4d155..9fb0f38bc0 100644 --- a/examples/api/lib/material/material_state/material_state_border_side.0.dart +++ b/examples/api/lib/material/material_state/material_state_border_side.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MaterialStateBorderSide +/// Flutter code sample for [MaterialStateBorderSide]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/material_state/material_state_mouse_cursor.0.dart b/examples/api/lib/material/material_state/material_state_mouse_cursor.0.dart index d54652d250..c4b5c62bff 100644 --- a/examples/api/lib/material/material_state/material_state_mouse_cursor.0.dart +++ b/examples/api/lib/material/material_state/material_state_mouse_cursor.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MaterialStateMouseCursor +/// Flutter code sample for [MaterialStateMouseCursor]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/material_state/material_state_outlined_border.0.dart b/examples/api/lib/material/material_state/material_state_outlined_border.0.dart index ceb38a737b..eb92cd7505 100644 --- a/examples/api/lib/material/material_state/material_state_outlined_border.0.dart +++ b/examples/api/lib/material/material_state/material_state_outlined_border.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MaterialStateOutlinedBorder +/// Flutter code sample for [MaterialStateOutlinedBorder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/material_state/material_state_property.0.dart b/examples/api/lib/material/material_state/material_state_property.0.dart index b277f6e57b..da746d0b60 100644 --- a/examples/api/lib/material/material_state/material_state_property.0.dart +++ b/examples/api/lib/material/material_state/material_state_property.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MaterialStateProperty +/// Flutter code sample for [MaterialStateProperty]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/navigation_bar/navigation_bar.0.dart b/examples/api/lib/material/navigation_bar/navigation_bar.0.dart index 568301b363..ac22535fb3 100644 --- a/examples/api/lib/material/navigation_bar/navigation_bar.0.dart +++ b/examples/api/lib/material/navigation_bar/navigation_bar.0.dart @@ -2,369 +2,74 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NavigationBar with nested Navigator destinations. +/// Flutter code sample for [NavigationBar]. import 'package:flutter/material.dart'; -class Destination { - const Destination(this.index, this.title, this.icon, this.color); - final int index; - final String title; - final IconData icon; - final MaterialColor color; -} +void main() => runApp(const ExampleApp()); -class RootPage extends StatelessWidget { - const RootPage({ super.key, required this.destination }); - - final Destination destination; - - Widget _buildDialog(BuildContext context) { - return AlertDialog( - title: Text('${destination.title} AlertDialog'), - actions: [ - TextButton( - onPressed: () { Navigator.pop(context); }, - child: const Text('OK'), - ), - ], - ); - } +class ExampleApp extends StatelessWidget { + const ExampleApp({super.key}); @override Widget build(BuildContext context) { - final TextStyle headlineSmall = Theme.of(context).textTheme.headlineSmall!; - final ButtonStyle buttonStyle = ElevatedButton.styleFrom( - backgroundColor: destination.color, - visualDensity: VisualDensity.comfortable, - padding: const EdgeInsets.symmetric(vertical: 12, horizontal: 16), - textStyle: headlineSmall, - ); + return const MaterialApp(home: NavigationExample()); + } +} +class NavigationExample extends StatefulWidget { + const NavigationExample({super.key}); + + @override + State createState() => _NavigationExampleState(); +} + +class _NavigationExampleState extends State { + int currentPageIndex = 0; + + @override + Widget build(BuildContext context) { return Scaffold( - appBar: AppBar( - title: Text('${destination.title} RootPage - /'), - backgroundColor: destination.color, - ), - backgroundColor: destination.color[50], - body: Center( - child: Column( - mainAxisSize: MainAxisSize.min, - children: [ - ElevatedButton( - style: buttonStyle, - onPressed: () { - Navigator.pushNamed(context, '/list'); - }, - child: const Text('Push /list'), - ), - const SizedBox(height: 16), - ElevatedButton( - style: buttonStyle, - onPressed: () { - showDialog( - context: context, - useRootNavigator: false, - builder: _buildDialog, - ); - }, - child: const Text('Local Dialog'), - ), - const SizedBox(height: 16), - ElevatedButton( - style: buttonStyle, - onPressed: () { - showDialog( - context: context, - useRootNavigator: true, - builder: _buildDialog, - ); - }, - child: const Text('Root Dialog'), - ), - const SizedBox(height: 16), - Builder( - builder: (BuildContext context) { - return ElevatedButton( - style: buttonStyle, - onPressed: () { - showBottomSheet( - context: context, - builder: (BuildContext context) { - return Container( - padding: const EdgeInsets.all(16), - width: double.infinity, - child: Text( - '${destination.title} BottomSheet\n' - 'Tap the back button to dismiss', - style: headlineSmall, - softWrap: true, - textAlign: TextAlign.center, - ), - ); - }, - ); - }, - child: const Text('Local BottomSheet'), - ); - }, - ), - ], - ), - ), - ); - } -} - -class ListPage extends StatelessWidget { - const ListPage({ super.key, required this.destination }); - - final Destination destination; - - @override - Widget build(BuildContext context) { - const int itemCount = 50; - final ButtonStyle buttonStyle = OutlinedButton.styleFrom( - foregroundColor: destination.color, - fixedSize: const Size.fromHeight(128), - textStyle: Theme.of(context).textTheme.headlineSmall, - ); - return Scaffold( - appBar: AppBar( - title: Text('${destination.title} ListPage - /list'), - backgroundColor: destination.color, - ), - backgroundColor: destination.color[50], - body: SizedBox.expand( - child: ListView.builder( - itemCount: itemCount, - itemBuilder: (BuildContext context, int index) { - return Padding( - padding: const EdgeInsets.symmetric(vertical: 4, horizontal: 8), - child: OutlinedButton( - style: buttonStyle.copyWith( - backgroundColor: MaterialStatePropertyAll( - Color.lerp(destination.color[100], Colors.white, index / itemCount)! - ), - ), - onPressed: () { - Navigator.pushNamed(context, '/text'); - }, - child: Text('Push /text [$index]'), - ), - ); - }, - ), - ), - ); - } -} - -class TextPage extends StatefulWidget { - const TextPage({ super.key, required this.destination }); - - final Destination destination; - - @override - State createState() => _TextPageState(); -} - -class _TextPageState extends State { - late final TextEditingController textController; - - @override - void initState() { - super.initState(); - textController = TextEditingController(text: 'Sample Text'); - } - - @override - void dispose() { - textController.dispose(); - super.dispose(); - } - - @override - Widget build(BuildContext context) { - final ThemeData theme = Theme.of(context); - return Scaffold( - appBar: AppBar( - title: Text('${widget.destination.title} TextPage - /list/text'), - backgroundColor: widget.destination.color, - ), - backgroundColor: widget.destination.color[50], - body: Container( - padding: const EdgeInsets.all(32.0), - alignment: Alignment.center, - child: TextField( - controller: textController, - style: theme.primaryTextTheme.headlineMedium?.copyWith( - color: widget.destination.color, + bottomNavigationBar: NavigationBar( + onDestinationSelected: (int index) { + setState(() { + currentPageIndex = index; + }); + }, + selectedIndex: currentPageIndex, + destinations: const [ + NavigationDestination( + icon: Icon(Icons.explore), + label: 'Explore', ), - decoration: InputDecoration( - focusedBorder: UnderlineInputBorder( - borderSide: BorderSide( - color: widget.destination.color, - width: 3.0, - ), - ), + NavigationDestination( + icon: Icon(Icons.commute), + label: 'Commute', ), - ), + NavigationDestination( + selectedIcon: Icon(Icons.bookmark), + icon: Icon(Icons.bookmark_border), + label: 'Saved', + ), + ], ), - ); - } -} - -class DestinationView extends StatefulWidget { - const DestinationView({ - super.key, - required this.destination, - required this.navigatorKey, - }); - - final Destination destination; - final Key navigatorKey; - - @override - State createState() => _DestinationViewState(); -} - -class _DestinationViewState extends State { - @override - Widget build(BuildContext context) { - return Navigator( - key: widget.navigatorKey, - onGenerateRoute: (RouteSettings settings) { - return MaterialPageRoute( - settings: settings, - builder: (BuildContext context) { - switch(settings.name) { - case '/': - return RootPage(destination: widget.destination); - case '/list': - return ListPage(destination: widget.destination); - case '/text': - return TextPage(destination: widget.destination); - } - assert(false); - return const SizedBox(); - }, - ); - }, - ); - } -} - -class Home extends StatefulWidget { - const Home({ super.key }); - - @override - State createState() => _HomeState(); -} - -class _HomeState extends State with TickerProviderStateMixin { - static const List allDestinations = [ - Destination(0, 'Teal', Icons.home, Colors.teal), - Destination(1, 'Cyan', Icons.business, Colors.cyan), - Destination(2, 'Orange', Icons.school, Colors.orange), - Destination(3, 'Blue', Icons.flight, Colors.blue), - ]; - - late final List> navigatorKeys; - late final List destinationKeys; - late final List destinationFaders; - late final List destinationViews; - int selectedIndex = 0; - - AnimationController buildFaderController() { - final AnimationController controller = AnimationController(vsync: this, duration: const Duration(milliseconds: 200)); - controller.addStatusListener((AnimationStatus status) { - if (status == AnimationStatus.dismissed) { - setState(() { }); // Rebuild unselected destinations offstage. - } - }); - return controller; - } - - @override - void initState() { - super.initState(); - navigatorKeys = List>.generate(allDestinations.length, (int index) => GlobalKey()).toList(); - destinationFaders = List.generate(allDestinations.length, (int index) => buildFaderController()).toList(); - destinationFaders[selectedIndex].value = 1.0; - destinationViews = allDestinations.map((Destination destination) { - return FadeTransition( - opacity: destinationFaders[destination.index].drive(CurveTween(curve: Curves.fastOutSlowIn)), - child: KeyedSubtree( - key: GlobalKey(), - child: DestinationView( - destination: destination, - navigatorKey: navigatorKeys[destination.index], - ), - ) - ); - }).toList(); - } - - @override - void dispose() { - for (final AnimationController controller in destinationFaders) { - controller.dispose(); - } - super.dispose(); - } - - @override - Widget build(BuildContext context) { - return WillPopScope( - onWillPop: () async { - final NavigatorState navigator = navigatorKeys[selectedIndex].currentState!; - if (!navigator.canPop()) { - return true; - } - navigator.pop(); - return false; - }, - child: Scaffold( - body: SafeArea( - top: false, - child: Stack( - fit: StackFit.expand, - children: allDestinations.map((Destination destination) { - final int index = destination.index; - final Widget view = destinationViews[index]; - if (index == selectedIndex) { - destinationFaders[index].forward(); - return Offstage(offstage: false, child: view); - } else { - destinationFaders[index].reverse(); - if (destinationFaders[index].isAnimating) { - return IgnorePointer(child: view); - } - return Offstage(child: view); - } - }).toList(), - ), + body: [ + Container( + color: Colors.red, + alignment: Alignment.center, + child: const Text('Page 1'), ), - bottomNavigationBar: NavigationBar( - selectedIndex: selectedIndex, - onDestinationSelected: (int index) { - setState(() { - selectedIndex = index; - }); - }, - destinations: allDestinations.map((Destination destination) { - return NavigationDestination( - icon: Icon(destination.icon, color: destination.color), - label: destination.title, - ); - }).toList(), + Container( + color: Colors.green, + alignment: Alignment.center, + child: const Text('Page 2'), ), - ), + Container( + color: Colors.blue, + alignment: Alignment.center, + child: const Text('Page 3'), + ), + ][currentPageIndex], ); } } - -void main() { - runApp(const MaterialApp(home: Home())); -} diff --git a/examples/api/lib/material/navigation_bar/navigation_bar.1.dart b/examples/api/lib/material/navigation_bar/navigation_bar.1.dart new file mode 100644 index 0000000000..42d21aa50e --- /dev/null +++ b/examples/api/lib/material/navigation_bar/navigation_bar.1.dart @@ -0,0 +1,367 @@ +// Copyright 2014 The Flutter Authors. All rights reserved. +// Use of this source code is governed by a BSD-style license that can be +// found in the LICENSE file. + +/// Flutter code sample for [NavigationBar] with nested [Navigator] destinations. + +import 'package:flutter/material.dart'; + +void main() { + runApp(const MaterialApp(home: Home())); +} + +class Home extends StatefulWidget { + const Home({ super.key }); + + @override + State createState() => _HomeState(); +} + +class _HomeState extends State with TickerProviderStateMixin { + static const List allDestinations = [ + Destination(0, 'Teal', Icons.home, Colors.teal), + Destination(1, 'Cyan', Icons.business, Colors.cyan), + Destination(2, 'Orange', Icons.school, Colors.orange), + Destination(3, 'Blue', Icons.flight, Colors.blue), + ]; + + late final List> navigatorKeys; + late final List destinationKeys; + late final List destinationFaders; + late final List destinationViews; + int selectedIndex = 0; + + AnimationController buildFaderController() { + final AnimationController controller = AnimationController(vsync: this, duration: const Duration(milliseconds: 200)); + controller.addStatusListener((AnimationStatus status) { + if (status == AnimationStatus.dismissed) { + setState(() { }); // Rebuild unselected destinations offstage. + } + }); + return controller; + } + + @override + void initState() { + super.initState(); + navigatorKeys = List>.generate(allDestinations.length, (int index) => GlobalKey()).toList(); + destinationFaders = List.generate(allDestinations.length, (int index) => buildFaderController()).toList(); + destinationFaders[selectedIndex].value = 1.0; + destinationViews = allDestinations.map((Destination destination) { + return FadeTransition( + opacity: destinationFaders[destination.index].drive(CurveTween(curve: Curves.fastOutSlowIn)), + child: DestinationView( + destination: destination, + navigatorKey: navigatorKeys[destination.index], + ) + ); + }).toList(); + } + + @override + void dispose() { + for (final AnimationController controller in destinationFaders) { + controller.dispose(); + } + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return WillPopScope( + onWillPop: () async { + final NavigatorState navigator = navigatorKeys[selectedIndex].currentState!; + if (!navigator.canPop()) { + return true; + } + navigator.pop(); + return false; + }, + child: Scaffold( + body: SafeArea( + top: false, + child: Stack( + fit: StackFit.expand, + children: allDestinations.map((Destination destination) { + final int index = destination.index; + final Widget view = destinationViews[index]; + if (index == selectedIndex) { + destinationFaders[index].forward(); + return Offstage(offstage: false, child: view); + } else { + destinationFaders[index].reverse(); + if (destinationFaders[index].isAnimating) { + return IgnorePointer(child: view); + } + return Offstage(child: view); + } + }).toList(), + ), + ), + bottomNavigationBar: NavigationBar( + selectedIndex: selectedIndex, + onDestinationSelected: (int index) { + setState(() { + selectedIndex = index; + }); + }, + destinations: allDestinations.map((Destination destination) { + return NavigationDestination( + icon: Icon(destination.icon, color: destination.color), + label: destination.title, + ); + }).toList(), + ), + ), + ); + } +} + +class Destination { + const Destination(this.index, this.title, this.icon, this.color); + final int index; + final String title; + final IconData icon; + final MaterialColor color; +} + +class RootPage extends StatelessWidget { + const RootPage({ super.key, required this.destination }); + + final Destination destination; + + Widget _buildDialog(BuildContext context) { + return AlertDialog( + title: Text('${destination.title} AlertDialog'), + actions: [ + TextButton( + onPressed: () { Navigator.pop(context); }, + child: const Text('OK'), + ), + ], + ); + } + + @override + Widget build(BuildContext context) { + final TextStyle headlineSmall = Theme.of(context).textTheme.headlineSmall!; + final ButtonStyle buttonStyle = ElevatedButton.styleFrom( + backgroundColor: destination.color, + visualDensity: VisualDensity.comfortable, + padding: const EdgeInsets.symmetric(vertical: 12, horizontal: 16), + textStyle: headlineSmall, + ); + + return Scaffold( + appBar: AppBar( + title: Text('${destination.title} RootPage - /'), + backgroundColor: destination.color, + ), + backgroundColor: destination.color[50], + body: Center( + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + ElevatedButton( + style: buttonStyle, + onPressed: () { + Navigator.pushNamed(context, '/list'); + }, + child: const Text('Push /list'), + ), + const SizedBox(height: 16), + ElevatedButton( + style: buttonStyle, + onPressed: () { + showDialog( + context: context, + useRootNavigator: false, + builder: _buildDialog, + ); + }, + child: const Text('Local Dialog'), + ), + const SizedBox(height: 16), + ElevatedButton( + style: buttonStyle, + onPressed: () { + showDialog( + context: context, + useRootNavigator: true, + builder: _buildDialog, + ); + }, + child: const Text('Root Dialog'), + ), + const SizedBox(height: 16), + Builder( + builder: (BuildContext context) { + return ElevatedButton( + style: buttonStyle, + onPressed: () { + showBottomSheet( + context: context, + builder: (BuildContext context) { + return Container( + padding: const EdgeInsets.all(16), + width: double.infinity, + child: Text( + '${destination.title} BottomSheet\n' + 'Tap the back button to dismiss', + style: headlineSmall, + softWrap: true, + textAlign: TextAlign.center, + ), + ); + }, + ); + }, + child: const Text('Local BottomSheet'), + ); + }, + ), + ], + ), + ), + ); + } +} + +class ListPage extends StatelessWidget { + const ListPage({ super.key, required this.destination }); + + final Destination destination; + + @override + Widget build(BuildContext context) { + const int itemCount = 50; + final ButtonStyle buttonStyle = OutlinedButton.styleFrom( + foregroundColor: destination.color, + fixedSize: const Size.fromHeight(128), + textStyle: Theme.of(context).textTheme.headlineSmall, + ); + return Scaffold( + appBar: AppBar( + title: Text('${destination.title} ListPage - /list'), + backgroundColor: destination.color, + ), + backgroundColor: destination.color[50], + body: SizedBox.expand( + child: ListView.builder( + itemCount: itemCount, + itemBuilder: (BuildContext context, int index) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 4, horizontal: 8), + child: OutlinedButton( + style: buttonStyle.copyWith( + backgroundColor: MaterialStatePropertyAll( + Color.lerp(destination.color[100], Colors.white, index / itemCount)! + ), + ), + onPressed: () { + Navigator.pushNamed(context, '/text'); + }, + child: Text('Push /text [$index]'), + ), + ); + }, + ), + ), + ); + } +} + +class TextPage extends StatefulWidget { + const TextPage({ super.key, required this.destination }); + + final Destination destination; + + @override + State createState() => _TextPageState(); +} + +class _TextPageState extends State { + late final TextEditingController textController; + + @override + void initState() { + super.initState(); + textController = TextEditingController(text: 'Sample Text'); + } + + @override + void dispose() { + textController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + final ThemeData theme = Theme.of(context); + return Scaffold( + appBar: AppBar( + title: Text('${widget.destination.title} TextPage - /list/text'), + backgroundColor: widget.destination.color, + ), + backgroundColor: widget.destination.color[50], + body: Container( + padding: const EdgeInsets.all(32.0), + alignment: Alignment.center, + child: TextField( + controller: textController, + style: theme.primaryTextTheme.headlineMedium?.copyWith( + color: widget.destination.color, + ), + decoration: InputDecoration( + focusedBorder: UnderlineInputBorder( + borderSide: BorderSide( + color: widget.destination.color, + width: 3.0, + ), + ), + ), + ), + ), + ); + } +} + +class DestinationView extends StatefulWidget { + const DestinationView({ + super.key, + required this.destination, + required this.navigatorKey, + }); + + final Destination destination; + final Key navigatorKey; + + @override + State createState() => _DestinationViewState(); +} + +class _DestinationViewState extends State { + @override + Widget build(BuildContext context) { + return Navigator( + key: widget.navigatorKey, + onGenerateRoute: (RouteSettings settings) { + return MaterialPageRoute( + settings: settings, + builder: (BuildContext context) { + switch(settings.name) { + case '/': + return RootPage(destination: widget.destination); + case '/list': + return ListPage(destination: widget.destination); + case '/text': + return TextPage(destination: widget.destination); + } + assert(false); + return const SizedBox(); + }, + ); + }, + ); + } +} diff --git a/examples/api/lib/material/navigation_bar/navigation_bar.dart b/examples/api/lib/material/navigation_bar/navigation_bar.dart deleted file mode 100644 index 0b93c9349c..0000000000 --- a/examples/api/lib/material/navigation_bar/navigation_bar.dart +++ /dev/null @@ -1,77 +0,0 @@ -// Copyright 2014 The Flutter Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -// Flutter code sample for NavigationBar - -import 'package:flutter/material.dart'; - -void main() { - runApp(const MyApp()); -} - -class MyApp extends StatelessWidget { - const MyApp({super.key}); - - @override - Widget build(BuildContext context) { - return const MaterialApp(home: NavigationExample()); - } -} - -class NavigationExample extends StatefulWidget { - const NavigationExample({super.key}); - - @override - State createState() => _NavigationExampleState(); -} - -class _NavigationExampleState extends State { - int currentPageIndex = 0; - - @override - Widget build(BuildContext context) { - return Scaffold( - bottomNavigationBar: NavigationBar( - onDestinationSelected: (int index) { - setState(() { - currentPageIndex = index; - }); - }, - selectedIndex: currentPageIndex, - destinations: const [ - NavigationDestination( - icon: Icon(Icons.explore), - label: 'Explore', - ), - NavigationDestination( - icon: Icon(Icons.commute), - label: 'Commute', - ), - NavigationDestination( - selectedIcon: Icon(Icons.bookmark), - icon: Icon(Icons.bookmark_border), - label: 'Saved', - ), - ], - ), - body: [ - Container( - color: Colors.red, - alignment: Alignment.center, - child: const Text('Page 1'), - ), - Container( - color: Colors.green, - alignment: Alignment.center, - child: const Text('Page 2'), - ), - Container( - color: Colors.blue, - alignment: Alignment.center, - child: const Text('Page 3'), - ), - ][currentPageIndex], - ); - } -} diff --git a/examples/api/lib/material/navigation_rail/navigation_rail.0.dart b/examples/api/lib/material/navigation_rail/navigation_rail.0.dart index b4a920d086..cbc8b13641 100644 --- a/examples/api/lib/material/navigation_rail/navigation_rail.0.dart +++ b/examples/api/lib/material/navigation_rail/navigation_rail.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NavigationRail +/// Flutter code sample for [NavigationRail]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/navigation_rail/navigation_rail.1.dart b/examples/api/lib/material/navigation_rail/navigation_rail.1.dart index d5180955e6..6c09adbe14 100644 --- a/examples/api/lib/material/navigation_rail/navigation_rail.1.dart +++ b/examples/api/lib/material/navigation_rail/navigation_rail.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NavigationRail +/// Flutter code sample for [NavigationRail]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/navigation_rail/navigation_rail.extended_animation.0.dart b/examples/api/lib/material/navigation_rail/navigation_rail.extended_animation.0.dart index 7a5a237c80..c7d34a65d3 100644 --- a/examples/api/lib/material/navigation_rail/navigation_rail.extended_animation.0.dart +++ b/examples/api/lib/material/navigation_rail/navigation_rail.extended_animation.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NavigationRail.extendedAnimation +/// Flutter code sample for [NavigationRail.extendedAnimation]. import 'dart:ui'; diff --git a/examples/api/lib/material/outlined_button/outlined_button.0.dart b/examples/api/lib/material/outlined_button/outlined_button.0.dart index b21d974679..f3689ccbf5 100644 --- a/examples/api/lib/material/outlined_button/outlined_button.0.dart +++ b/examples/api/lib/material/outlined_button/outlined_button.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for OutlinedButton +/// Flutter code sample for [OutlinedButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/platform_menu_bar/platform_menu_bar.0.dart b/examples/api/lib/material/platform_menu_bar/platform_menu_bar.0.dart index eb08ace900..b12082525a 100644 --- a/examples/api/lib/material/platform_menu_bar/platform_menu_bar.0.dart +++ b/examples/api/lib/material/platform_menu_bar/platform_menu_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PlatformMenuBar +/// Flutter code sample for [PlatformMenuBar]. //////////////////////////////////// // THIS SAMPLE ONLY WORKS ON MACOS. @@ -11,32 +11,32 @@ import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; -void main() => runApp(const SampleApp()); +void main() => runApp(const ExampleApp()); enum MenuSelection { about, showMessage, } -class SampleApp extends StatelessWidget { - const SampleApp({super.key}); +class ExampleApp extends StatelessWidget { + const ExampleApp({super.key}); @override Widget build(BuildContext context) { return const MaterialApp( - home: Scaffold(body: MyMenuBarApp()), + home: Scaffold(body: PlatformMenuBarExample()), ); } } -class MyMenuBarApp extends StatefulWidget { - const MyMenuBarApp({super.key}); +class PlatformMenuBarExample extends StatefulWidget { + const PlatformMenuBarExample({super.key}); @override - State createState() => _MyMenuBarAppState(); + State createState() => _PlatformMenuBarExampleState(); } -class _MyMenuBarAppState extends State { +class _PlatformMenuBarExampleState extends State { String _message = 'Hello'; bool _showMessage = false; diff --git a/examples/api/lib/material/popupmenu/popupmenu.0.dart b/examples/api/lib/material/popupmenu/popupmenu.0.dart index a519826e83..82e6a10518 100644 --- a/examples/api/lib/material/popupmenu/popupmenu.0.dart +++ b/examples/api/lib/material/popupmenu/popupmenu.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PopupMenuButton +/// Flutter code sample for [PopupMenuButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/progress_indicator/circular_progress_indicator.0.dart b/examples/api/lib/material/progress_indicator/circular_progress_indicator.0.dart index b5946406f5..f8a38fe69e 100644 --- a/examples/api/lib/material/progress_indicator/circular_progress_indicator.0.dart +++ b/examples/api/lib/material/progress_indicator/circular_progress_indicator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CircularProgressIndicator +/// Flutter code sample for [CircularProgressIndicator]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late AnimationController controller; diff --git a/examples/api/lib/material/progress_indicator/linear_progress_indicator.0.dart b/examples/api/lib/material/progress_indicator/linear_progress_indicator.0.dart index db75611e94..d1232e1ad8 100644 --- a/examples/api/lib/material/progress_indicator/linear_progress_indicator.0.dart +++ b/examples/api/lib/material/progress_indicator/linear_progress_indicator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for LinearProgressIndicator +/// Flutter code sample for [LinearProgressIndicator]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late AnimationController controller; diff --git a/examples/api/lib/material/radio/radio.0.dart b/examples/api/lib/material/radio/radio.0.dart index 48696dfc7a..f1b72c91fe 100644 --- a/examples/api/lib/material/radio/radio.0.dart +++ b/examples/api/lib/material/radio/radio.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Radio +/// Flutter code sample for [Radio]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/radio/radio.toggleable.0.dart b/examples/api/lib/material/radio/radio.toggleable.0.dart index 441eba9735..2fa293ff73 100644 --- a/examples/api/lib/material/radio/radio.toggleable.0.dart +++ b/examples/api/lib/material/radio/radio.toggleable.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Radio.toggleable +/// Flutter code sample for [Radio.toggleable]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/radio_list_tile/radio_list_tile.0.dart b/examples/api/lib/material/radio_list_tile/radio_list_tile.0.dart index 6c5f2548b5..8ed74b8732 100644 --- a/examples/api/lib/material/radio_list_tile/radio_list_tile.0.dart +++ b/examples/api/lib/material/radio_list_tile/radio_list_tile.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RadioListTile +/// Flutter code sample for [RadioListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/radio_list_tile/radio_list_tile.1.dart b/examples/api/lib/material/radio_list_tile/radio_list_tile.1.dart index 5a181eebaa..2129bed8fe 100644 --- a/examples/api/lib/material/radio_list_tile/radio_list_tile.1.dart +++ b/examples/api/lib/material/radio_list_tile/radio_list_tile.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RadioListTile +/// Flutter code sample for [RadioListTile]. import 'package:flutter/gestures.dart'; diff --git a/examples/api/lib/material/radio_list_tile/radio_list_tile.2.dart b/examples/api/lib/material/radio_list_tile/radio_list_tile.2.dart index 7824f5500d..fc4d2db43a 100644 --- a/examples/api/lib/material/radio_list_tile/radio_list_tile.2.dart +++ b/examples/api/lib/material/radio_list_tile/radio_list_tile.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RadioListTile +/// Flutter code sample for [RadioListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/radio_list_tile/radio_list_tile.toggleable.0.dart b/examples/api/lib/material/radio_list_tile/radio_list_tile.toggleable.0.dart index 5c9fc9b637..d975560f02 100644 --- a/examples/api/lib/material/radio_list_tile/radio_list_tile.toggleable.0.dart +++ b/examples/api/lib/material/radio_list_tile/radio_list_tile.toggleable.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RadioListTile.toggleable +/// Flutter code sample for [RadioListTile.toggleable]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/range_slider/range_slider.0.dart b/examples/api/lib/material/range_slider/range_slider.0.dart index 65fe064f87..0a7f294551 100644 --- a/examples/api/lib/material/range_slider/range_slider.0.dart +++ b/examples/api/lib/material/range_slider/range_slider.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RangeSlider +/// Flutter code sample for [RangeSlider]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/refresh_indicator/refresh_indicator.0.dart b/examples/api/lib/material/refresh_indicator/refresh_indicator.0.dart index f5119b5186..516fdddd78 100644 --- a/examples/api/lib/material/refresh_indicator/refresh_indicator.0.dart +++ b/examples/api/lib/material/refresh_indicator/refresh_indicator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RefreshIndicator +/// Flutter code sample for [RefreshIndicator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/refresh_indicator/refresh_indicator.1.dart b/examples/api/lib/material/refresh_indicator/refresh_indicator.1.dart index c0fd096988..693fa400e0 100644 --- a/examples/api/lib/material/refresh_indicator/refresh_indicator.1.dart +++ b/examples/api/lib/material/refresh_indicator/refresh_indicator.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RefreshIndicator +/// Flutter code sample for [RefreshIndicator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/reorderable_list/reorderable_list_view.0.dart b/examples/api/lib/material/reorderable_list/reorderable_list_view.0.dart index fffab71e5b..f0f131c97a 100644 --- a/examples/api/lib/material/reorderable_list/reorderable_list_view.0.dart +++ b/examples/api/lib/material/reorderable_list/reorderable_list_view.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ReorderableListView +/// Flutter code sample for [ReorderableListView]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/reorderable_list/reorderable_list_view.1.dart b/examples/api/lib/material/reorderable_list/reorderable_list_view.1.dart index 53bca26d1d..c09b83d059 100644 --- a/examples/api/lib/material/reorderable_list/reorderable_list_view.1.dart +++ b/examples/api/lib/material/reorderable_list/reorderable_list_view.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ReorderableListView +/// Flutter code sample for [ReorderableListView]. import 'dart:ui'; import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/reorderable_list/reorderable_list_view.build_default_drag_handles.0.dart b/examples/api/lib/material/reorderable_list/reorderable_list_view.build_default_drag_handles.0.dart index 466c8388bd..662bfe4e67 100644 --- a/examples/api/lib/material/reorderable_list/reorderable_list_view.build_default_drag_handles.0.dart +++ b/examples/api/lib/material/reorderable_list/reorderable_list_view.build_default_drag_handles.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ReorderableListView.buildDefaultDragHandles +/// Flutter code sample for [ReorderableListView.buildDefaultDragHandles]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/reorderable_list/reorderable_list_view.reorderable_list_view_builder.0.dart b/examples/api/lib/material/reorderable_list/reorderable_list_view.reorderable_list_view_builder.0.dart index e25f8b8b08..0f826f8902 100644 --- a/examples/api/lib/material/reorderable_list/reorderable_list_view.reorderable_list_view_builder.0.dart +++ b/examples/api/lib/material/reorderable_list/reorderable_list_view.reorderable_list_view_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ReorderableListView.ReorderableListView.builder +/// Flutter code sample for [ReorderableListView.ReorderableListView.builder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold.0.dart b/examples/api/lib/material/scaffold/scaffold.0.dart index f3b65bb936..d75ec1f4b7 100644 --- a/examples/api/lib/material/scaffold/scaffold.0.dart +++ b/examples/api/lib/material/scaffold/scaffold.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scaffold +/// Flutter code sample for [Scaffold]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold.1.dart b/examples/api/lib/material/scaffold/scaffold.1.dart index 4382ffaa60..2c8b0a3ddf 100644 --- a/examples/api/lib/material/scaffold/scaffold.1.dart +++ b/examples/api/lib/material/scaffold/scaffold.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scaffold +/// Flutter code sample for [Scaffold]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold.2.dart b/examples/api/lib/material/scaffold/scaffold.2.dart index a21bcf6baa..3bca41a362 100644 --- a/examples/api/lib/material/scaffold/scaffold.2.dart +++ b/examples/api/lib/material/scaffold/scaffold.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scaffold +/// Flutter code sample for [Scaffold]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold.drawer.0.dart b/examples/api/lib/material/scaffold/scaffold.drawer.0.dart index 0d67f8ea5d..533ff6c223 100644 --- a/examples/api/lib/material/scaffold/scaffold.drawer.0.dart +++ b/examples/api/lib/material/scaffold/scaffold.drawer.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scaffold.drawer +/// Flutter code sample for [Scaffold.drawer]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold.end_drawer.0.dart b/examples/api/lib/material/scaffold/scaffold.end_drawer.0.dart index 0d56d4ea07..0794b7d235 100644 --- a/examples/api/lib/material/scaffold/scaffold.end_drawer.0.dart +++ b/examples/api/lib/material/scaffold/scaffold.end_drawer.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scaffold.endDrawer +/// Flutter code sample for [Scaffold.endDrawer]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold.of.0.dart b/examples/api/lib/material/scaffold/scaffold.of.0.dart index 58ce0baa44..c791dbddc7 100644 --- a/examples/api/lib/material/scaffold/scaffold.of.0.dart +++ b/examples/api/lib/material/scaffold/scaffold.of.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scaffold.of +/// Flutter code sample for [Scaffold.of]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold.of.1.dart b/examples/api/lib/material/scaffold/scaffold.of.1.dart index 7402b464e3..07199e9a31 100644 --- a/examples/api/lib/material/scaffold/scaffold.of.1.dart +++ b/examples/api/lib/material/scaffold/scaffold.of.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scaffold.of +/// Flutter code sample for [Scaffold.of]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold_messenger.0.dart b/examples/api/lib/material/scaffold/scaffold_messenger.0.dart index 99ffec742d..058aad1b58 100644 --- a/examples/api/lib/material/scaffold/scaffold_messenger.0.dart +++ b/examples/api/lib/material/scaffold/scaffold_messenger.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScaffoldMessenger +/// Flutter code sample for [ScaffoldMessenger]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold_messenger.of.0.dart b/examples/api/lib/material/scaffold/scaffold_messenger.of.0.dart index 84146cafb6..f2902b648e 100644 --- a/examples/api/lib/material/scaffold/scaffold_messenger.of.0.dart +++ b/examples/api/lib/material/scaffold/scaffold_messenger.of.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScaffoldMessenger.of +/// Flutter code sample for [ScaffoldMessenger.of]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold_messenger.of.1.dart b/examples/api/lib/material/scaffold/scaffold_messenger.of.1.dart index dd3afca934..0b239022bf 100644 --- a/examples/api/lib/material/scaffold/scaffold_messenger.of.1.dart +++ b/examples/api/lib/material/scaffold/scaffold_messenger.of.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScaffoldMessenger.of +/// Flutter code sample for [ScaffoldMessenger.of]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold_messenger_state.show_material_banner.0.dart b/examples/api/lib/material/scaffold/scaffold_messenger_state.show_material_banner.0.dart index 29cfbd3be7..0e61f010a0 100644 --- a/examples/api/lib/material/scaffold/scaffold_messenger_state.show_material_banner.0.dart +++ b/examples/api/lib/material/scaffold/scaffold_messenger_state.show_material_banner.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScaffoldMessengerState.showMaterialBanner +/// Flutter code sample for [ScaffoldMessengerState.showMaterialBanner]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold_messenger_state.show_snack_bar.0.dart b/examples/api/lib/material/scaffold/scaffold_messenger_state.show_snack_bar.0.dart index c225d55700..808a89c635 100644 --- a/examples/api/lib/material/scaffold/scaffold_messenger_state.show_snack_bar.0.dart +++ b/examples/api/lib/material/scaffold/scaffold_messenger_state.show_snack_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScaffoldMessengerState.showSnackBar +/// Flutter code sample for [ScaffoldMessengerState.showSnackBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold_messenger_state.show_snack_bar.1.dart b/examples/api/lib/material/scaffold/scaffold_messenger_state.show_snack_bar.1.dart index 0f25f1f595..29970120ab 100644 --- a/examples/api/lib/material/scaffold/scaffold_messenger_state.show_snack_bar.1.dart +++ b/examples/api/lib/material/scaffold/scaffold_messenger_state.show_snack_bar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SnackBar +/// Flutter code sample for [SnackBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold_state.show_bottom_sheet.0.dart b/examples/api/lib/material/scaffold/scaffold_state.show_bottom_sheet.0.dart index 566ca06d96..fdb48f8918 100644 --- a/examples/api/lib/material/scaffold/scaffold_state.show_bottom_sheet.0.dart +++ b/examples/api/lib/material/scaffold/scaffold_state.show_bottom_sheet.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScaffoldState.showBottomSheet +/// Flutter code sample for [ScaffoldState.showBottomSheet]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scaffold/scaffold_state.show_snack_bar.0.dart b/examples/api/lib/material/scaffold/scaffold_state.show_snack_bar.0.dart index 7c6cb6e613..1f2cf1dab6 100644 --- a/examples/api/lib/material/scaffold/scaffold_state.show_snack_bar.0.dart +++ b/examples/api/lib/material/scaffold/scaffold_state.show_snack_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScaffoldState.showSnackBar +/// Flutter code sample for [ScaffoldState.showSnackBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scrollbar/scrollbar.0.dart b/examples/api/lib/material/scrollbar/scrollbar.0.dart index aa48478577..5f0c92db5b 100644 --- a/examples/api/lib/material/scrollbar/scrollbar.0.dart +++ b/examples/api/lib/material/scrollbar/scrollbar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scrollbar +/// Flutter code sample for [Scrollbar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/scrollbar/scrollbar.1.dart b/examples/api/lib/material/scrollbar/scrollbar.1.dart index a52772e30b..aea9bebce3 100644 --- a/examples/api/lib/material/scrollbar/scrollbar.1.dart +++ b/examples/api/lib/material/scrollbar/scrollbar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scrollbar +/// Flutter code sample for [Scrollbar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/selection_area/custom_selectable.dart b/examples/api/lib/material/selectable_region/selectable_region.0.dart similarity index 98% rename from examples/api/lib/material/selection_area/custom_selectable.dart rename to examples/api/lib/material/selectable_region/selectable_region.0.dart index 3fc6ee27d2..bc995e9e6f 100644 --- a/examples/api/lib/material/selection_area/custom_selectable.dart +++ b/examples/api/lib/material/selectable_region/selectable_region.0.dart @@ -2,8 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// This sample demonstrates how to create an adapter widget that makes any child -// widget selectable. +/// Flutter code sample for [SelectableRegion]. import 'package:flutter/material.dart'; import 'package:flutter/rendering.dart'; diff --git a/examples/api/lib/material/selection_area/selection_area.dart b/examples/api/lib/material/selection_area/selection_area.0.dart similarity index 94% rename from examples/api/lib/material/selection_area/selection_area.dart rename to examples/api/lib/material/selection_area/selection_area.0.dart index 3577b459b1..cd65006e32 100644 --- a/examples/api/lib/material/selection_area/selection_area.dart +++ b/examples/api/lib/material/selection_area/selection_area.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// This example shows how to make a screen selectable.. +/// Flutter code sample for [SelectionArea]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/selection_area/custom_container.dart b/examples/api/lib/material/selection_container/selection_container.0.dart similarity index 96% rename from examples/api/lib/material/selection_area/custom_container.dart rename to examples/api/lib/material/selection_container/selection_container.0.dart index 264cbfd93e..53ec0952b7 100644 --- a/examples/api/lib/material/selection_area/custom_container.dart +++ b/examples/api/lib/material/selection_container/selection_container.0.dart @@ -2,8 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// This sample demonstrates how to create a [SelectionContainer] that only -// allows selecting everything or nothing with no partial selection. +/// Flutter code sample for [SelectionContainer]. import 'package:flutter/material.dart'; import 'package:flutter/rendering.dart'; diff --git a/examples/api/lib/material/selection_area/disable_partial_selection.dart b/examples/api/lib/material/selection_container/selection_container_disabled.0.dart similarity index 93% rename from examples/api/lib/material/selection_area/disable_partial_selection.dart rename to examples/api/lib/material/selection_container/selection_container_disabled.0.dart index 1e977865cb..a5a8f8c0be 100644 --- a/examples/api/lib/material/selection_area/disable_partial_selection.dart +++ b/examples/api/lib/material/selection_container/selection_container_disabled.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// This example excludes a Text widget from the SelectionArea. +/// Flutter example for [SelectionContainer.disabled]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/slider/slider.0.dart b/examples/api/lib/material/slider/slider.0.dart index 733b4e2a70..8d7babef1c 100644 --- a/examples/api/lib/material/slider/slider.0.dart +++ b/examples/api/lib/material/slider/slider.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Slider +/// Flutter code sample for [Slider]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/slider/slider.1.dart b/examples/api/lib/material/slider/slider.1.dart index 2e0af68521..2c7d5f8263 100644 --- a/examples/api/lib/material/slider/slider.1.dart +++ b/examples/api/lib/material/slider/slider.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Slider +/// Flutter code sample for [Slider]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/snack_bar/snack_bar.0.dart b/examples/api/lib/material/snack_bar/snack_bar.0.dart index 2300ea97d5..7bd1f18cbc 100644 --- a/examples/api/lib/material/snack_bar/snack_bar.0.dart +++ b/examples/api/lib/material/snack_bar/snack_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SnackBar +/// Flutter code sample for [SnackBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/snack_bar/snack_bar.1.dart b/examples/api/lib/material/snack_bar/snack_bar.1.dart index 80b6720d8c..7668f55a89 100644 --- a/examples/api/lib/material/snack_bar/snack_bar.1.dart +++ b/examples/api/lib/material/snack_bar/snack_bar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SnackBar +/// Flutter code sample for [SnackBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/stepper/stepper.0.dart b/examples/api/lib/material/stepper/stepper.0.dart index c9935c87c4..add1a0be02 100644 --- a/examples/api/lib/material/stepper/stepper.0.dart +++ b/examples/api/lib/material/stepper/stepper.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Stepper +/// Flutter code sample for [Stepper]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/stepper/stepper.controls_builder.0.dart b/examples/api/lib/material/stepper/stepper.controls_builder.0.dart index 29b8a373c9..d370e72bff 100644 --- a/examples/api/lib/material/stepper/stepper.controls_builder.0.dart +++ b/examples/api/lib/material/stepper/stepper.controls_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Stepper.controlsBuilder +/// Flutter code sample for [Stepper.controlsBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/switch/switch.0.dart b/examples/api/lib/material/switch/switch.0.dart index a1b6e0e558..7a1bc5a1b6 100644 --- a/examples/api/lib/material/switch/switch.0.dart +++ b/examples/api/lib/material/switch/switch.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Switch +/// Flutter code sample for [Switch]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/switch/switch.1.dart b/examples/api/lib/material/switch/switch.1.dart index be9b8044d9..96dd5f0b28 100644 --- a/examples/api/lib/material/switch/switch.1.dart +++ b/examples/api/lib/material/switch/switch.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Switch +/// Flutter code sample for [Switch]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/switch_list_tile/switch_list_tile.0.dart b/examples/api/lib/material/switch_list_tile/switch_list_tile.0.dart index 36ded9664d..92a084c43b 100644 --- a/examples/api/lib/material/switch_list_tile/switch_list_tile.0.dart +++ b/examples/api/lib/material/switch_list_tile/switch_list_tile.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SwitchListTile +/// Flutter code sample for [SwitchListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/switch_list_tile/switch_list_tile.1.dart b/examples/api/lib/material/switch_list_tile/switch_list_tile.1.dart index 5a7ad01eed..30e5a9db28 100644 --- a/examples/api/lib/material/switch_list_tile/switch_list_tile.1.dart +++ b/examples/api/lib/material/switch_list_tile/switch_list_tile.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SwitchListTile +/// Flutter code sample for [SwitchListTile]. import 'package:flutter/gestures.dart'; diff --git a/examples/api/lib/material/switch_list_tile/switch_list_tile.2.dart b/examples/api/lib/material/switch_list_tile/switch_list_tile.2.dart index 4b67345c12..105d146049 100644 --- a/examples/api/lib/material/switch_list_tile/switch_list_tile.2.dart +++ b/examples/api/lib/material/switch_list_tile/switch_list_tile.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SwitchListTile +/// Flutter code sample for [SwitchListTile]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/tab_controller/tab_controller.1.dart b/examples/api/lib/material/tab_controller/tab_controller.1.dart index 2828af5c8b..15cddf479f 100644 --- a/examples/api/lib/material/tab_controller/tab_controller.1.dart +++ b/examples/api/lib/material/tab_controller/tab_controller.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for TabController +/// Flutter code sample for [TabController]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/tabs/tab_bar.0.dart b/examples/api/lib/material/tabs/tab_bar.0.dart index 91bb16e9f2..48e327153a 100644 --- a/examples/api/lib/material/tabs/tab_bar.0.dart +++ b/examples/api/lib/material/tabs/tab_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for TabBar +/// Flutter code sample for [TabBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/tabs/tab_bar.1.dart b/examples/api/lib/material/tabs/tab_bar.1.dart index bb58d66112..022f29bd10 100644 --- a/examples/api/lib/material/tabs/tab_bar.1.dart +++ b/examples/api/lib/material/tabs/tab_bar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for TabBar +/// Flutter code sample for [TabBar]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late TabController _tabController; diff --git a/examples/api/lib/material/text_button/text_button.0.dart b/examples/api/lib/material/text_button/text_button.0.dart index b59a1b0f17..1839848ea7 100644 --- a/examples/api/lib/material/text_button/text_button.0.dart +++ b/examples/api/lib/material/text_button/text_button.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for TextButton +/// Flutter code sample for [TextButton]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/text_button/text_button.1.dart b/examples/api/lib/material/text_button/text_button.1.dart index aa10c5a12a..0c85d65c55 100644 --- a/examples/api/lib/material/text_button/text_button.1.dart +++ b/examples/api/lib/material/text_button/text_button.1.dart @@ -2,6 +2,8 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. +/// Flutter code sample for [TextButton]. + import 'package:flutter/material.dart'; void main() { diff --git a/examples/api/lib/material/text_field/text_field.1.dart b/examples/api/lib/material/text_field/text_field.1.dart index a3651b6613..98f550c36c 100644 --- a/examples/api/lib/material/text_field/text_field.1.dart +++ b/examples/api/lib/material/text_field/text_field.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for TextField +/// Flutter code sample for [TextField]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/text_field/text_field.2.dart b/examples/api/lib/material/text_field/text_field.2.dart index b6a83d8871..585d2fa198 100644 --- a/examples/api/lib/material/text_field/text_field.2.dart +++ b/examples/api/lib/material/text_field/text_field.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Material Design 3 TextFields. +/// Flutter code sample for Material Design 3 [TextField]s. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/text_form_field/text_form_field.1.dart b/examples/api/lib/material/text_form_field/text_form_field.1.dart index 72002230af..65ac51d29e 100644 --- a/examples/api/lib/material/text_form_field/text_form_field.1.dart +++ b/examples/api/lib/material/text_form_field/text_form_field.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for TextFormField +/// Flutter code sample for [TextFormField]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; diff --git a/examples/api/lib/material/theme/theme_extension.1.dart b/examples/api/lib/material/theme/theme_extension.1.dart index 69f6923d3a..5b18656eb3 100644 --- a/examples/api/lib/material/theme/theme_extension.1.dart +++ b/examples/api/lib/material/theme/theme_extension.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ThemeExtension +/// Flutter code sample for [ThemeExtension]. import 'package:flutter/material.dart'; import 'package:flutter/scheduler.dart'; diff --git a/examples/api/lib/material/toggle_buttons/toggle_buttons.0.dart b/examples/api/lib/material/toggle_buttons/toggle_buttons.0.dart index c7ebf2c3db..28837c2392 100644 --- a/examples/api/lib/material/toggle_buttons/toggle_buttons.0.dart +++ b/examples/api/lib/material/toggle_buttons/toggle_buttons.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ToggleButtons +/// Flutter code sample for [ToggleButtons]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/tooltip/tooltip.0.dart b/examples/api/lib/material/tooltip/tooltip.0.dart index 046ec26eea..1d0539b550 100644 --- a/examples/api/lib/material/tooltip/tooltip.0.dart +++ b/examples/api/lib/material/tooltip/tooltip.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Tooltip +/// Flutter code sample for [Tooltip]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/tooltip/tooltip.1.dart b/examples/api/lib/material/tooltip/tooltip.1.dart index 429e79d5e5..466e8cfbe2 100644 --- a/examples/api/lib/material/tooltip/tooltip.1.dart +++ b/examples/api/lib/material/tooltip/tooltip.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Tooltip +/// Flutter code sample for [Tooltip]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/tooltip/tooltip.2.dart b/examples/api/lib/material/tooltip/tooltip.2.dart index bd8a360ce2..a0c860c537 100644 --- a/examples/api/lib/material/tooltip/tooltip.2.dart +++ b/examples/api/lib/material/tooltip/tooltip.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Tooltip +/// Flutter code sample for [Tooltip]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/material/tooltip/tooltip.3.dart b/examples/api/lib/material/tooltip/tooltip.3.dart index 01469c623c..9ceb7e9b11 100644 --- a/examples/api/lib/material/tooltip/tooltip.3.dart +++ b/examples/api/lib/material/tooltip/tooltip.3.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Tooltip +/// Flutter code sample for [Tooltip]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/painting/gradient/linear_gradient.0.dart b/examples/api/lib/painting/gradient/linear_gradient.0.dart index 94494f71c2..76de54e992 100644 --- a/examples/api/lib/painting/gradient/linear_gradient.0.dart +++ b/examples/api/lib/painting/gradient/linear_gradient.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for LinearGradient +/// Flutter code sample for [LinearGradient]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/rendering/sliver_grid/sliver_grid_delegate_with_fixed_cross_axis_count.0.dart b/examples/api/lib/rendering/sliver_grid/sliver_grid_delegate_with_fixed_cross_axis_count.0.dart index 05204e82a5..c857bbb23d 100644 --- a/examples/api/lib/rendering/sliver_grid/sliver_grid_delegate_with_fixed_cross_axis_count.0.dart +++ b/examples/api/lib/rendering/sliver_grid/sliver_grid_delegate_with_fixed_cross_axis_count.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverGridDelegateWithFixedCrossAxisCount +/// Flutter code sample for [SliverGridDelegateWithFixedCrossAxisCount]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/rendering/sliver_grid/sliver_grid_delegate_with_fixed_cross_axis_count.1.dart b/examples/api/lib/rendering/sliver_grid/sliver_grid_delegate_with_fixed_cross_axis_count.1.dart index 8b408fd339..1a734e129f 100644 --- a/examples/api/lib/rendering/sliver_grid/sliver_grid_delegate_with_fixed_cross_axis_count.1.dart +++ b/examples/api/lib/rendering/sliver_grid/sliver_grid_delegate_with_fixed_cross_axis_count.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverGridDelegateWithFixedCrossAxisCount +/// Flutter code sample for [SliverGridDelegateWithFixedCrossAxisCount]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/services/keyboard_key/logical_keyboard_key.0.dart b/examples/api/lib/services/keyboard_key/logical_keyboard_key.0.dart index 7f83e75134..298bb0c60e 100644 --- a/examples/api/lib/services/keyboard_key/logical_keyboard_key.0.dart +++ b/examples/api/lib/services/keyboard_key/logical_keyboard_key.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for LogicalKeyboardKey +/// Flutter code sample for [LogicalKeyboardKey]. import 'package:flutter/foundation.dart'; import 'package:flutter/material.dart'; diff --git a/examples/api/lib/services/keyboard_key/physical_keyboard_key.0.dart b/examples/api/lib/services/keyboard_key/physical_keyboard_key.0.dart index f5dc0d6199..a62aca155d 100644 --- a/examples/api/lib/services/keyboard_key/physical_keyboard_key.0.dart +++ b/examples/api/lib/services/keyboard_key/physical_keyboard_key.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PhysicalKeyboardKey +/// Flutter code sample for [PhysicalKeyboardKey]. import 'package:flutter/foundation.dart'; import 'package:flutter/material.dart'; diff --git a/examples/api/lib/services/mouse_cursor/mouse_cursor.0.dart b/examples/api/lib/services/mouse_cursor/mouse_cursor.0.dart index 152da48de3..099c0b7dbe 100644 --- a/examples/api/lib/services/mouse_cursor/mouse_cursor.0.dart +++ b/examples/api/lib/services/mouse_cursor/mouse_cursor.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MouseCursor +/// Flutter code sample for [MouseCursor]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/services/system_chrome/system_chrome.set_system_u_i_overlay_style.1.dart b/examples/api/lib/services/system_chrome/system_chrome.set_system_u_i_overlay_style.1.dart index 0d5172d331..86a00a2837 100644 --- a/examples/api/lib/services/system_chrome/system_chrome.set_system_u_i_overlay_style.1.dart +++ b/examples/api/lib/services/system_chrome/system_chrome.set_system_u_i_overlay_style.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SystemChrome.setSystemUIOverlayStyle +/// Flutter code sample for [SystemChrome.setSystemUIOverlayStyle]. import 'dart:math' as math; diff --git a/examples/api/lib/ui/text/font_feature.0.dart b/examples/api/lib/ui/text/font_feature.0.dart index fe887d1cf5..fd07be4ebb 100644 --- a/examples/api/lib/ui/text/font_feature.0.dart +++ b/examples/api/lib/ui/text/font_feature.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature +/// Flutter code sample for [FontFeature]. import 'dart:ui'; import 'package:flutter/material.dart'; @@ -31,8 +31,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Cardo, Milonga and Raleway Dots fonts can be downloaded from - // Google Fonts (https://www.google.com/fonts). + // The Cardo, Milonga and Raleway Dots fonts can be downloaded from Google + // Fonts (https://www.google.com/fonts). return Scaffold( body: Center( child: Column( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_alternative.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_alternative.0.dart index 205eb5e191..e513306eec 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_alternative.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_alternative.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.alternative +/// Flutter code sample for [FontFeature.FontFeature.alternative]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Raleway font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Raleway font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'The infamous Tuna Torture.', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_alternative_fractions.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_alternative_fractions.0.dart index 0fb42bfbdd..b315dc7bce 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_alternative_fractions.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_alternative_fractions.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.alternativeFractions +/// Flutter code sample for [FontFeature.FontFeature.alternativeFractions]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Ubuntu Mono font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Ubuntu Mono font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Fractions: 1/2 2/3 3/4 4/5', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_case_sensitive_forms.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_case_sensitive_forms.0.dart index aba960b76e..ebad9c338f 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_case_sensitive_forms.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_case_sensitive_forms.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.caseSensitiveForms +/// Flutter code sample for [FontFeature.FontFeature.caseSensitiveForms]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( '(A) [A] {A} «A» A/B A•B', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_character_variant.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_character_variant.0.dart index 0eebf1c4e7..eef33af5a2 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_character_variant.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_character_variant.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.characterVariant +/// Flutter code sample for [FontFeature.FontFeature.characterVariant]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Source Code Pro font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Source Code Pro font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return Text( 'aáâ β gǵĝ θб Iiíî Ll', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_contextual_alternates.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_contextual_alternates.0.dart index 860761a110..74df7b8c88 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_contextual_alternates.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_contextual_alternates.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.contextualAlternates +/// Flutter code sample for [FontFeature.FontFeature.contextualAlternates]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Barriecito font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Barriecito font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( "Ooohh, we weren't going to tell him that.", style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_denominator.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_denominator.0.dart index e1f140520b..d07080e4ca 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_denominator.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_denominator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.denominator +/// Flutter code sample for [FontFeature.FontFeature.denominator]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Fractions: 1/2 2/3 3/4 4/5', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_fractions.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_fractions.0.dart index 6ff71ceacd..2cea9f15e9 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_fractions.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_fractions.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.fractions +/// Flutter code sample for [FontFeature.FontFeature.fractions]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Ubuntu Mono font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Ubuntu Mono font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Fractions: 1/2 2/3 3/4 4/5', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_historical_forms.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_historical_forms.0.dart index a3bc360872..59fcf0dfe2 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_historical_forms.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_historical_forms.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.historicalForms +/// Flutter code sample for [FontFeature.FontFeature.historicalForms]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Cardo font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Cardo font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'VIBRANT fish assisted his business.', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_historical_ligatures.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_historical_ligatures.0.dart index bf1a862095..50a9a8176a 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_historical_ligatures.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_historical_ligatures.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.historicalLigatures +/// Flutter code sample for [FontFeature.FontFeature.historicalLigatures]. import 'dart:ui'; @@ -27,7 +27,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Cardo font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Cardo font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'VIBRANT fish assisted his business.', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_lining_figures.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_lining_figures.0.dart index dd59c02507..19a4fd94e7 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_lining_figures.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_lining_figures.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.liningFigures +/// Flutter code sample for [FontFeature.FontFeature.liningFigures]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Sorts Mill Goudy font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Sorts Mill Goudy font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'CALL 311-555-2368 NOW!', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_locale_aware.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_locale_aware.0.dart index 03ac698244..e0a6bad400 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_locale_aware.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_locale_aware.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.localeAware +/// Flutter code sample for [FontFeature.FontFeature.localeAware]. import 'package:flutter/widgets.dart'; @@ -25,7 +25,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Noto family of fonts can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Noto family of fonts can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( '次 化 刃 直 入 令', locale: Locale('zh', 'CN'), // or Locale('ja'), Locale('ko'), Locale('zh', 'TW'), etc diff --git a/examples/api/lib/ui/text/font_feature.font_feature_notational_forms.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_notational_forms.0.dart index 3563236ff9..30ceb9c4d7 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_notational_forms.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_notational_forms.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.notationalForms +/// Flutter code sample for [FontFeature.FontFeature.notationalForms]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Gothic A1 font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Gothic A1 font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'abc 123', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_numerators.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_numerators.0.dart index d15974baeb..40794cbe38 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_numerators.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_numerators.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.numerators +/// Flutter code sample for [FontFeature.FontFeature.numerators]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -27,7 +27,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Fractions: 1/2 2/3 3/4 4/5', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_oldstyle_figures.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_oldstyle_figures.0.dart index 435d6fe630..30a635c6ca 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_oldstyle_figures.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_oldstyle_figures.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.oldstyleFigures +/// Flutter code sample for [FontFeature.FontFeature.oldstyleFigures]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Call 311-555-2368 now!', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_ordinal_forms.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_ordinal_forms.0.dart index df78fc3669..0cfa435847 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_ordinal_forms.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_ordinal_forms.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.ordinalForms +/// Flutter code sample for [FontFeature.FontFeature.ordinalForms]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( '1st, 2nd, 3rd, 4th...', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_proportional_figures.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_proportional_figures.0.dart index 894e5143e3..82e0c1e357 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_proportional_figures.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_proportional_figures.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.proportionalFigures +/// Flutter code sample for [FontFeature.FontFeature.proportionalFigures]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Kufam font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Kufam font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Call 311-555-2368 now!', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_scientific_inferiors.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_scientific_inferiors.0.dart index 2bb2f52769..7645254162 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_scientific_inferiors.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_scientific_inferiors.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.scientificInferiors +/// Flutter code sample for [FontFeature.FontFeature.scientificInferiors]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'C8H10N4O2', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_slashed_zero.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_slashed_zero.0.dart index c244d82c69..90ab9f6fe1 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_slashed_zero.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_slashed_zero.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.slashedZero +/// Flutter code sample for [FontFeature.FontFeature.slashedZero]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Source Code Pro font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Source Code Pro font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'One million is: 1,000,000.00', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_stylistic_alternates.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_stylistic_alternates.0.dart index 181481907f..2853ad0a1c 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_stylistic_alternates.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_stylistic_alternates.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.stylisticAlternates +/// Flutter code sample for [FontFeature.FontFeature.stylisticAlternates]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Source Code Pro font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Source Code Pro font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( r'Agile Game - $100 initial bet', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_stylistic_set.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_stylistic_set.0.dart index 1d81dd3a38..65bb623f85 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_stylistic_set.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_stylistic_set.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.stylisticSet +/// Flutter code sample for [FontFeature.FontFeature.stylisticSet]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Source Code Pro font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Source Code Pro font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return Text( 'aáâ β gǵĝ θб Iiíî Ll', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_stylistic_set.1.dart b/examples/api/lib/ui/text/font_feature.font_feature_stylistic_set.1.dart index 6f427b6ade..bfeb969e28 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_stylistic_set.1.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_stylistic_set.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.stylisticSet +/// Flutter code sample for [FontFeature.FontFeature.stylisticSet]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return Text( '-> MCMXCVII <-', // 1997 style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_subscripts.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_subscripts.0.dart index 2ebeabc341..98516bd385 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_subscripts.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_subscripts.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.subscripts +/// Flutter code sample for [FontFeature.FontFeature.subscripts]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Line from x1,y1 to x2,y2', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_superscripts.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_superscripts.0.dart index 9f64745c5e..3fefddc66f 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_superscripts.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_superscripts.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.superscripts +/// Flutter code sample for [FontFeature.FontFeature.superscripts]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Sorts Mill Goudy font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Sorts Mill Goudy font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'The isotope 238U decays to 206Pb', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_swash.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_swash.0.dart index eca24ec7b8..fc49516768 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_swash.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_swash.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FontFeature.FontFeature.swash +/// Flutter code sample for [FontFeature.FontFeature.swash]. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The BioRhyme Expanded font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The BioRhyme Expanded font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Queer & Romantic', style: TextStyle( diff --git a/examples/api/lib/ui/text/font_feature.font_feature_tabular_figures.0.dart b/examples/api/lib/ui/text/font_feature.font_feature_tabular_figures.0.dart index e2b09fb29b..e2076424b7 100644 --- a/examples/api/lib/ui/text/font_feature.font_feature_tabular_figures.0.dart +++ b/examples/api/lib/ui/text/font_feature.font_feature_tabular_figures.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for dart:ui FontFeature.FontFeature.tabularFigures +/// Flutter code sample for [dart]:ui FontFeature.FontFeature.tabularFigures. import 'dart:ui'; import 'package:flutter/widgets.dart'; @@ -26,7 +26,8 @@ class ExampleWidget extends StatelessWidget { @override Widget build(BuildContext context) { - // The Piazzolla font can be downloaded from Google Fonts (https://www.google.com/fonts). + // The Piazzolla font can be downloaded from Google Fonts + // (https://www.google.com/fonts). return const Text( 'Call 311-555-2368 now!', style: TextStyle( diff --git a/examples/api/lib/widgets/actions/action.action_overridable.0.dart b/examples/api/lib/widgets/actions/action.action_overridable.0.dart index b88b163e43..33d97e64ce 100644 --- a/examples/api/lib/widgets/actions/action.action_overridable.0.dart +++ b/examples/api/lib/widgets/actions/action.action_overridable.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Action.Action.overridable +/// Flutter code sample for [Action.Action.overridable]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; @@ -36,8 +36,8 @@ class CopyableText extends StatelessWidget { shortcuts: const { SingleActivator(LogicalKeyboardKey.keyC, control: true) : copyTextIntent }, child: Actions( actions: > { - /// The Action is made overridable so the VerificationCodeGenerator - /// widget can override how copying is handled. + // The Action is made overridable so the VerificationCodeGenerator + // widget can override how copying is handled. CopyTextIntent: Action.overridable(defaultAction: defaultCopyAction, context: context), }, child: Focus( diff --git a/examples/api/lib/widgets/actions/action_listener.0.dart b/examples/api/lib/widgets/actions/action_listener.0.dart index 7e146534da..4c9bc958ac 100644 --- a/examples/api/lib/widgets/actions/action_listener.0.dart +++ b/examples/api/lib/widgets/actions/action_listener.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ActionListener +/// Flutter code sample for [ActionListener]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/actions/actions.0.dart b/examples/api/lib/widgets/actions/actions.0.dart index 080ec03324..7f230c59a8 100644 --- a/examples/api/lib/widgets/actions/actions.0.dart +++ b/examples/api/lib/widgets/actions/actions.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Actions +/// Flutter code sample for [Actions]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/actions/focusable_action_detector.0.dart b/examples/api/lib/widgets/actions/focusable_action_detector.0.dart index 12bc1f5e0c..85006424c3 100644 --- a/examples/api/lib/widgets/actions/focusable_action_detector.0.dart +++ b/examples/api/lib/widgets/actions/focusable_action_detector.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FocusableActionDetector +/// Flutter code sample for [FocusableActionDetector]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; diff --git a/examples/api/lib/widgets/animated_list/animated_list.0.dart b/examples/api/lib/widgets/animated_list/animated_list.0.dart index b6ca9ad40e..f58e5305e2 100644 --- a/examples/api/lib/widgets/animated_list/animated_list.0.dart +++ b/examples/api/lib/widgets/animated_list/animated_list.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedList +/// Flutter code sample for [AnimatedList]. import 'package:flutter/material.dart'; @@ -50,11 +50,10 @@ class _AnimatedListSampleState extends State { ); } - // Used to build an item after it has been removed from the list. This - // method is needed because a removed item remains visible until its - // animation has completed (even though it's gone as far this ListModel is - // concerned). The widget will be used by the - // [AnimatedListState.removeItem] method's + // Used to build an item after it has been removed from the list. This method + // is needed because a removed item remains visible until its animation has + // completed (even though it's gone as far as this ListModel is concerned). + // The widget will be used by the [AnimatedListState.removeItem] method's // [AnimatedListRemovedItemBuilder] parameter. Widget _buildRemovedItem( int item, BuildContext context, Animation animation) { diff --git a/examples/api/lib/widgets/animated_list/sliver_animated_list.0.dart b/examples/api/lib/widgets/animated_list/sliver_animated_list.0.dart index 9ccf020dbc..cf463f78ce 100644 --- a/examples/api/lib/widgets/animated_list/sliver_animated_list.0.dart +++ b/examples/api/lib/widgets/animated_list/sliver_animated_list.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverAnimatedList +/// Flutter code sample for [SliverAnimatedList]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/animated_size/animated_size.0.dart b/examples/api/lib/widgets/animated_size/animated_size.0.dart index 7847952caf..6aba8a2af7 100644 --- a/examples/api/lib/widgets/animated_size/animated_size.0.dart +++ b/examples/api/lib/widgets/animated_size/animated_size.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedSize +/// Flutter code sample for [AnimatedSize]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/animated_switcher/animated_switcher.0.dart b/examples/api/lib/widgets/animated_switcher/animated_switcher.0.dart index 7f563c88a1..b10abcb4d9 100644 --- a/examples/api/lib/widgets/animated_switcher/animated_switcher.0.dart +++ b/examples/api/lib/widgets/animated_switcher/animated_switcher.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedSwitcher +/// Flutter code sample for [AnimatedSwitcher]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/app/widgets_app.widgets_app.0.dart b/examples/api/lib/widgets/app/widgets_app.widgets_app.0.dart index ea04dd6a85..5510dbd3e5 100644 --- a/examples/api/lib/widgets/app/widgets_app.widgets_app.0.dart +++ b/examples/api/lib/widgets/app/widgets_app.widgets_app.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for WidgetsApp +/// Flutter code sample for [WidgetsApp]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/async/future_builder.0.dart b/examples/api/lib/widgets/async/future_builder.0.dart index 8c5c1d08ba..84505669a2 100644 --- a/examples/api/lib/widgets/async/future_builder.0.dart +++ b/examples/api/lib/widgets/async/future_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FutureBuilder +/// Flutter code sample for [FutureBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/async/stream_builder.0.dart b/examples/api/lib/widgets/async/stream_builder.0.dart index 6d1a63262e..f2bc8e6c8c 100644 --- a/examples/api/lib/widgets/async/stream_builder.0.dart +++ b/examples/api/lib/widgets/async/stream_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for StreamBuilder +/// Flutter code sample for [StreamBuilder]. import 'dart:async'; diff --git a/examples/api/lib/widgets/autocomplete/raw_autocomplete.0.dart b/examples/api/lib/widgets/autocomplete/raw_autocomplete.0.dart index 03319abea7..2e99b5e3a0 100644 --- a/examples/api/lib/widgets/autocomplete/raw_autocomplete.0.dart +++ b/examples/api/lib/widgets/autocomplete/raw_autocomplete.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RawAutocomplete +/// Flutter code sample for [RawAutocomplete]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/autocomplete/raw_autocomplete.1.dart b/examples/api/lib/widgets/autocomplete/raw_autocomplete.1.dart index 7cb3ff9a20..4fe8559fed 100644 --- a/examples/api/lib/widgets/autocomplete/raw_autocomplete.1.dart +++ b/examples/api/lib/widgets/autocomplete/raw_autocomplete.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RawAutocomplete +/// Flutter code sample for [RawAutocomplete]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/autocomplete/raw_autocomplete.2.dart b/examples/api/lib/widgets/autocomplete/raw_autocomplete.2.dart index cb39ac9440..c19e791b2f 100644 --- a/examples/api/lib/widgets/autocomplete/raw_autocomplete.2.dart +++ b/examples/api/lib/widgets/autocomplete/raw_autocomplete.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RawAutocomplete +/// Flutter code sample for [RawAutocomplete]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/autocomplete/raw_autocomplete.focus_node.0.dart b/examples/api/lib/widgets/autocomplete/raw_autocomplete.focus_node.0.dart index 0f11883052..d64892e858 100644 --- a/examples/api/lib/widgets/autocomplete/raw_autocomplete.focus_node.0.dart +++ b/examples/api/lib/widgets/autocomplete/raw_autocomplete.focus_node.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RawAutocomplete.focusNode +/// Flutter code sample for [RawAutocomplete.focusNode]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/autofill/autofill_group.0.dart b/examples/api/lib/widgets/autofill/autofill_group.0.dart index 4a2a6b12b9..5d06645d7a 100644 --- a/examples/api/lib/widgets/autofill/autofill_group.0.dart +++ b/examples/api/lib/widgets/autofill/autofill_group.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AutofillGroup +/// Flutter code sample for [AutofillGroup]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/absorb_pointer.0.dart b/examples/api/lib/widgets/basic/absorb_pointer.0.dart index 03e6fb8553..a5d6667576 100644 --- a/examples/api/lib/widgets/basic/absorb_pointer.0.dart +++ b/examples/api/lib/widgets/basic/absorb_pointer.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AbsorbPointer +/// Flutter code sample for [AbsorbPointer]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/aspect_ratio.0.dart b/examples/api/lib/widgets/basic/aspect_ratio.0.dart index 9bc097b986..fee8351f99 100644 --- a/examples/api/lib/widgets/basic/aspect_ratio.0.dart +++ b/examples/api/lib/widgets/basic/aspect_ratio.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AspectRatio +/// Flutter code sample for [AspectRatio]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/aspect_ratio.1.dart b/examples/api/lib/widgets/basic/aspect_ratio.1.dart index 573fef67a6..fda6866d35 100644 --- a/examples/api/lib/widgets/basic/aspect_ratio.1.dart +++ b/examples/api/lib/widgets/basic/aspect_ratio.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AspectRatio +/// Flutter code sample for [AspectRatio]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/aspect_ratio.2.dart b/examples/api/lib/widgets/basic/aspect_ratio.2.dart index 9ed966c0c2..f1d2d4ee31 100644 --- a/examples/api/lib/widgets/basic/aspect_ratio.2.dart +++ b/examples/api/lib/widgets/basic/aspect_ratio.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AspectRatio +/// Flutter code sample for [AspectRatio]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/clip_rrect.0.dart b/examples/api/lib/widgets/basic/clip_rrect.0.dart index caf3e9bd54..761fd90b04 100644 --- a/examples/api/lib/widgets/basic/clip_rrect.0.dart +++ b/examples/api/lib/widgets/basic/clip_rrect.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ClipRRect +/// Flutter code sample for [ClipRRect]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/clip_rrect.1.dart b/examples/api/lib/widgets/basic/clip_rrect.1.dart index 7bd19ace71..3f84ba23c8 100644 --- a/examples/api/lib/widgets/basic/clip_rrect.1.dart +++ b/examples/api/lib/widgets/basic/clip_rrect.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ClipRRect +/// Flutter code sample for [ClipRRect]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/custom_multi_child_layout.0.dart b/examples/api/lib/widgets/basic/custom_multi_child_layout.0.dart index b4e5c64b6f..e8af705a8e 100644 --- a/examples/api/lib/widgets/basic/custom_multi_child_layout.0.dart +++ b/examples/api/lib/widgets/basic/custom_multi_child_layout.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CustomMultiChildLayout +/// Flutter code sample for [CustomMultiChildLayout]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/expanded.0.dart b/examples/api/lib/widgets/basic/expanded.0.dart index 0ab21baea0..1deb25b440 100644 --- a/examples/api/lib/widgets/basic/expanded.0.dart +++ b/examples/api/lib/widgets/basic/expanded.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Expanded +/// Flutter code sample for [Expanded]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/expanded.1.dart b/examples/api/lib/widgets/basic/expanded.1.dart index ead35a90ff..b14cca384d 100644 --- a/examples/api/lib/widgets/basic/expanded.1.dart +++ b/examples/api/lib/widgets/basic/expanded.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Expanded +/// Flutter code sample for [Expanded]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/fitted_box.0.dart b/examples/api/lib/widgets/basic/fitted_box.0.dart index 0c74fd207c..4347d9c034 100644 --- a/examples/api/lib/widgets/basic/fitted_box.0.dart +++ b/examples/api/lib/widgets/basic/fitted_box.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FittedBox +/// Flutter code sample for [FittedBox]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/flow.0.dart b/examples/api/lib/widgets/basic/flow.0.dart index 01e2c264c0..5e67056d79 100644 --- a/examples/api/lib/widgets/basic/flow.0.dart +++ b/examples/api/lib/widgets/basic/flow.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Flow +/// Flutter code sample for [Flow]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/fractionally_sized_box.0.dart b/examples/api/lib/widgets/basic/fractionally_sized_box.0.dart index b345dbb2f5..3091079454 100644 --- a/examples/api/lib/widgets/basic/fractionally_sized_box.0.dart +++ b/examples/api/lib/widgets/basic/fractionally_sized_box.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FractionallySizedBox +/// Flutter code sample for [FractionallySizedBox]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/ignore_pointer.0.dart b/examples/api/lib/widgets/basic/ignore_pointer.0.dart index 3d446b880e..931f3df63a 100644 --- a/examples/api/lib/widgets/basic/ignore_pointer.0.dart +++ b/examples/api/lib/widgets/basic/ignore_pointer.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for IgnorePointer +/// Flutter code sample for [IgnorePointer]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/indexed_stack.0.dart b/examples/api/lib/widgets/basic/indexed_stack.0.dart index feb260a1e5..b5dc76d0af 100644 --- a/examples/api/lib/widgets/basic/indexed_stack.0.dart +++ b/examples/api/lib/widgets/basic/indexed_stack.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for IndexedStack. +/// Flutter code sample for [IndexedStack.]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/listener.0.dart b/examples/api/lib/widgets/basic/listener.0.dart index 2a3a76e4c9..b0f6236f47 100644 --- a/examples/api/lib/widgets/basic/listener.0.dart +++ b/examples/api/lib/widgets/basic/listener.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Listener +/// Flutter code sample for [Listener]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/mouse_region.0.dart b/examples/api/lib/widgets/basic/mouse_region.0.dart index 7fd154985f..8402bb48d8 100644 --- a/examples/api/lib/widgets/basic/mouse_region.0.dart +++ b/examples/api/lib/widgets/basic/mouse_region.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MouseRegion +/// Flutter code sample for [MouseRegion]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/mouse_region.on_exit.0.dart b/examples/api/lib/widgets/basic/mouse_region.on_exit.0.dart index 932b03de95..d539f59c6a 100644 --- a/examples/api/lib/widgets/basic/mouse_region.on_exit.0.dart +++ b/examples/api/lib/widgets/basic/mouse_region.on_exit.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MouseRegion.onExit +/// Flutter code sample for [MouseRegion.onExit]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/mouse_region.on_exit.1.dart b/examples/api/lib/widgets/basic/mouse_region.on_exit.1.dart index 39d2fa10c1..9f7002a7e7 100644 --- a/examples/api/lib/widgets/basic/mouse_region.on_exit.1.dart +++ b/examples/api/lib/widgets/basic/mouse_region.on_exit.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MouseRegion.onExit +/// Flutter code sample for [MouseRegion.onExit]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/offstage.0.dart b/examples/api/lib/widgets/basic/offstage.0.dart index 8cbff0ada0..5d07668dab 100644 --- a/examples/api/lib/widgets/basic/offstage.0.dart +++ b/examples/api/lib/widgets/basic/offstage.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Offstage +/// Flutter code sample for [Offstage]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/basic/physical_shape.0.dart b/examples/api/lib/widgets/basic/physical_shape.0.dart index 1c44cb54f4..d019410fd4 100644 --- a/examples/api/lib/widgets/basic/physical_shape.0.dart +++ b/examples/api/lib/widgets/basic/physical_shape.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PhysicalShape +/// Flutter code sample for [PhysicalShape]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/binding/widget_binding_observer.0.dart b/examples/api/lib/widgets/binding/widget_binding_observer.0.dart index 8c3de53230..dc6224aea1 100644 --- a/examples/api/lib/widgets/binding/widget_binding_observer.0.dart +++ b/examples/api/lib/widgets/binding/widget_binding_observer.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for WidgetBindingsObserver +/// Flutter code sample for [WidgetBindingsObserver]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/color_filter/color_filtered.0.dart b/examples/api/lib/widgets/color_filter/color_filtered.0.dart index 8c59094634..283503a04f 100644 --- a/examples/api/lib/widgets/color_filter/color_filtered.0.dart +++ b/examples/api/lib/widgets/color_filter/color_filtered.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ColorFiltered +/// Flutter code sample for [ColorFiltered]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/dismissible/dismissible.0.dart b/examples/api/lib/widgets/dismissible/dismissible.0.dart index 0a3dbe82ec..d528e0b6d9 100644 --- a/examples/api/lib/widgets/dismissible/dismissible.0.dart +++ b/examples/api/lib/widgets/dismissible/dismissible.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Dismissible +/// Flutter code sample for [Dismissible]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/drag_target/draggable.0.dart b/examples/api/lib/widgets/drag_target/draggable.0.dart index fff0c9aaf1..5ee6c89eb5 100644 --- a/examples/api/lib/widgets/drag_target/draggable.0.dart +++ b/examples/api/lib/widgets/drag_target/draggable.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Draggable +/// Flutter code sample for [Draggable]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/editable_text/editable_text.on_changed.0.dart b/examples/api/lib/widgets/editable_text/editable_text.on_changed.0.dart index f964ffe480..cb4162647b 100644 --- a/examples/api/lib/widgets/editable_text/editable_text.on_changed.0.dart +++ b/examples/api/lib/widgets/editable_text/editable_text.on_changed.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for EditableText.onChanged +/// Flutter code sample for [EditableText.onChanged]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/editable_text/text_editing_controller.0.dart b/examples/api/lib/widgets/editable_text/text_editing_controller.0.dart index af58991ef8..5e35da4989 100644 --- a/examples/api/lib/widgets/editable_text/text_editing_controller.0.dart +++ b/examples/api/lib/widgets/editable_text/text_editing_controller.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for TextEditingController +/// Flutter code sample for [TextEditingController]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/focus_manager/focus_node.0.dart b/examples/api/lib/widgets/focus_manager/focus_node.0.dart index 699846cad9..2374de596f 100644 --- a/examples/api/lib/widgets/focus_manager/focus_node.0.dart +++ b/examples/api/lib/widgets/focus_manager/focus_node.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FocusNode +/// Flutter code sample for [FocusNode]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; diff --git a/examples/api/lib/widgets/focus_manager/focus_node.unfocus.0.dart b/examples/api/lib/widgets/focus_manager/focus_node.unfocus.0.dart index 294edaf17e..3278812cbb 100644 --- a/examples/api/lib/widgets/focus_manager/focus_node.unfocus.0.dart +++ b/examples/api/lib/widgets/focus_manager/focus_node.unfocus.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FocusNode.unfocus +/// Flutter code sample for [FocusNode.unfocus]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/focus_scope/focus.0.dart b/examples/api/lib/widgets/focus_scope/focus.0.dart index 9ddba1ffec..25d85ae28f 100644 --- a/examples/api/lib/widgets/focus_scope/focus.0.dart +++ b/examples/api/lib/widgets/focus_scope/focus.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Focus +/// Flutter code sample for [Focus]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; diff --git a/examples/api/lib/widgets/focus_scope/focus.1.dart b/examples/api/lib/widgets/focus_scope/focus.1.dart index 7f48b6422c..e9f08fcf5c 100644 --- a/examples/api/lib/widgets/focus_scope/focus.1.dart +++ b/examples/api/lib/widgets/focus_scope/focus.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Focus +/// Flutter code sample for [Focus]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/focus_scope/focus.2.dart b/examples/api/lib/widgets/focus_scope/focus.2.dart index 402d748eeb..fbc10caa50 100644 --- a/examples/api/lib/widgets/focus_scope/focus.2.dart +++ b/examples/api/lib/widgets/focus_scope/focus.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Focus +/// Flutter code sample for [Focus]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/focus_scope/focus_scope.0.dart b/examples/api/lib/widgets/focus_scope/focus_scope.0.dart index 48fe6dcc8d..63bf46a15c 100644 --- a/examples/api/lib/widgets/focus_scope/focus_scope.0.dart +++ b/examples/api/lib/widgets/focus_scope/focus_scope.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FocusScope +/// Flutter code sample for [FocusScope]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/focus_traversal/focus_traversal_group.0.dart b/examples/api/lib/widgets/focus_traversal/focus_traversal_group.0.dart index 12f8de884e..c06cddd97c 100644 --- a/examples/api/lib/widgets/focus_traversal/focus_traversal_group.0.dart +++ b/examples/api/lib/widgets/focus_traversal/focus_traversal_group.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FocusTraversalGroup +/// Flutter code sample for [FocusTraversalGroup]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/focus_traversal/ordered_traversal_policy.0.dart b/examples/api/lib/widgets/focus_traversal/ordered_traversal_policy.0.dart index e88487dce0..c4f8b1bdc0 100644 --- a/examples/api/lib/widgets/focus_traversal/ordered_traversal_policy.0.dart +++ b/examples/api/lib/widgets/focus_traversal/ordered_traversal_policy.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for OrderedTraversalPolicy +/// Flutter code sample for [OrderedTraversalPolicy]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/form/form.0.dart b/examples/api/lib/widgets/form/form.0.dart index 2a27dd3b01..428b497335 100644 --- a/examples/api/lib/widgets/form/form.0.dart +++ b/examples/api/lib/widgets/form/form.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Form +/// Flutter code sample for [Form]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/framework/build_owner.0.dart b/examples/api/lib/widgets/framework/build_owner.0.dart index 180c6fd756..b3f28e8eba 100644 --- a/examples/api/lib/widgets/framework/build_owner.0.dart +++ b/examples/api/lib/widgets/framework/build_owner.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for BuildOwner +/// Flutter code sample for [BuildOwner]. import 'package:flutter/material.dart'; import 'package:flutter/rendering.dart'; diff --git a/examples/api/lib/widgets/framework/error_widget.0.dart b/examples/api/lib/widgets/framework/error_widget.0.dart index f3a212c4e3..0863b5f2d2 100644 --- a/examples/api/lib/widgets/framework/error_widget.0.dart +++ b/examples/api/lib/widgets/framework/error_widget.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ErrorWidget +/// Flutter code sample for [ErrorWidget]. import 'package:flutter/foundation.dart'; import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/gesture_detector/gesture_detector.0.dart b/examples/api/lib/widgets/gesture_detector/gesture_detector.0.dart index 58756ba395..b72e034d1a 100644 --- a/examples/api/lib/widgets/gesture_detector/gesture_detector.0.dart +++ b/examples/api/lib/widgets/gesture_detector/gesture_detector.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for GestureDetector +/// Flutter code sample for [GestureDetector]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/gesture_detector/gesture_detector.1.dart b/examples/api/lib/widgets/gesture_detector/gesture_detector.1.dart index c57dbe2986..4771f527c7 100644 --- a/examples/api/lib/widgets/gesture_detector/gesture_detector.1.dart +++ b/examples/api/lib/widgets/gesture_detector/gesture_detector.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for GestureDetector +/// Flutter code sample for [GestureDetector]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/gesture_detector/gesture_detector.2.dart b/examples/api/lib/widgets/gesture_detector/gesture_detector.2.dart index 130af66f83..8be9043ff9 100644 --- a/examples/api/lib/widgets/gesture_detector/gesture_detector.2.dart +++ b/examples/api/lib/widgets/gesture_detector/gesture_detector.2.dart @@ -2,6 +2,8 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. +/// Flutter code sample for [GestureDetector]. + import 'package:flutter/gestures.dart'; import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/hardware_keyboard/key_event_manager.0.dart b/examples/api/lib/widgets/hardware_keyboard/key_event_manager.0.dart index e3c0ab6ba3..e54a7e5671 100644 --- a/examples/api/lib/widgets/hardware_keyboard/key_event_manager.0.dart +++ b/examples/api/lib/widgets/hardware_keyboard/key_event_manager.0.dart @@ -2,13 +2,11 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. +/// Flutter code sample for [KeyEventManager.keyMessageHandler]. + import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; -// This example app demonstrates a use case of patching -// `KeyEventManager.keyMessageHandler`: be notified of key events that are not -// handled by any focus handlers (such as shortcuts). - void main() => runApp( const MaterialApp( home: Scaffold( @@ -53,8 +51,8 @@ class FallbackDemoState extends State { constraints: const BoxConstraints(maxWidth: 500, maxHeight: 400), child: Column( children: [ - const Text('This area handles key pressses that are unhandled by any shortcuts by displaying them below. ' - 'Try text shortcuts such as Ctrl-A!'), + const Text('This area handles key presses that are unhandled by any shortcuts, by ' + 'displaying them below. Try text shortcuts such as Ctrl-A!'), Text(_capture == null ? '' : '$_capture is not handled by shortcuts.'), const TextField(decoration: InputDecoration(label: Text('Text field 1'))), Shortcuts( @@ -62,7 +60,9 @@ class FallbackDemoState extends State { const SingleActivator(LogicalKeyboardKey.keyQ): VoidCallbackIntent(() {}), }, child: const TextField( - decoration: InputDecoration(label: Text('This field also considers key Q as a shortcut (that does nothing).')), + decoration: InputDecoration( + label: Text('This field also considers key Q as a shortcut (that does nothing).'), + ), ), ), ], @@ -75,7 +75,7 @@ class FallbackDemoState extends State { /// A node used by [FallbackKeyEventRegistrar] to register fallback key handlers. /// /// This class must not be replaced by bare [KeyEventCallback] because Dart -/// does not allow comparing with `==` on annonymous functions (always returns +/// does not allow comparing with `==` on anonymous functions (always returns /// false.) class FallbackFocusNode { FallbackFocusNode({required this.onKeyEvent}); diff --git a/examples/api/lib/widgets/heroes/hero.0.dart b/examples/api/lib/widgets/heroes/hero.0.dart index 28811f7a19..8741ea3bde 100644 --- a/examples/api/lib/widgets/heroes/hero.0.dart +++ b/examples/api/lib/widgets/heroes/hero.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Hero +/// Flutter code sample for [Hero]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/heroes/hero.1.dart b/examples/api/lib/widgets/heroes/hero.1.dart index b06846cf72..7ced9d71bb 100644 --- a/examples/api/lib/widgets/heroes/hero.1.dart +++ b/examples/api/lib/widgets/heroes/hero.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Hero +/// Flutter code sample for [Hero]. import 'package:flutter/material.dart'; import 'package:flutter/scheduler.dart'; diff --git a/examples/api/lib/widgets/image/image.error_builder.0.dart b/examples/api/lib/widgets/image/image.error_builder.0.dart index 86f2ea18ed..9c9ca1eeed 100644 --- a/examples/api/lib/widgets/image/image.error_builder.0.dart +++ b/examples/api/lib/widgets/image/image.error_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Image.errorBuilder +/// Flutter code sample for [Image.errorBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/image/image.frame_builder.0.dart b/examples/api/lib/widgets/image/image.frame_builder.0.dart index 5af238b95e..e90447bae1 100644 --- a/examples/api/lib/widgets/image/image.frame_builder.0.dart +++ b/examples/api/lib/widgets/image/image.frame_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Image.frameBuilder +/// Flutter code sample for [Image.frameBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/image/image.loading_builder.0.dart b/examples/api/lib/widgets/image/image.loading_builder.0.dart index a1f97edce0..5127cce2e9 100644 --- a/examples/api/lib/widgets/image/image.loading_builder.0.dart +++ b/examples/api/lib/widgets/image/image.loading_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Image.loadingBuilder +/// Flutter code sample for [Image.loadingBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/implicit_animations/animated_align.0.dart b/examples/api/lib/widgets/implicit_animations/animated_align.0.dart index 07806ec75c..aae7428a91 100644 --- a/examples/api/lib/widgets/implicit_animations/animated_align.0.dart +++ b/examples/api/lib/widgets/implicit_animations/animated_align.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedAlign +/// Flutter code sample for [AnimatedAlign]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/implicit_animations/animated_container.0.dart b/examples/api/lib/widgets/implicit_animations/animated_container.0.dart index 420e32b35b..174142ac8f 100644 --- a/examples/api/lib/widgets/implicit_animations/animated_container.0.dart +++ b/examples/api/lib/widgets/implicit_animations/animated_container.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedContainer +/// Flutter code sample for [AnimatedContainer]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/implicit_animations/animated_fractionally_sized_box.0.dart b/examples/api/lib/widgets/implicit_animations/animated_fractionally_sized_box.0.dart index 2595cfb67e..89f912808c 100644 --- a/examples/api/lib/widgets/implicit_animations/animated_fractionally_sized_box.0.dart +++ b/examples/api/lib/widgets/implicit_animations/animated_fractionally_sized_box.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedFractionallySizedBox +/// Flutter code sample for [AnimatedFractionallySizedBox]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/implicit_animations/animated_padding.0.dart b/examples/api/lib/widgets/implicit_animations/animated_padding.0.dart index 3732ab95c2..9459ffeb44 100644 --- a/examples/api/lib/widgets/implicit_animations/animated_padding.0.dart +++ b/examples/api/lib/widgets/implicit_animations/animated_padding.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedPadding +/// Flutter code sample for [AnimatedPadding]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/implicit_animations/animated_positioned.0.dart b/examples/api/lib/widgets/implicit_animations/animated_positioned.0.dart index 5b40d01abe..19207f285f 100644 --- a/examples/api/lib/widgets/implicit_animations/animated_positioned.0.dart +++ b/examples/api/lib/widgets/implicit_animations/animated_positioned.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedPositioned +/// Flutter code sample for [AnimatedPositioned]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/implicit_animations/animated_slide.0.dart b/examples/api/lib/widgets/implicit_animations/animated_slide.0.dart index 408b111753..29d0aaf67f 100644 --- a/examples/api/lib/widgets/implicit_animations/animated_slide.0.dart +++ b/examples/api/lib/widgets/implicit_animations/animated_slide.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedSlide +/// Flutter code sample for [AnimatedSlide]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/implicit_animations/sliver_animated_opacity.0.dart b/examples/api/lib/widgets/implicit_animations/sliver_animated_opacity.0.dart index 28bd5bac38..1ecc04e3fb 100644 --- a/examples/api/lib/widgets/implicit_animations/sliver_animated_opacity.0.dart +++ b/examples/api/lib/widgets/implicit_animations/sliver_animated_opacity.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverAnimatedOpacity +/// Flutter code sample for [SliverAnimatedOpacity]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/inherited_model/inherited_model.0.dart b/examples/api/lib/widgets/inherited_model/inherited_model.0.dart index feb88874e5..fa45b7bef1 100644 --- a/examples/api/lib/widgets/inherited_model/inherited_model.0.dart +++ b/examples/api/lib/widgets/inherited_model/inherited_model.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InheritedModel +/// Flutter code sample for [InheritedModel]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/inherited_notifier/inherited_notifier.0.dart b/examples/api/lib/widgets/inherited_notifier/inherited_notifier.0.dart index 7a5b01b195..6c6d53be7b 100644 --- a/examples/api/lib/widgets/inherited_notifier/inherited_notifier.0.dart +++ b/examples/api/lib/widgets/inherited_notifier/inherited_notifier.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InheritedNotifier +/// Flutter code sample for [InheritedNotifier]. import 'dart:math' as math; @@ -65,7 +65,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late AnimationController _controller; diff --git a/examples/api/lib/widgets/inherited_theme/inherited_theme.0.dart b/examples/api/lib/widgets/inherited_theme/inherited_theme.0.dart index 3b2aa23a0c..62756878a8 100644 --- a/examples/api/lib/widgets/inherited_theme/inherited_theme.0.dart +++ b/examples/api/lib/widgets/inherited_theme/inherited_theme.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InheritedTheme +/// Flutter code sample for [InheritedTheme]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/interactive_viewer/interactive_viewer.0.dart b/examples/api/lib/widgets/interactive_viewer/interactive_viewer.0.dart index 18100fa077..586e045266 100644 --- a/examples/api/lib/widgets/interactive_viewer/interactive_viewer.0.dart +++ b/examples/api/lib/widgets/interactive_viewer/interactive_viewer.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InteractiveViewer +/// Flutter code sample for [InteractiveViewer]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/interactive_viewer/interactive_viewer.builder.0.dart b/examples/api/lib/widgets/interactive_viewer/interactive_viewer.builder.0.dart index 3ed56f3442..5d8e30df2c 100644 --- a/examples/api/lib/widgets/interactive_viewer/interactive_viewer.builder.0.dart +++ b/examples/api/lib/widgets/interactive_viewer/interactive_viewer.builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InteractiveViewer.builder +/// Flutter code sample for [InteractiveViewer.builder]. import 'package:flutter/material.dart'; import 'package:vector_math/vector_math_64.dart' show Quad, Vector3; @@ -36,7 +36,8 @@ class _IVBuilderExampleState extends State<_IVBuilderExample> { static const double _cellWidth = 160.0; static const double _cellHeight = 80.0; - // Returns the axis aligned bounding box for the given Quad, which might not be axis aligned. + // Returns the axis aligned bounding box for the given Quad, which might not + // be axis aligned. Rect axisAlignedBoundingBox(Quad quad) { double xMin = quad.point0.x; double xMax = quad.point0.x; diff --git a/examples/api/lib/widgets/interactive_viewer/interactive_viewer.constrained.0.dart b/examples/api/lib/widgets/interactive_viewer/interactive_viewer.constrained.0.dart index 3bc8aad0c2..c576f4523e 100644 --- a/examples/api/lib/widgets/interactive_viewer/interactive_viewer.constrained.0.dart +++ b/examples/api/lib/widgets/interactive_viewer/interactive_viewer.constrained.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InteractiveViewer.constrained +/// Flutter code sample for [InteractiveViewer.constrained]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/interactive_viewer/interactive_viewer.transformation_controller.0.dart b/examples/api/lib/widgets/interactive_viewer/interactive_viewer.transformation_controller.0.dart index 1ae53871d2..0459b426fd 100644 --- a/examples/api/lib/widgets/interactive_viewer/interactive_viewer.transformation_controller.0.dart +++ b/examples/api/lib/widgets/interactive_viewer/interactive_viewer.transformation_controller.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for InteractiveViewer.transformationController +/// Flutter code sample for [InteractiveViewer.transformationController]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { final TransformationController _transformationController = diff --git a/examples/api/lib/widgets/layout_builder/layout_builder.0.dart b/examples/api/lib/widgets/layout_builder/layout_builder.0.dart index 7db7882316..4c77930fd1 100644 --- a/examples/api/lib/widgets/layout_builder/layout_builder.0.dart +++ b/examples/api/lib/widgets/layout_builder/layout_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for LayoutBuilder +/// Flutter code sample for [LayoutBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/media_query/media_query_data.system_gesture_insets.0.dart b/examples/api/lib/widgets/media_query/media_query_data.system_gesture_insets.0.dart index a955325988..1ab5934c43 100644 --- a/examples/api/lib/widgets/media_query/media_query_data.system_gesture_insets.0.dart +++ b/examples/api/lib/widgets/media_query/media_query_data.system_gesture_insets.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for MediaQueryData.systemGestureInsets +/// Flutter code sample for [MediaQueryData.systemGestureInsets]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/navigator/navigator.0.dart b/examples/api/lib/widgets/navigator/navigator.0.dart index 2baf740a32..974f3f523c 100644 --- a/examples/api/lib/widgets/navigator/navigator.0.dart +++ b/examples/api/lib/widgets/navigator/navigator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Navigator +/// Flutter code sample for [Navigator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/navigator/navigator.restorable_push.0.dart b/examples/api/lib/widgets/navigator/navigator.restorable_push.0.dart index 539c296e5b..e9f041e9e2 100644 --- a/examples/api/lib/widgets/navigator/navigator.restorable_push.0.dart +++ b/examples/api/lib/widgets/navigator/navigator.restorable_push.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Navigator.restorablePush +/// Flutter code sample for [Navigator.restorablePush]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/navigator/navigator.restorable_push_and_remove_until.0.dart b/examples/api/lib/widgets/navigator/navigator.restorable_push_and_remove_until.0.dart index b9fc04bb22..ea56fd4b1c 100644 --- a/examples/api/lib/widgets/navigator/navigator.restorable_push_and_remove_until.0.dart +++ b/examples/api/lib/widgets/navigator/navigator.restorable_push_and_remove_until.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Navigator.restorablePushAndRemoveUntil +/// Flutter code sample for [Navigator.restorablePushAndRemoveUntil]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/navigator/navigator.restorable_push_replacement.0.dart b/examples/api/lib/widgets/navigator/navigator.restorable_push_replacement.0.dart index ab6a15c64e..528efa211c 100644 --- a/examples/api/lib/widgets/navigator/navigator.restorable_push_replacement.0.dart +++ b/examples/api/lib/widgets/navigator/navigator.restorable_push_replacement.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Navigator.restorablePushReplacement +/// Flutter code sample for [Navigator.restorablePushReplacement]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/navigator/navigator_state.restorable_push.0.dart b/examples/api/lib/widgets/navigator/navigator_state.restorable_push.0.dart index c9f74790e7..b696760071 100644 --- a/examples/api/lib/widgets/navigator/navigator_state.restorable_push.0.dart +++ b/examples/api/lib/widgets/navigator/navigator_state.restorable_push.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NavigatorState.restorablePush +/// Flutter code sample for [NavigatorState.restorablePush]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/navigator/navigator_state.restorable_push_and_remove_until.0.dart b/examples/api/lib/widgets/navigator/navigator_state.restorable_push_and_remove_until.0.dart index a82c00fb78..a574f7efa5 100644 --- a/examples/api/lib/widgets/navigator/navigator_state.restorable_push_and_remove_until.0.dart +++ b/examples/api/lib/widgets/navigator/navigator_state.restorable_push_and_remove_until.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NavigatorState.restorablePushAndRemoveUntil +/// Flutter code sample for [NavigatorState.restorablePushAndRemoveUntil]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/navigator/navigator_state.restorable_push_replacement.0.dart b/examples/api/lib/widgets/navigator/navigator_state.restorable_push_replacement.0.dart index 48af958235..65b888b2ae 100644 --- a/examples/api/lib/widgets/navigator/navigator_state.restorable_push_replacement.0.dart +++ b/examples/api/lib/widgets/navigator/navigator_state.restorable_push_replacement.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NavigatorState.restorablePushReplacement +/// Flutter code sample for [NavigatorState.restorablePushReplacement]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/navigator/restorable_route_future.0.dart b/examples/api/lib/widgets/navigator/restorable_route_future.0.dart index 87634dba37..88a2e7bd1a 100644 --- a/examples/api/lib/widgets/navigator/restorable_route_future.0.dart +++ b/examples/api/lib/widgets/navigator/restorable_route_future.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RestorableRouteFuture +/// Flutter code sample for [RestorableRouteFuture]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.0.dart b/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.0.dart index 5585b34d97..01867a2b93 100644 --- a/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.0.dart +++ b/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NestedScrollView +/// Flutter code sample for [NestedScrollView]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.1.dart b/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.1.dart index 00f11886c4..ffe3c0725c 100644 --- a/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.1.dart +++ b/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NestedScrollView +/// Flutter code sample for [NestedScrollView]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.2.dart b/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.2.dart index 956dad0e1c..67347b983e 100644 --- a/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.2.dart +++ b/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NestedScrollView +/// Flutter code sample for [NestedScrollView]. import 'package:flutter/material.dart'; @@ -44,11 +44,10 @@ class MyStatelessWidget extends StatelessWidget { ]; }, body: Builder(builder: (BuildContext context) { return CustomScrollView( - // The "controller" and "primary" members should be left - // unset, so that the NestedScrollView can control this - // inner scroll view. - // If the "controller" property is set, then this scroll - // view will not be associated with the NestedScrollView. + // The "controller" and "primary" members should be left unset, so that + // the NestedScrollView can control this inner scroll view. + // If the "controller" property is set, then this scroll view will not + // be associated with the NestedScrollView. slivers: [ SliverOverlapInjector( handle: NestedScrollView.sliverOverlapAbsorberHandleFor(context)), diff --git a/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view_state.0.dart b/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view_state.0.dart index 0f70a18a60..e70d34b167 100644 --- a/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view_state.0.dart +++ b/examples/api/lib/widgets/nested_scroll_view/nested_scroll_view_state.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for NestedScrollViewState +/// Flutter code sample for [NestedScrollViewState]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/notification_listener/notification.0.dart b/examples/api/lib/widgets/notification_listener/notification.0.dart index 4471a3e8ba..371340a461 100644 --- a/examples/api/lib/widgets/notification_listener/notification.0.dart +++ b/examples/api/lib/widgets/notification_listener/notification.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Notification +/// Flutter code sample for [Notification]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/overflow_bar/overflow_bar.0.dart b/examples/api/lib/widgets/overflow_bar/overflow_bar.0.dart index 24719ace2e..febca049cd 100644 --- a/examples/api/lib/widgets/overflow_bar/overflow_bar.0.dart +++ b/examples/api/lib/widgets/overflow_bar/overflow_bar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for OverflowBar +/// Flutter code sample for [OverflowBar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/overlay/overlay.0.dart b/examples/api/lib/widgets/overlay/overlay.0.dart index 56d943b822..7444f6e2cf 100644 --- a/examples/api/lib/widgets/overlay/overlay.0.dart +++ b/examples/api/lib/widgets/overlay/overlay.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Overlay +/// Flutter code sample for [Overlay]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/overscroll_indicator/glowing_overscroll_indicator.0.dart b/examples/api/lib/widgets/overscroll_indicator/glowing_overscroll_indicator.0.dart index 079d96bd78..4887277416 100644 --- a/examples/api/lib/widgets/overscroll_indicator/glowing_overscroll_indicator.0.dart +++ b/examples/api/lib/widgets/overscroll_indicator/glowing_overscroll_indicator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for GlowingOverscrollIndicator +/// Flutter code sample for [GlowingOverscrollIndicator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/overscroll_indicator/glowing_overscroll_indicator.1.dart b/examples/api/lib/widgets/overscroll_indicator/glowing_overscroll_indicator.1.dart index 71accee45b..949f0900c7 100644 --- a/examples/api/lib/widgets/overscroll_indicator/glowing_overscroll_indicator.1.dart +++ b/examples/api/lib/widgets/overscroll_indicator/glowing_overscroll_indicator.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for GlowingOverscrollIndicator +/// Flutter code sample for [GlowingOverscrollIndicator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/page_storage/page_storage.0.dart b/examples/api/lib/widgets/page_storage/page_storage.0.dart index 0efbbecef0..78fe9b80e8 100644 --- a/examples/api/lib/widgets/page_storage/page_storage.0.dart +++ b/examples/api/lib/widgets/page_storage/page_storage.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PageStorage +/// Flutter code sample for [PageStorage]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/page_view/page_view.0.dart b/examples/api/lib/widgets/page_view/page_view.0.dart index 04c5532bb5..c97446ec5f 100644 --- a/examples/api/lib/widgets/page_view/page_view.0.dart +++ b/examples/api/lib/widgets/page_view/page_view.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PageView +/// Flutter code sample for [PageView]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/preferred_size/preferred_size.0.dart b/examples/api/lib/widgets/preferred_size/preferred_size.0.dart index 59f4878449..ddf0de2d47 100644 --- a/examples/api/lib/widgets/preferred_size/preferred_size.0.dart +++ b/examples/api/lib/widgets/preferred_size/preferred_size.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PreferredSize +/// Flutter code sample for [PreferredSize]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/restoration/restoration_mixin.0.dart b/examples/api/lib/widgets/restoration/restoration_mixin.0.dart index e857a8001a..dc0e9acbab 100644 --- a/examples/api/lib/widgets/restoration/restoration_mixin.0.dart +++ b/examples/api/lib/widgets/restoration/restoration_mixin.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RestorationMixin +/// Flutter code sample for [RestorationMixin]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/restoration_properties/restorable_value.0.dart b/examples/api/lib/widgets/restoration_properties/restorable_value.0.dart index 5462d30818..f3188bbb67 100644 --- a/examples/api/lib/widgets/restoration_properties/restorable_value.0.dart +++ b/examples/api/lib/widgets/restoration_properties/restorable_value.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RestorableValue +/// Flutter code sample for [RestorableValue]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/routes/popup_route.0.dart b/examples/api/lib/widgets/routes/popup_route.0.dart index 5a6eaaee05..1dec9fcb2a 100644 --- a/examples/api/lib/widgets/routes/popup_route.0.dart +++ b/examples/api/lib/widgets/routes/popup_route.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PopupRoute +/// Flutter code sample for [PopupRoute]. import 'package:flutter/material.dart'; @@ -28,7 +28,7 @@ class PopupRouteExample extends StatelessWidget { body: Center( child: OutlinedButton( onPressed: () { - /// This shows a dismissible dialog. + // This shows a dismissible dialog. Navigator.of(context).push(DismissibleDialog()); }, child: const Text('Open DismissibleDialog'), @@ -42,8 +42,8 @@ class DismissibleDialog extends PopupRoute { @override Color? get barrierColor => Colors.black.withAlpha(0x50); - /// This allows the popup to be dismissed by tapping the scrim or by - /// pressing escape key on the keyboard. + // This allows the popup to be dismissed by tapping the scrim or by pressing + // the escape key on the keyboard. @override bool get barrierDismissible => true; @@ -56,12 +56,12 @@ class DismissibleDialog extends PopupRoute { @override Widget buildPage(BuildContext context, Animation animation, Animation secondaryAnimation) { return Center( - /// Provide DefaultTextStyle to ensure that the dialog's text style matches - /// the rest of the text in the app. + // Provide DefaultTextStyle to ensure that the dialog's text style + // matches the rest of the text in the app. child: DefaultTextStyle( style: Theme.of(context).textTheme.bodyMedium!, - /// `UnconstrainedBox` is used to make the dialog size itself - /// to fit to the size of the content. + // UnconstrainedBox is used to make the dialog size itself + // to fit to the size of the content. child: UnconstrainedBox( child: Container( padding: const EdgeInsets.all(20.0), diff --git a/examples/api/lib/widgets/routes/show_general_dialog.0.dart b/examples/api/lib/widgets/routes/show_general_dialog.0.dart index aef240277a..96d5d798ca 100644 --- a/examples/api/lib/widgets/routes/show_general_dialog.0.dart +++ b/examples/api/lib/widgets/routes/show_general_dialog.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for showGeneralDialog +/// Flutter code sample for [showGeneralDialog]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/scroll_position/scroll_metrics_notification.0.dart b/examples/api/lib/widgets/scroll_position/scroll_metrics_notification.0.dart index 75bd6a8e94..6db2c26d2b 100644 --- a/examples/api/lib/widgets/scroll_position/scroll_metrics_notification.0.dart +++ b/examples/api/lib/widgets/scroll_position/scroll_metrics_notification.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScrollMetricsNotification +/// Flutter code sample for [ScrollMetricsNotification]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/scroll_view/custom_scroll_view.1.dart b/examples/api/lib/widgets/scroll_view/custom_scroll_view.1.dart index 0cf11bffee..896924fb56 100644 --- a/examples/api/lib/widgets/scroll_view/custom_scroll_view.1.dart +++ b/examples/api/lib/widgets/scroll_view/custom_scroll_view.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CustomScrollView +/// Flutter code sample for [CustomScrollView]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/scroll_view/listview_select.1.dart b/examples/api/lib/widgets/scroll_view/listview_select.1.dart index 05dbe71f14..a31757c2b3 100644 --- a/examples/api/lib/widgets/scroll_view/listview_select.1.dart +++ b/examples/api/lib/widgets/scroll_view/listview_select.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ListTile selection in a ListView or GridView +/// Flutter code sample for [ListTile] selection in a ListView or GridView. // Long press any ListTile to enable selection mode. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/scrollbar/raw_scrollbar.0.dart b/examples/api/lib/widgets/scrollbar/raw_scrollbar.0.dart index 5ed535e33b..0d58fa3ac7 100644 --- a/examples/api/lib/widgets/scrollbar/raw_scrollbar.0.dart +++ b/examples/api/lib/widgets/scrollbar/raw_scrollbar.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RawScrollbar +/// Flutter code sample for [RawScrollbar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/scrollbar/raw_scrollbar.1.dart b/examples/api/lib/widgets/scrollbar/raw_scrollbar.1.dart index c76ee33f68..bc01d353cf 100644 --- a/examples/api/lib/widgets/scrollbar/raw_scrollbar.1.dart +++ b/examples/api/lib/widgets/scrollbar/raw_scrollbar.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RawScrollbar +/// Flutter code sample for [RawScrollbar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/scrollbar/raw_scrollbar.2.dart b/examples/api/lib/widgets/scrollbar/raw_scrollbar.2.dart index 380cbaee1c..866e1844e8 100644 --- a/examples/api/lib/widgets/scrollbar/raw_scrollbar.2.dart +++ b/examples/api/lib/widgets/scrollbar/raw_scrollbar.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RawScrollbar +/// Flutter code sample for [RawScrollbar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/scrollbar/raw_scrollbar.desktop.0.dart b/examples/api/lib/widgets/scrollbar/raw_scrollbar.desktop.0.dart index 8a20c4c88e..8a1ad5db78 100644 --- a/examples/api/lib/widgets/scrollbar/raw_scrollbar.desktop.0.dart +++ b/examples/api/lib/widgets/scrollbar/raw_scrollbar.desktop.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Scrollbar +/// Flutter code sample for [Scrollbar]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/scrollbar/raw_scrollbar.shape.0.dart b/examples/api/lib/widgets/scrollbar/raw_scrollbar.shape.0.dart index b5a66198eb..8685d7a29c 100644 --- a/examples/api/lib/widgets/scrollbar/raw_scrollbar.shape.0.dart +++ b/examples/api/lib/widgets/scrollbar/raw_scrollbar.shape.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RawScrollbar.shape +/// Flutter code sample for [RawScrollbar.shape]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/shared_app_data/shared_app_data.0.dart b/examples/api/lib/widgets/shared_app_data/shared_app_data.0.dart index 7618a16434..a53ae13410 100644 --- a/examples/api/lib/widgets/shared_app_data/shared_app_data.0.dart +++ b/examples/api/lib/widgets/shared_app_data/shared_app_data.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SharedAppData +/// Flutter code sample for [SharedAppData]. import 'package:flutter/material.dart'; @@ -13,16 +13,16 @@ class ShowSharedValue extends StatelessWidget { @override Widget build(BuildContext context) { - // The SharedAppData.getValue() call here causes this widget to depend - // on the value of the SharedAppData's 'foo' key. If it's changed, with + // The SharedAppData.getValue() call causes this widget to depend on the + // value of the SharedAppData's 'foo' key. If it's changed, with // SharedAppData.setValue(), then this widget will be rebuilt. final String value = SharedAppData.getValue(context, appDataKey, () => 'initial'); return Text('$appDataKey: $value'); } } -// Demonstrates that changes to the SharedAppData _only_ cause the dependent widgets -// to be rebuilt. In this case that's the ShowSharedValue widget that's +// Demonstrates that changes to the SharedAppData _only_ cause the dependent +// widgets to be rebuilt. In this case that's the ShowSharedValue widget that's // displaying the value of a key whose value has been updated. class Home extends StatefulWidget { const Home({ super.key }); @@ -50,8 +50,8 @@ class _HomeState extends State { child: const Text('change foo'), onPressed: () { _fooVersion += 1; - // Changing the SharedAppData's value for 'foo' causes the widgets that - // depend on 'foo' to be rebuilt. + // Changing the SharedAppData's value for 'foo' causes the + // widgets that depend on 'foo' to be rebuilt. SharedAppData.setValue(context, 'foo', 'FOO $_fooVersion'); // note: no setState() }, ), diff --git a/examples/api/lib/widgets/shared_app_data/shared_app_data.1.dart b/examples/api/lib/widgets/shared_app_data/shared_app_data.1.dart index 6e203c4764..9ba66f63b7 100644 --- a/examples/api/lib/widgets/shared_app_data/shared_app_data.1.dart +++ b/examples/api/lib/widgets/shared_app_data/shared_app_data.1.dart @@ -2,15 +2,15 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SharedAppData +/// Flutter code sample for [SharedAppData]. import 'package:flutter/foundation.dart'; import 'package:flutter/material.dart'; -// A single lazily constructed object that's shared with the entire -// application via `SharedObject.of(context)`. The value of the object -// can be changed with `SharedObject.reset(context)`. Resetting the value -// will cause all of the widgets that depend on it to be rebuilt. +// A single lazily-constructed object that's shared with the entire application +// via `SharedObject.of(context)`. The value of the object can be changed with +// `SharedObject.reset(context)`. Resetting the value will cause all of the +// widgets that depend on it to be rebuilt. class SharedObject { SharedObject._(); @@ -31,8 +31,8 @@ class SharedObject { } } -// An example of a widget which depends on the SharedObject's value, -// which might be provided - along with SharedObject - in a Dart package. +// An example of a widget which depends on the SharedObject's value, which might +// be provided - along with SharedObject - in a Dart package. class CustomWidget extends StatelessWidget { const CustomWidget({ super.key }); diff --git a/examples/api/lib/widgets/shortcuts/character_activator.0.dart b/examples/api/lib/widgets/shortcuts/character_activator.0.dart index e601467e01..48bdbe8b22 100644 --- a/examples/api/lib/widgets/shortcuts/character_activator.0.dart +++ b/examples/api/lib/widgets/shortcuts/character_activator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for CharacterActivator +/// Flutter code sample for [CharacterActivator]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/shortcuts/logical_key_set.0.dart b/examples/api/lib/widgets/shortcuts/logical_key_set.0.dart index 106b9a488a..f617bdfc60 100644 --- a/examples/api/lib/widgets/shortcuts/logical_key_set.0.dart +++ b/examples/api/lib/widgets/shortcuts/logical_key_set.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for LogicalKeySet +/// Flutter code sample for [LogicalKeySet]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; diff --git a/examples/api/lib/widgets/shortcuts/shortcuts.0.dart b/examples/api/lib/widgets/shortcuts/shortcuts.0.dart index c6ccd5a6b0..2da2b3dee7 100644 --- a/examples/api/lib/widgets/shortcuts/shortcuts.0.dart +++ b/examples/api/lib/widgets/shortcuts/shortcuts.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Shortcuts +/// Flutter code sample for [Shortcuts]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; diff --git a/examples/api/lib/widgets/shortcuts/shortcuts.1.dart b/examples/api/lib/widgets/shortcuts/shortcuts.1.dart index 601ff40e85..5975d8ee25 100644 --- a/examples/api/lib/widgets/shortcuts/shortcuts.1.dart +++ b/examples/api/lib/widgets/shortcuts/shortcuts.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Shortcuts +/// Flutter code sample for [Shortcuts]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; diff --git a/examples/api/lib/widgets/shortcuts/single_activator.single_activator.0.dart b/examples/api/lib/widgets/shortcuts/single_activator.single_activator.0.dart index 8b21b3de61..f9ab6ca88d 100644 --- a/examples/api/lib/widgets/shortcuts/single_activator.single_activator.0.dart +++ b/examples/api/lib/widgets/shortcuts/single_activator.single_activator.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SingleActivator.SingleActivator +/// Flutter code sample for [SingleActivator.SingleActivator]. import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; diff --git a/examples/api/lib/widgets/single_child_scroll_view/single_child_scroll_view.0.dart b/examples/api/lib/widgets/single_child_scroll_view/single_child_scroll_view.0.dart index 7331e5b182..2c9d3f27c4 100644 --- a/examples/api/lib/widgets/single_child_scroll_view/single_child_scroll_view.0.dart +++ b/examples/api/lib/widgets/single_child_scroll_view/single_child_scroll_view.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SingleChildScrollView +/// Flutter code sample for [SingleChildScrollView]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/single_child_scroll_view/single_child_scroll_view.1.dart b/examples/api/lib/widgets/single_child_scroll_view/single_child_scroll_view.1.dart index feb42c3dd1..4e1ac49d43 100644 --- a/examples/api/lib/widgets/single_child_scroll_view/single_child_scroll_view.1.dart +++ b/examples/api/lib/widgets/single_child_scroll_view/single_child_scroll_view.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SingleChildScrollView +/// Flutter code sample for [SingleChildScrollView]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/sliver/sliver_opacity.1.dart b/examples/api/lib/widgets/sliver/sliver_opacity.1.dart index 5a83acd10f..5204770c00 100644 --- a/examples/api/lib/widgets/sliver/sliver_opacity.1.dart +++ b/examples/api/lib/widgets/sliver/sliver_opacity.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverOpacity +/// Flutter code sample for [SliverOpacity]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.0.dart b/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.0.dart index 192c0ec0af..a941604e48 100644 --- a/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.0.dart +++ b/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverFillRemaining +/// Flutter code sample for [SliverFillRemaining]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.1.dart b/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.1.dart index 163e3324c1..71e624dd3a 100644 --- a/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.1.dart +++ b/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.1.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverFillRemaining +/// Flutter code sample for [SliverFillRemaining]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.2.dart b/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.2.dart index b6df67a439..46d6d05493 100644 --- a/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.2.dart +++ b/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.2.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverFillRemaining +/// Flutter code sample for [SliverFillRemaining]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.3.dart b/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.3.dart index 906ab54734..85a291baa7 100644 --- a/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.3.dart +++ b/examples/api/lib/widgets/sliver_fill/sliver_fill_remaining.3.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverFillRemaining +/// Flutter code sample for [SliverFillRemaining]. import 'package:flutter/material.dart'; @@ -33,12 +33,11 @@ class MyStatelessWidget extends StatelessWidget { return CustomScrollView( // The ScrollPhysics are overridden here to illustrate the functionality // of fillOverscroll on all devices this sample may be run on. - // fillOverscroll only changes the behavior of your layout when applied - // to Scrollables that allow for overscroll. BouncingScrollPhysics are - // one example, which are provided by default on the iOS platform. - // BouncingScrollPhysics is combined with AlwaysScrollableScrollPhysics - // to allow for the overscroll, regardless of the depth of the - // scrollable. + // fillOverscroll only changes the behavior of your layout when applied to + // Scrollables that allow for overscroll. BouncingScrollPhysics are one + // example, which are provided by default on the iOS platform. + // BouncingScrollPhysics is combined with AlwaysScrollableScrollPhysics to + // allow for the overscroll, regardless of the depth of the scrollable. physics: const BouncingScrollPhysics(parent: AlwaysScrollableScrollPhysics()), slivers: [ @@ -50,9 +49,9 @@ class MyStatelessWidget extends StatelessWidget { ), SliverFillRemaining( hasScrollBody: false, - // Switch for different overscroll behavior in your layout. - // If your ScrollPhysics do not allow for overscroll, setting - // fillOverscroll to true will have no effect. + // Switch for different overscroll behavior in your layout. If your + // ScrollPhysics do not allow for overscroll, setting fillOverscroll + // to true will have no effect. fillOverscroll: true, child: Container( color: Colors.teal[100], diff --git a/examples/api/lib/widgets/slotted_render_object_widget/slotted_multi_child_render_object_widget_mixin.0.dart b/examples/api/lib/widgets/slotted_render_object_widget/slotted_multi_child_render_object_widget_mixin.0.dart index ba10d06574..1e7db77c93 100644 --- a/examples/api/lib/widgets/slotted_render_object_widget/slotted_multi_child_render_object_widget_mixin.0.dart +++ b/examples/api/lib/widgets/slotted_render_object_widget/slotted_multi_child_render_object_widget_mixin.0.dart @@ -2,6 +2,8 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. +/// Flutter code sample for [SlottedMultiChildRenderObjectWidgetMixin]. + import 'package:flutter/material.dart'; import 'package:flutter/rendering.dart'; @@ -11,8 +13,9 @@ enum DiagonalSlot { bottomRight, } -/// A widget that demonstrates the usage of [SlottedMultiChildRenderObjectWidgetMixin] -/// by providing slots for two children that will be arranged diagonally. +/// A widget that demonstrates the usage of +/// [SlottedMultiChildRenderObjectWidgetMixin] by providing slots for two +/// children that will be arranged diagonally. class Diagonal extends RenderObjectWidget with SlottedMultiChildRenderObjectWidgetMixin { const Diagonal({ super.key, @@ -63,8 +66,9 @@ class Diagonal extends RenderObjectWidget with SlottedMultiChildRenderObjectWidg } } -/// A render object that demonstrates the usage of [SlottedContainerRenderObjectMixin] -/// by providing slots for two children that will be arranged diagonally. +/// A render object that demonstrates the usage of +/// [SlottedContainerRenderObjectMixin] by providing slots for two children that +/// will be arranged diagonally. class RenderDiagonal extends RenderBox with SlottedContainerRenderObjectMixin, DebugOverflowIndicatorMixin { RenderDiagonal({Color? backgroundColor}) : _backgroundColor = backgroundColor; diff --git a/examples/api/lib/widgets/table/table.0.dart b/examples/api/lib/widgets/table/table.0.dart index 854c1ddce7..6e158883eb 100644 --- a/examples/api/lib/widgets/table/table.0.dart +++ b/examples/api/lib/widgets/table/table.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for Table +/// Flutter code sample for [Table]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/transitions/align_transition.0.dart b/examples/api/lib/widgets/transitions/align_transition.0.dart index 138bd60538..1ffb8adbec 100644 --- a/examples/api/lib/widgets/transitions/align_transition.0.dart +++ b/examples/api/lib/widgets/transitions/align_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AlignTransition +/// Flutter code sample for [AlignTransition]. import 'package:flutter/material.dart'; @@ -29,10 +29,12 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { -// Using `late final` for [lazy initialization](https://dart.dev/null-safety/understanding-null-safety#lazy-initialization). + // Using `late final` for lazy initialization. See + // https://dart.dev/null-safety/understanding-null-safety#lazy-initialization. late final AnimationController _controller = AnimationController( duration: const Duration(seconds: 2), vsync: this, diff --git a/examples/api/lib/widgets/transitions/animated_builder.0.dart b/examples/api/lib/widgets/transitions/animated_builder.0.dart index 3128b26349..06cfadac91 100644 --- a/examples/api/lib/widgets/transitions/animated_builder.0.dart +++ b/examples/api/lib/widgets/transitions/animated_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedBuilder +/// Flutter code sample for [AnimatedBuilder]. import 'dart:math' as math; @@ -31,7 +31,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// AnimationControllers can be created with `vsync: this` because of +/// TickerProviderStateMixin. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late final AnimationController _controller = AnimationController( diff --git a/examples/api/lib/widgets/transitions/animated_widget.0.dart b/examples/api/lib/widgets/transitions/animated_widget.0.dart index 958766d152..678493d12e 100644 --- a/examples/api/lib/widgets/transitions/animated_widget.0.dart +++ b/examples/api/lib/widgets/transitions/animated_widget.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for AnimatedWidget +/// Flutter code sample for [AnimatedWidget]. import 'dart:math' as math; @@ -48,7 +48,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late final AnimationController _controller = AnimationController( diff --git a/examples/api/lib/widgets/transitions/decorated_box_transition.0.dart b/examples/api/lib/widgets/transitions/decorated_box_transition.0.dart index 729610b4f1..d49c748b6e 100644 --- a/examples/api/lib/widgets/transitions/decorated_box_transition.0.dart +++ b/examples/api/lib/widgets/transitions/decorated_box_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for DecoratedBoxTransition +/// Flutter code sample for [DecoratedBoxTransition]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { final DecorationTween decorationTween = DecorationTween( diff --git a/examples/api/lib/widgets/transitions/default_text_style_transition.0.dart b/examples/api/lib/widgets/transitions/default_text_style_transition.0.dart index c42cbff7ea..319211bf87 100644 --- a/examples/api/lib/widgets/transitions/default_text_style_transition.0.dart +++ b/examples/api/lib/widgets/transitions/default_text_style_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for DefaultTextStyleTransition +/// Flutter code sample for [DefaultTextStyleTransition]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late AnimationController _controller; diff --git a/examples/api/lib/widgets/transitions/fade_transition.0.dart b/examples/api/lib/widgets/transitions/fade_transition.0.dart index e121c042be..ea37b132cd 100644 --- a/examples/api/lib/widgets/transitions/fade_transition.0.dart +++ b/examples/api/lib/widgets/transitions/fade_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for FadeTransition +/// Flutter code sample for [FadeTransition]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late final AnimationController _controller = AnimationController( diff --git a/examples/api/lib/widgets/transitions/positioned_transition.0.dart b/examples/api/lib/widgets/transitions/positioned_transition.0.dart index 6d56d4f31e..c5153a498c 100644 --- a/examples/api/lib/widgets/transitions/positioned_transition.0.dart +++ b/examples/api/lib/widgets/transitions/positioned_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for PositionedTransition +/// Flutter code sample for [PositionedTransition]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late final AnimationController _controller = AnimationController( diff --git a/examples/api/lib/widgets/transitions/relative_positioned_transition.0.dart b/examples/api/lib/widgets/transitions/relative_positioned_transition.0.dart index 32cb0d0b23..9e60d7b520 100644 --- a/examples/api/lib/widgets/transitions/relative_positioned_transition.0.dart +++ b/examples/api/lib/widgets/transitions/relative_positioned_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RelativePositionedTransition +/// Flutter code sample for [RelativePositionedTransition]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late final AnimationController _controller = AnimationController( diff --git a/examples/api/lib/widgets/transitions/rotation_transition.0.dart b/examples/api/lib/widgets/transitions/rotation_transition.0.dart index 930f288b1f..06a93e66e0 100644 --- a/examples/api/lib/widgets/transitions/rotation_transition.0.dart +++ b/examples/api/lib/widgets/transitions/rotation_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for RotationTransition +/// Flutter code sample for [RotationTransition]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late final AnimationController _controller = AnimationController( diff --git a/examples/api/lib/widgets/transitions/scale_transition.0.dart b/examples/api/lib/widgets/transitions/scale_transition.0.dart index e5665f6a70..1d77a5e091 100644 --- a/examples/api/lib/widgets/transitions/scale_transition.0.dart +++ b/examples/api/lib/widgets/transitions/scale_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for ScaleTransition +/// Flutter code sample for [ScaleTransition]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late final AnimationController _controller = AnimationController( diff --git a/examples/api/lib/widgets/transitions/size_transition.0.dart b/examples/api/lib/widgets/transitions/size_transition.0.dart index 91435d3701..f64e6897a2 100644 --- a/examples/api/lib/widgets/transitions/size_transition.0.dart +++ b/examples/api/lib/widgets/transitions/size_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SizeTransition +/// Flutter code sample for [SizeTransition]. import 'package:flutter/material.dart'; @@ -29,7 +29,8 @@ class MyStatefulWidget extends StatefulWidget { State createState() => _MyStatefulWidgetState(); } -/// AnimationControllers can be created with `vsync: this` because of TickerProviderStateMixin. +/// [AnimationController]s can be created with `vsync: this` because of +/// [TickerProviderStateMixin]. class _MyStatefulWidgetState extends State with TickerProviderStateMixin { late final AnimationController _controller = AnimationController( diff --git a/examples/api/lib/widgets/transitions/slide_transition.0.dart b/examples/api/lib/widgets/transitions/slide_transition.0.dart index 5e27c777cb..9d759bfc18 100644 --- a/examples/api/lib/widgets/transitions/slide_transition.0.dart +++ b/examples/api/lib/widgets/transitions/slide_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SlideTransition +/// Flutter code sample for [SlideTransition]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/transitions/sliver_fade_transition.0.dart b/examples/api/lib/widgets/transitions/sliver_fade_transition.0.dart index 5fac69653b..51a46b3a23 100644 --- a/examples/api/lib/widgets/transitions/sliver_fade_transition.0.dart +++ b/examples/api/lib/widgets/transitions/sliver_fade_transition.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for SliverFadeTransition +/// Flutter code sample for [SliverFadeTransition]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/tween_animation_builder/tween_animation_builder.0.dart b/examples/api/lib/widgets/tween_animation_builder/tween_animation_builder.0.dart index 2e67e846d5..a5b9c2f86a 100644 --- a/examples/api/lib/widgets/tween_animation_builder/tween_animation_builder.0.dart +++ b/examples/api/lib/widgets/tween_animation_builder/tween_animation_builder.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for TweenAnimationBuilder +/// Flutter code sample for [TweenAnimationBuilder]. import 'package:flutter/material.dart'; diff --git a/examples/api/lib/widgets/will_pop_scope/will_pop_scope.0.dart b/examples/api/lib/widgets/will_pop_scope/will_pop_scope.0.dart index cf7f37e288..975a888516 100644 --- a/examples/api/lib/widgets/will_pop_scope/will_pop_scope.0.dart +++ b/examples/api/lib/widgets/will_pop_scope/will_pop_scope.0.dart @@ -2,7 +2,7 @@ // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. -// Flutter code sample for WillPopScope +/// Flutter code sample for [WillPopScope]. import 'package:flutter/material.dart'; diff --git a/examples/api/test/material/bottom_navigation_bar/bottom_navigation_bar.2.test.dart b/examples/api/test/material/bottom_navigation_bar/bottom_navigation_bar.2_test.dart similarity index 80% rename from examples/api/test/material/bottom_navigation_bar/bottom_navigation_bar.2.test.dart rename to examples/api/test/material/bottom_navigation_bar/bottom_navigation_bar.2_test.dart index 9d7788a91c..726698b699 100644 --- a/examples/api/test/material/bottom_navigation_bar/bottom_navigation_bar.2.test.dart +++ b/examples/api/test/material/bottom_navigation_bar/bottom_navigation_bar.2_test.dart @@ -3,24 +3,20 @@ // found in the LICENSE file. import 'package:flutter/material.dart'; -import 'package:flutter_api_samples/material/bottom_navigation_bar/bottom_navigation_bar.2.dart' - as example; +import 'package:flutter_api_samples/material/bottom_navigation_bar/bottom_navigation_bar.2.dart' as example; import 'package:flutter_test/flutter_test.dart'; void main() { - testWidgets('BottomNavigationBar Updates Screen Content', - (WidgetTester tester) async { + testWidgets('BottomNavigationBar Updates Screen Content', (WidgetTester tester) async { await tester.pumpWidget( const example.MyApp(), ); - expect(find.widgetWithText(AppBar, 'BottomNavigationBar Sample'), - findsOneWidget); + expect(find.widgetWithText(AppBar, 'BottomNavigationBar Sample'), findsOneWidget); expect(find.byType(BottomNavigationBar), findsOneWidget); expect(find.widgetWithText(Center, 'Item 0'), findsOneWidget); - await tester.scrollUntilVisible( - find.widgetWithText(Center, 'Item 49'), 100); + await tester.scrollUntilVisible(find.widgetWithText(Center, 'Item 49'), 100); await tester.pumpAndSettle(); expect(find.widgetWithText(Center, 'Item 49'), findsOneWidget); diff --git a/examples/api/test/material/navigation_bar/navigation_bar_test.dart b/examples/api/test/material/navigation_bar/navigation_bar.0_test.dart similarity index 95% rename from examples/api/test/material/navigation_bar/navigation_bar_test.dart rename to examples/api/test/material/navigation_bar/navigation_bar.0_test.dart index cad8ee5d53..501058eb21 100644 --- a/examples/api/test/material/navigation_bar/navigation_bar_test.dart +++ b/examples/api/test/material/navigation_bar/navigation_bar.0_test.dart @@ -3,7 +3,7 @@ // found in the LICENSE file. import 'package:flutter/material.dart'; -import 'package:flutter_api_samples/material/navigation_bar/navigation_bar.dart' +import 'package:flutter_api_samples/material/navigation_bar/navigation_bar.0.dart' as example; import 'package:flutter_test/flutter_test.dart'; @@ -11,7 +11,7 @@ void main() { testWidgets('Navigation bar updates destination on tap', (WidgetTester tester) async { await tester.pumpWidget( - const example.MyApp(), + const example.ExampleApp(), ); final NavigationBar navigationBarWidget = tester.firstWidget(find.byType(NavigationBar)); diff --git a/examples/api/test/material/navigation_bar/navigation_bar.0.test.dart b/examples/api/test/material/navigation_bar/navigation_bar.1_test.dart similarity index 99% rename from examples/api/test/material/navigation_bar/navigation_bar.0.test.dart rename to examples/api/test/material/navigation_bar/navigation_bar.1_test.dart index 933ca51c22..23c35f9c0f 100644 --- a/examples/api/test/material/navigation_bar/navigation_bar.0.test.dart +++ b/examples/api/test/material/navigation_bar/navigation_bar.1_test.dart @@ -3,7 +3,7 @@ // found in the LICENSE file. import 'package:flutter/material.dart'; -import 'package:flutter_api_samples/material/navigation_bar/navigation_bar.0.dart' as example; +import 'package:flutter_api_samples/material/navigation_bar/navigation_bar.1.dart' as example; import 'package:flutter_test/flutter_test.dart'; void main() { diff --git a/examples/api/test/material/popupmenu/popupmenu.0.test.dart b/examples/api/test/material/popupmenu/popupmenu.0_test.dart similarity index 100% rename from examples/api/test/material/popupmenu/popupmenu.0.test.dart rename to examples/api/test/material/popupmenu/popupmenu.0_test.dart diff --git a/packages/flutter/lib/src/material/navigation_bar.dart b/packages/flutter/lib/src/material/navigation_bar.dart index d4c7893814..accc9760d3 100644 --- a/packages/flutter/lib/src/material/navigation_bar.dart +++ b/packages/flutter/lib/src/material/navigation_bar.dart @@ -41,11 +41,23 @@ import 'tooltip.dart'; /// /// {@tool dartpad} /// This example shows a [NavigationBar] as it is used within a [Scaffold] -/// widget. The [NavigationBar] has three [NavigationDestination] widgets -/// and the [selectedIndex] is set to index 0. The `onDestinationSelected` callback -/// changes the selected item's index and displays a corresponding widget in the body of the [Scaffold]. +/// widget. The [NavigationBar] has three [NavigationDestination] widgets and +/// the initial [selectedIndex] is set to index 0. The [onDestinationSelected] +/// callback changes the selected item's index and displays a corresponding +/// widget in the body of the [Scaffold]. /// -/// ** See code in examples/api/lib/material/navigation_bar/navigation_bar.dart ** +/// ** See code in examples/api/lib/material/navigation_bar/navigation_bar.0.dart ** +/// {@end-tool} +/// +/// {@tool dartpad} +/// This example shows a [NavigationBar] as it is used within a [Scaffold] +/// widget when there are nested navigators that provide local navigation. The +/// [NavigationBar] has four [NavigationDestination] widgets with different +/// color schemes. The [onDestinationSelected] callback changes the selected +/// item's index and displays a corresponding page with its own local navigator +/// in the body of a [Scaffold]. +/// +/// ** See code in examples/api/lib/material/navigation_bar/navigation_bar.1.dart ** /// {@end-tool} /// See also: /// diff --git a/packages/flutter/lib/src/material/selection_area.dart b/packages/flutter/lib/src/material/selection_area.dart index a02190c028..a6312a6a94 100644 --- a/packages/flutter/lib/src/material/selection_area.dart +++ b/packages/flutter/lib/src/material/selection_area.dart @@ -28,7 +28,7 @@ import 'theme.dart'; /// {@tool dartpad} /// This example shows how to make a screen selectable. /// -/// ** See code in examples/api/lib/material/selection_area/selection_area.dart ** +/// ** See code in examples/api/lib/material/selection_area/selection_area.0.dart ** /// {@end-tool} /// /// See also: diff --git a/packages/flutter/lib/src/widgets/selectable_region.dart b/packages/flutter/lib/src/widgets/selectable_region.dart index 0cf2f22931..9995bfe4ab 100644 --- a/packages/flutter/lib/src/widgets/selectable_region.dart +++ b/packages/flutter/lib/src/widgets/selectable_region.dart @@ -142,7 +142,7 @@ const Set _kLongPressSelectionDevices = { /// This sample demonstrates how to create an adapter widget that makes any /// child widget selectable. /// -/// ** See code in examples/api/lib/material/selection_area/custom_selectable.dart ** +/// ** See code in examples/api/lib/material/selectable_region/selectable_region.0.dart ** /// {@end-tool} /// /// ## Complex layout @@ -155,7 +155,7 @@ const Set _kLongPressSelectionDevices = { /// This sample demonstrates how to create a [SelectionContainer] that only /// allows selecting everything or nothing with no partial selection. /// -/// ** See code in examples/api/lib/material/selection_area/custom_container.dart ** +/// ** See code in examples/api/lib/material/selection_container/selection_container.0.dart ** /// {@end-tool} /// /// In the case where a group of widgets should be excluded from selection under @@ -165,7 +165,7 @@ const Set _kLongPressSelectionDevices = { /// {@tool dartpad} /// This sample demonstrates how to disable selection for a Text in a Column. /// -/// ** See code in examples/api/lib/material/selection_area/disable_partial_selection.dart ** +/// ** See code in examples/api/lib/material/selection_container/selection_container_disabled.0.dart ** /// {@end-tool} /// /// To create a separate selection system from its parent selection area, diff --git a/packages/flutter/lib/src/widgets/selection_container.dart b/packages/flutter/lib/src/widgets/selection_container.dart index df3070958d..0ff8081f4d 100644 --- a/packages/flutter/lib/src/widgets/selection_container.dart +++ b/packages/flutter/lib/src/widgets/selection_container.dart @@ -29,7 +29,7 @@ import 'framework.dart'; /// This sample demonstrates how to create a [SelectionContainer] that only /// allows selecting everything or nothing with no partial selection. /// -/// ** See code in examples/api/lib/material/selection_area/custom_container.dart ** +/// ** See code in examples/api/lib/material/selection_container/selection_container.0.dart ** /// {@end-tool} /// /// See also: @@ -54,6 +54,13 @@ class SelectionContainer extends StatefulWidget { /// Creates a selection container that disables selection for the /// subtree. /// + /// {@tool dartpad} + /// This sample demonstrates how to disable selection for a Text under a + /// SelectionArea. + /// + /// ** See code in examples/api/lib/material/selection_container/selection_container_disabled.0.dart ** + /// {@end-tool} + /// /// The [child] must not be null. const SelectionContainer.disabled({ super.key, diff --git a/packages/flutter/lib/src/widgets/text.dart b/packages/flutter/lib/src/widgets/text.dart index ba0edc15af..4ce409596e 100644 --- a/packages/flutter/lib/src/widgets/text.dart +++ b/packages/flutter/lib/src/widgets/text.dart @@ -356,7 +356,7 @@ class DefaultTextHeightBehavior extends InheritedTheme { /// This sample demonstrates how to disable selection for a Text under a /// SelectionArea. /// -/// ** See code in examples/api/lib/material/selection_area/disable_partial_selection.dart ** +/// ** See code in examples/api/lib/material/selection_container/selection_container_disabled.0.dart ** /// {@end-tool} /// /// See also: @@ -373,8 +373,9 @@ class Text extends StatelessWidget { /// The [data] parameter must not be null. /// /// The [overflow] property's behavior is affected by the [softWrap] argument. - /// If the [softWrap] is true or null, the glyph causing overflow, and those that follow, - /// will not be rendered. Otherwise, it will be shown with the given overflow option. + /// If the [softWrap] is true or null, the glyph causing overflow, and those + /// that follow, will not be rendered. Otherwise, it will be shown with the + /// given overflow option. const Text( String this.data, { super.key,