firka/flutter
firka/flutter
4
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix: inline templatized see also (#93600)

Browse Source
This commit is contained in:
Léo Salé 2021-11-17 02:28:06 +00:00 committed by GitHub
parent 5d7fc2358a
commit f045549a86
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 69 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

114
packages/flutter/lib/src/material/slider_theme.dart
View File

@ -30,35 +30,21 @@ import 'theme.dart';
/// ///
/// * [SliderThemeData], which describes the actual configuration of a slider /// * [SliderThemeData], which describes the actual configuration of a slider
/// theme. /// theme.
/// {@template flutter.material.SliderTheme.sliderComponentShape}
/// * [SliderComponentShape], which can be used to create custom shapes for /// * [SliderComponentShape], which can be used to create custom shapes for
/// the [Slider]'s thumb, overlay, and value indicator and the /// the [Slider]'s thumb, overlay, and value indicator and the
/// [RangeSlider]'s overlay. /// [RangeSlider]'s overlay.
/// {@endtemplate}
/// {@template flutter.material.SliderTheme.sliderTrackShape}
/// * [SliderTrackShape], which can be used to create custom shapes for the /// * [SliderTrackShape], which can be used to create custom shapes for the
/// [Slider]'s track. /// [Slider]'s track.
/// {@endtemplate}
/// {@template flutter.material.SliderTheme.sliderTickMarkShape}
/// * [SliderTickMarkShape], which can be used to create custom shapes for the /// * [SliderTickMarkShape], which can be used to create custom shapes for the
/// [Slider]'s tick marks. /// [Slider]'s tick marks.
/// {@endtemplate}
/// {@template flutter.material.SliderTheme.rangeSliderThumbShape}
/// * [RangeSliderThumbShape], which can be used to create custom shapes for /// * [RangeSliderThumbShape], which can be used to create custom shapes for
/// the [RangeSlider]'s thumb. /// the [RangeSlider]'s thumb.
/// {@endtemplate}
/// {@template flutter.material.SliderTheme.rangeSliderValueIndicatorShape}
/// * [RangeSliderValueIndicatorShape], which can be used to create custom /// * [RangeSliderValueIndicatorShape], which can be used to create custom
/// shapes for the [RangeSlider]'s value indicator. /// shapes for the [RangeSlider]'s value indicator.
/// {@endtemplate}
/// {@template flutter.material.SliderTheme.rangeSliderTrackShape}
/// * [RangeSliderTrackShape], which can be used to create custom shapes for /// * [RangeSliderTrackShape], which can be used to create custom shapes for
/// the [RangeSlider]'s track. /// the [RangeSlider]'s track.
/// {@endtemplate}
/// {@template flutter.material.SliderTheme.rangeSliderTickMarkShape}
/// * [RangeSliderTickMarkShape], which can be used to create custom shapes for /// * [RangeSliderTickMarkShape], which can be used to create custom shapes for
/// the [RangeSlider]'s tick marks. /// the [RangeSlider]'s tick marks.
/// {@endtemplate}
class SliderTheme extends InheritedTheme { class SliderTheme extends InheritedTheme {
/// Applies the given theme [data] to [child]. /// Applies the given theme [data] to [child].
/// ///
@ -224,13 +210,21 @@ enum Thumb {
/// * [Theme] widget, which performs a similar function to [SliderTheme], /// * [Theme] widget, which performs a similar function to [SliderTheme],
/// but for overall themes. /// but for overall themes.
/// * [ThemeData], which has a default [SliderThemeData]. /// * [ThemeData], which has a default [SliderThemeData].
/// {@macro flutter.material.SliderTheme.sliderComponentShape} /// * [SliderComponentShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.sliderTrackShape} /// the [Slider]'s thumb, overlay, and value indicator and the
/// {@macro flutter.material.SliderTheme.sliderTickMarkShape} /// [RangeSlider]'s overlay.
/// {@macro flutter.material.SliderTheme.rangeSliderThumbShape} /// * [SliderTrackShape], which can be used to create custom shapes for the
/// {@macro flutter.material.SliderTheme.rangeSliderValueIndicatorShape} /// [Slider]'s track.
/// {@macro flutter.material.SliderTheme.rangeSliderTrackShape} /// * [SliderTickMarkShape], which can be used to create custom shapes for the
/// {@macro flutter.material.SliderTheme.rangeSliderTickMarkShape} /// [Slider]'s tick marks.
/// * [RangeSliderThumbShape], which can be used to create custom shapes for
/// the [RangeSlider]'s thumb.
/// * [RangeSliderValueIndicatorShape], which can be used to create custom
/// shapes for the [RangeSlider]'s value indicator.
/// * [RangeSliderTrackShape], which can be used to create custom shapes for
/// the [RangeSlider]'s track.
/// * [RangeSliderTickMarkShape], which can be used to create custom shapes for
/// the [RangeSlider]'s tick marks.
@immutable @immutable
class SliderThemeData with Diagnosticable { class SliderThemeData with Diagnosticable {
/// Create a [SliderThemeData] given a set of exact values. /// Create a [SliderThemeData] given a set of exact values.
@ -910,8 +904,11 @@ abstract class SliderComponentShape {
/// ///
/// * [RoundSliderTickMarkShape], which is the default [Slider]'s tick mark /// * [RoundSliderTickMarkShape], which is the default [Slider]'s tick mark
/// shape that paints a solid circle. /// shape that paints a solid circle.
/// {@macro flutter.material.SliderTheme.sliderTrackShape} /// * [SliderTrackShape], which can be used to create custom shapes for the
/// {@macro flutter.material.SliderTheme.sliderComponentShape} /// [Slider]'s track.
/// * [SliderComponentShape], which can be used to create custom shapes for
/// the [Slider]'s thumb, overlay, and value indicator and the
/// [RangeSlider]'s overlay.
abstract class SliderTickMarkShape { abstract class SliderTickMarkShape {
/// This abstract const constructor enables subclasses to provide /// This abstract const constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions. /// const constructors so that they can be used in const expressions.
@ -986,8 +983,11 @@ abstract class SliderTickMarkShape {
/// ///
/// * [RoundedRectSliderTrackShape] for the default [Slider]'s track shape that /// * [RoundedRectSliderTrackShape] for the default [Slider]'s track shape that
/// paints a stadium-like track. /// paints a stadium-like track.
/// {@macro flutter.material.SliderTheme.sliderTickMarkShape} /// * [SliderTickMarkShape], which can be used to create custom shapes for the
/// {@macro flutter.material.SliderTheme.sliderComponentShape} /// [Slider]'s tick marks.
/// * [SliderComponentShape], which can be used to create custom shapes for
/// the [Slider]'s thumb, overlay, and value indicator and the
/// [RangeSlider]'s overlay.
abstract class SliderTrackShape { abstract class SliderTrackShape {
/// This abstract const constructor enables subclasses to provide /// This abstract const constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions. /// const constructors so that they can be used in const expressions.
@ -1068,10 +1068,15 @@ abstract class SliderTrackShape {
/// ///
/// * [RoundRangeSliderThumbShape] for the default [RangeSlider]'s thumb shape /// * [RoundRangeSliderThumbShape] for the default [RangeSlider]'s thumb shape
/// that paints a solid circle. /// that paints a solid circle.
/// {@macro flutter.material.SliderTheme.rangeSliderTickMarkShape} /// * [RangeSliderTickMarkShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.rangeSliderTrackShape} /// the [RangeSlider]'s tick marks.
/// {@macro flutter.material.SliderTheme.rangeSliderValueIndicatorShape} /// * [RangeSliderTrackShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.sliderComponentShape} /// the [RangeSlider]'s track.
/// * [RangeSliderValueIndicatorShape], which can be used to create custom
/// shapes for the [RangeSlider]'s value indicator.
/// * [SliderComponentShape], which can be used to create custom shapes for
/// the [Slider]'s thumb, overlay, and value indicator and the
/// [RangeSlider]'s overlay.
abstract class RangeSliderThumbShape { abstract class RangeSliderThumbShape {
/// This abstract const constructor enables subclasses to provide /// This abstract const constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions. /// const constructors so that they can be used in const expressions.
@ -1158,10 +1163,15 @@ abstract class RangeSliderThumbShape {
/// ///
/// * [PaddleRangeSliderValueIndicatorShape] for the default [RangeSlider]'s /// * [PaddleRangeSliderValueIndicatorShape] for the default [RangeSlider]'s
/// value indicator shape that paints a custom path with text in it. /// value indicator shape that paints a custom path with text in it.
/// {@macro flutter.material.SliderTheme.rangeSliderTickMarkShape} /// * [RangeSliderTickMarkShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.rangeSliderThumbShape} /// the [RangeSlider]'s tick marks.
/// {@macro flutter.material.SliderTheme.rangeSliderTrackShape} /// * [RangeSliderThumbShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.sliderComponentShape} /// the [RangeSlider]'s thumb.
/// * [RangeSliderTrackShape], which can be used to create custom shapes for
/// the [RangeSlider]'s track.
/// * [SliderComponentShape], which can be used to create custom shapes for
/// the [Slider]'s thumb, overlay, and value indicator and the
/// [RangeSlider]'s overlay.
abstract class RangeSliderValueIndicatorShape { abstract class RangeSliderValueIndicatorShape {
/// This abstract const constructor enables subclasses to provide /// This abstract const constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions. /// const constructors so that they can be used in const expressions.
@ -1263,10 +1273,15 @@ abstract class RangeSliderValueIndicatorShape {
/// ///
/// * [RoundRangeSliderTickMarkShape] for the default [RangeSlider]'s tick mark /// * [RoundRangeSliderTickMarkShape] for the default [RangeSlider]'s tick mark
/// shape that paints a solid circle. /// shape that paints a solid circle.
/// {@macro flutter.material.SliderTheme.rangeSliderThumbShape} /// * [RangeSliderThumbShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.rangeSliderTrackShape} /// the [RangeSlider]'s thumb.
/// {@macro flutter.material.SliderTheme.rangeSliderValueIndicatorShape} /// * [RangeSliderTrackShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.sliderComponentShape} /// the [RangeSlider]'s track.
/// * [RangeSliderValueIndicatorShape], which can be used to create custom
/// shapes for the [RangeSlider]'s value indicator.
/// * [SliderComponentShape], which can be used to create custom shapes for
/// the [Slider]'s thumb, overlay, and value indicator and the
/// [RangeSlider]'s overlay.
abstract class RangeSliderTickMarkShape { abstract class RangeSliderTickMarkShape {
/// This abstract const constructor enables subclasses to provide /// This abstract const constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions. /// const constructors so that they can be used in const expressions.
@ -1333,10 +1348,15 @@ abstract class RangeSliderTickMarkShape {
/// ///
/// * [RoundedRectRangeSliderTrackShape] for the default [RangeSlider]'s track /// * [RoundedRectRangeSliderTrackShape] for the default [RangeSlider]'s track
/// shape that paints a stadium-like track. /// shape that paints a stadium-like track.
/// {@macro flutter.material.SliderTheme.rangeSliderTickMarkShape} /// * [RangeSliderTickMarkShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.rangeSliderThumbShape} /// the [RangeSlider]'s tick marks.
/// {@macro flutter.material.SliderTheme.rangeSliderValueIndicatorShape} /// * [RangeSliderThumbShape], which can be used to create custom shapes for
/// {@macro flutter.material.SliderTheme.sliderComponentShape} /// the [RangeSlider]'s thumb.
/// * [RangeSliderValueIndicatorShape], which can be used to create custom
/// shapes for the [RangeSlider]'s value indicator.
/// * [SliderComponentShape], which can be used to create custom shapes for
/// the [Slider]'s thumb, overlay, and value indicator and the
/// [RangeSlider]'s overlay.
abstract class RangeSliderTrackShape { abstract class RangeSliderTrackShape {
/// This abstract const constructor enables subclasses to provide /// This abstract const constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions. /// const constructors so that they can be used in const expressions.
@ -1486,7 +1506,8 @@ mixin BaseSliderTrackShape {
/// * [Slider], for the component that is meant to display this shape. /// * [Slider], for the component that is meant to display this shape.
/// * [SliderThemeData], where an instance of this class is set to inform the /// * [SliderThemeData], where an instance of this class is set to inform the
/// slider of the visual details of the its track. /// slider of the visual details of the its track.
/// {@macro flutter.material.SliderTheme.sliderTrackShape} /// * [SliderTrackShape], which can be used to create custom shapes for the
/// [Slider]'s track.
/// * [RoundedRectSliderTrackShape], for a similar track with rounded edges. /// * [RoundedRectSliderTrackShape], for a similar track with rounded edges.
class RectangularSliderTrackShape extends SliderTrackShape with BaseSliderTrackShape { class RectangularSliderTrackShape extends SliderTrackShape with BaseSliderTrackShape {
/// Creates a slider track that draws 2 rectangles. /// Creates a slider track that draws 2 rectangles.
@ -1602,7 +1623,8 @@ class RectangularSliderTrackShape extends SliderTrackShape with BaseSliderTrackS
/// * [Slider], for the component that is meant to display this shape. /// * [Slider], for the component that is meant to display this shape.
/// * [SliderThemeData], where an instance of this class is set to inform the /// * [SliderThemeData], where an instance of this class is set to inform the
/// slider of the visual details of the its track. /// slider of the visual details of the its track.
/// {@macro flutter.material.SliderTheme.sliderTrackShape} /// * [SliderTrackShape], which can be used to create custom shapes for the
/// [Slider]'s track.
/// * [RectangularSliderTrackShape], for a similar track with sharp edges. /// * [RectangularSliderTrackShape], for a similar track with sharp edges.
class RoundedRectSliderTrackShape extends SliderTrackShape with BaseSliderTrackShape { class RoundedRectSliderTrackShape extends SliderTrackShape with BaseSliderTrackShape {
/// Create a slider track that draws two rectangles with rounded outer edges. /// Create a slider track that draws two rectangles with rounded outer edges.
@ -1717,7 +1739,8 @@ class RoundedRectSliderTrackShape extends SliderTrackShape with BaseSliderTrackS
/// * [RangeSlider], for the component that is meant to display this shape. /// * [RangeSlider], for the component that is meant to display this shape.
/// * [SliderThemeData], where an instance of this class is set to inform the /// * [SliderThemeData], where an instance of this class is set to inform the
/// slider of the visual details of the its track. /// slider of the visual details of the its track.
/// {@macro flutter.material.SliderTheme.rangeSliderTrackShape} /// * [RangeSliderTrackShape], which can be used to create custom shapes for
/// the [RangeSlider]'s track.
/// * [RoundedRectRangeSliderTrackShape], for a similar track with rounded /// * [RoundedRectRangeSliderTrackShape], for a similar track with rounded
/// edges. /// edges.
class RectangularRangeSliderTrackShape extends RangeSliderTrackShape { class RectangularRangeSliderTrackShape extends RangeSliderTrackShape {
@ -1845,7 +1868,8 @@ class RectangularRangeSliderTrackShape extends RangeSliderTrackShape {
/// * [RangeSlider], for the component that is meant to display this shape. /// * [RangeSlider], for the component that is meant to display this shape.
/// * [SliderThemeData], where an instance of this class is set to inform the /// * [SliderThemeData], where an instance of this class is set to inform the
/// slider of the visual details of the its track. /// slider of the visual details of the its track.
/// {@macro flutter.material.SliderTheme.rangeSliderTrackShape} /// * [RangeSliderTrackShape], which can be used to create custom shapes for
/// the [RangeSlider]'s track.
/// * [RectangularRangeSliderTrackShape], for a similar track with sharp edges. /// * [RectangularRangeSliderTrackShape], for a similar track with sharp edges.
class RoundedRectRangeSliderTrackShape extends RangeSliderTrackShape { class RoundedRectRangeSliderTrackShape extends RangeSliderTrackShape {
/// Create a slider track with rounded outer edges. /// Create a slider track with rounded outer edges.