[Api docs] Updates ListTile.subtitle docs to address how TextStyle is decided (#61071)
diff --git a/packages/flutter/lib/src/material/list_tile.dart b/packages/flutter/lib/src/material/list_tile.dart index 28b75cb..113411b 100644 --- a/packages/flutter/lib/src/material/list_tile.dart +++ b/packages/flutter/lib/src/material/list_tile.dart
@@ -687,6 +687,21 @@ /// If [isThreeLine] is true, this should be configured to take a maximum of /// two lines. For example, you can use [Text.maxLines] to enforce the number /// of lines. + /// + /// The subtitle's default [TextStyle] depends on [TextTheme.bodyText2] except + /// [TextStyle.color]. The [TextStyle.color] depends on the value of [enabled] + /// and [selected]. + /// + /// When [enabled] is false, the text color is set to [ThemeData.disabledColor]. + /// + /// When [selected] is true, the text color is set to [ListTileTheme.selectedColor] + /// if it's not null. If [ListTileTheme.selectedColor] is null, the text color + /// is set to [ThemeData.primaryColor] when [ThemeData.brightness] is + /// [Brightness.light] and to [ThemeData.accentColor] when it is [Brightness.dark]. + /// + /// When [selected] is false, the text color is set to [ListTileTheme.textColor] + /// if it's not null and to [TextTheme.caption]'s color if [ListTileTheme.textColor] + /// is null. final Widget subtitle; /// A widget to display after the title.