Added ListTile.titleAlignment, ListTileThemeData.titleAlignment (#119872)

* added ListTile.textAlignment

* changed titlesHeight to titleHeight

* fixed a typo

* Add tests and example

* Update tests

* update example test

---------

Co-authored-by: tahatesser <[email protected]>

Author: HansMuller

examples/api/lib/material/list_tile/list_tile.4.dart

@@ -0,0 +1,83 @@
+// 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 [ListTile].
+
+import 'package:flutter/material.dart';
+
+void main() => runApp(const ListTileApp());
+
+class ListTileApp extends StatelessWidget {
+  const ListTileApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      theme: ThemeData(useMaterial3: true),
+      home: const ListTileExample(),
+    );
+  }
+}
+
+class ListTileExample extends StatefulWidget {
+  const ListTileExample({super.key});
+
+  @override
+  State<ListTileExample> createState() => _ListTileExampleState();
+}
+
+class _ListTileExampleState extends State<ListTileExample> {
+  ListTileTitleAlignment? titleAlignment;
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('ListTile.titleAlignment Sample')),
+      body: Column(
+        children: <Widget>[
+          const Divider(),
+          ListTile(
+            titleAlignment: titleAlignment,
+            leading: Checkbox(
+              value: true,
+              onChanged:(bool? value) { },
+            ),
+            title: const Text('Headline Text'),
+            subtitle: const Text('Tapping on the trailing widget will show a menu that allows you to change the title alignment. The title alignment is set to threeLine by default if `ThemeData.useMaterial3` is true. Otherwise, defaults to titleHeight.'),
+            trailing: PopupMenuButton<ListTileTitleAlignment>(
+              onSelected: (ListTileTitleAlignment? value) {
+                setState(() {
+                  titleAlignment = value;
+                });
+              },
+              itemBuilder: (BuildContext context) => <PopupMenuEntry<ListTileTitleAlignment>>[
+                const PopupMenuItem<ListTileTitleAlignment>(
+                  value: ListTileTitleAlignment.threeLine,
+                  child: Text('threeLine'),
+                ),
+                const PopupMenuItem<ListTileTitleAlignment>(
+                  value: ListTileTitleAlignment.titleHeight,
+                  child: Text('titleHeight'),
+                ),
+                const PopupMenuItem<ListTileTitleAlignment>(
+                  value: ListTileTitleAlignment.top,
+                  child: Text('top'),
+                ),
+                const PopupMenuItem<ListTileTitleAlignment>(
+                  value: ListTileTitleAlignment.center,
+                  child: Text('center'),
+                ),
+                const PopupMenuItem<ListTileTitleAlignment>(
+                  value: ListTileTitleAlignment.bottom,
+                  child: Text('bottom'),
+                ),
+              ],
+            ),
+          ),
+          const Divider(),
+        ],
+      ),
+    );
+  }
+}

examples/api/test/material/list_tile/list_tile.4_test.dart

@@ -0,0 +1,51 @@
+// 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.
+
+import 'package:flutter/material.dart';
+import 'package:flutter_api_samples/material/list_tile/list_tile.4.dart' as example;
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+  testWidgets('Can choose different title aligments from popup menu', (WidgetTester tester) async {
+    await tester.pumpWidget(
+      const example.ListTileApp(),
+    );
+
+    Offset titleOffset = tester.getTopLeft(find.text('Headline Text'));
+    Offset leadingOffset = tester.getTopLeft(find.byType(Checkbox));
+    Offset trailingOffset = tester.getTopRight(find.byIcon(Icons.adaptive.more));
+
+    // The default title alignment is threeLine.
+    expect(leadingOffset.dy - titleOffset.dy, 48.0);
+    expect(trailingOffset.dy - titleOffset.dy, 60.0);
+
+    await tester.tap(find.byIcon(Icons.adaptive.more));
+    await tester.pumpAndSettle();
+
+    // Change the title alignment to titleHeight.
+    await tester.tap(find.text('titleHeight'));
+    await tester.pumpAndSettle();
+
+    titleOffset = tester.getTopLeft(find.text('Headline Text'));
+    leadingOffset = tester.getTopLeft(find.byType(Checkbox));
+    trailingOffset = tester.getTopRight(find.byIcon(Icons.adaptive.more));
+
+    expect(leadingOffset.dy - titleOffset.dy, 8.0);
+    expect(trailingOffset.dy - titleOffset.dy, 20.0);
+
+    await tester.tap(find.byIcon(Icons.adaptive.more));
+    await tester.pumpAndSettle();
+
+    // Change the title alignment to bottom.
+    await tester.tap(find.text('bottom'));
+    await tester.pumpAndSettle();
+
+    titleOffset = tester.getTopLeft(find.text('Headline Text'));
+    leadingOffset = tester.getTopLeft(find.byType(Checkbox));
+    trailingOffset = tester.getTopRight(find.byIcon(Icons.adaptive.more));
+
+    expect(leadingOffset.dy - titleOffset.dy, 96.0);
+    expect(trailingOffset.dy - titleOffset.dy, 108.0);
+  });
+}