From 973f8e2d83707eb386712f0547f51caedd38fc4d Mon Sep 17 00:00:00 2001
From: zhongliugo <zhongliu88889@gmail.com>
Date: Tue, 13 Oct 2026 20:40:49 +0000
Subject: [PATCH 1/3] [material_ui] Declare input purpose on a11y_assessments
 text fields

---
 .../lib/use_cases/text_field.dart             |  8 +++++--
 .../lib/use_cases/text_field_password.dart    |  2 ++
 .../test/text_field_password_test.dart        | 11 ++++++++++
 .../test/text_field_test.dart                 | 22 +++++++++++++++++++
 4 files changed, 41 insertions(+), 2 deletions(-)

diff --git a/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart b/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
index 717574debd33..13c8f81f7c1b 100644
--- a/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
+++ b/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
@@ -37,11 +37,13 @@ class _MainWidget extends StatelessWidget {
             label: 'Input field with suffix @gmail.com',
             child: const TextField(
               key: Key('enabled text field'),
-              maxLines: null,
+              keyboardType: TextInputType.emailAddress,
+              autofillHints: <String>[AutofillHints.email],
               decoration: InputDecoration(
                 labelText: 'Email',
                 suffixText: '@gmail.com',
                 hintText: 'Enter your email',
+                hintMaxLines: 5,
               ),
             ),
           ),
@@ -49,11 +51,13 @@ class _MainWidget extends StatelessWidget {
             label: 'Input field with suffix @gmail.com',
             child: TextField(
               key: const Key('disabled text field'),
-              maxLines: null,
+              keyboardType: TextInputType.emailAddress,
+              autofillHints: const <String>[AutofillHints.email],
               decoration: const InputDecoration(
                 labelText: 'Email',
                 suffixText: '@gmail.com',
                 hintText: 'Enter your email',
+                hintMaxLines: 5,
               ),
               enabled: false,
               controller: TextEditingController(text: 'xyz'),
diff --git a/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field_password.dart b/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field_password.dart
index d1e07f5d0de2..9ee4fa65b3a8 100644
--- a/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field_password.dart
+++ b/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field_password.dart
@@ -35,11 +35,13 @@ class _MainWidget extends StatelessWidget {
         children: const <Widget>[
           TextField(
             key: Key('enabled password'),
+            autofillHints: <String>[AutofillHints.password],
             decoration: InputDecoration(labelText: 'Password'),
             obscureText: true,
           ),
           TextField(
             key: Key('disabled password'),
+            autofillHints: <String>[AutofillHints.password],
             decoration: InputDecoration(labelText: 'Password'),
             enabled: false,
             obscureText: true,
diff --git a/packages/material_ui/test_apps/a11y_assessments/test/text_field_password_test.dart b/packages/material_ui/test_apps/a11y_assessments/test/text_field_password_test.dart
index b5e82e7e8981..8d408af09da1 100644
--- a/packages/material_ui/test_apps/a11y_assessments/test/text_field_password_test.dart
+++ b/packages/material_ui/test_apps/a11y_assessments/test/text_field_password_test.dart
@@ -56,4 +56,15 @@ void main() {
     await tester.pumpAndSettle();
     expect(findHeadingLevelOnes, findsOne);
   });
+
+  testWidgets('password fields expose their input purpose', (WidgetTester tester) async {
+    await pumpsUseCase(tester, TextFieldPasswordUseCase());
+
+    for (final key in <Key>[const Key('enabled password'), const Key('disabled password')]) {
+      final EditableText editableText = tester.widget<EditableText>(
+        find.descendant(of: find.byKey(key), matching: find.byType(EditableText)),
+      );
+      expect(editableText.autofillHints, contains(AutofillHints.password));
+    }
+  });
 }
diff --git a/packages/material_ui/test_apps/a11y_assessments/test/text_field_test.dart b/packages/material_ui/test_apps/a11y_assessments/test/text_field_test.dart
index 686cbdff9c93..de9485f17652 100644
--- a/packages/material_ui/test_apps/a11y_assessments/test/text_field_test.dart
+++ b/packages/material_ui/test_apps/a11y_assessments/test/text_field_test.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.
 
+import 'dart:ui' show SemanticsInputType;
+
 import 'package:a11y_assessments/use_cases/text_field.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:material_ui/material_ui.dart';
@@ -71,4 +73,24 @@ void main() {
     await tester.pumpAndSettle();
     expect(findHeadingLevelOnes, findsOne);
   });
+
+  testWidgets('email text fields expose their input purpose', (WidgetTester tester) async {
+    await pumpsUseCase(tester, TextFieldUseCase());
+    await tester.pumpAndSettle();
+
+    for (final key in <Key>[const Key('enabled text field'), const Key('disabled text field')]) {
+      final Finder finder = find.byKey(key);
+      // On web, a single-line field with the email input type renders an
+      // <input autocomplete="email">. A multiline field renders a <textarea>
+      // with autocomplete="off".
+      expect(
+        tester.getSemantics(finder),
+        containsSemantics(inputType: SemanticsInputType.email, isMultiline: false),
+      );
+      final EditableText editableText = tester.widget<EditableText>(
+        find.descendant(of: finder, matching: find.byType(EditableText)),
+      );
+      expect(editableText.autofillHints, contains(AutofillHints.email));
+    }
+  });
 }

From 936fd9364d363e18f2d3987bd29ea1d403c0b94a Mon Sep 17 00:00:00 2001
From: zhongliugo <zhongliu88889@gmail.com>
Date: Tue, 13 Oct 2026 22:18:55 +0000
Subject: [PATCH 2/3] [material_ui] Cap a11y_assessments email hint at one line
 per word

---
 .../a11y_assessments/lib/use_cases/text_field.dart        | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart b/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
index 13c8f81f7c1b..fc0d9e7cb7e0 100644
--- a/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
+++ b/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
@@ -43,7 +43,9 @@ class _MainWidget extends StatelessWidget {
                 labelText: 'Email',
                 suffixText: '@gmail.com',
                 hintText: 'Enter your email',
-                hintMaxLines: 5,
+                // The field is single-line, so let the hint wrap at large
+                // text scales, one line per word.
+                hintMaxLines: 3,
               ),
             ),
           ),
@@ -57,7 +59,9 @@ class _MainWidget extends StatelessWidget {
                 labelText: 'Email',
                 suffixText: '@gmail.com',
                 hintText: 'Enter your email',
-                hintMaxLines: 5,
+                // The field is single-line, so let the hint wrap at large
+                // text scales, one line per word.
+                hintMaxLines: 3,
               ),
               enabled: false,
               controller: TextEditingController(text: 'xyz'),

From 0675f4bed3122976e46861265fe7ac0ab4f4f20b Mon Sep 17 00:00:00 2001
From: zhongliugo <zhongliu88889@gmail.com>
Date: Fri, 16 Oct 2026 20:52:55 +0000
Subject: [PATCH 3/3] [material_ui] Drop the email suffix from a11y_assessments
 text fields

---
 .../lib/use_cases/text_field.dart             | 52 ++++++++-----------
 .../test/text_field_test.dart                 | 21 ++++----
 2 files changed, 32 insertions(+), 41 deletions(-)

diff --git a/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart b/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
index fc0d9e7cb7e0..ef3022cb2642 100644
--- a/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
+++ b/packages/material_ui/test_apps/a11y_assessments/lib/use_cases/text_field.dart
@@ -33,39 +33,31 @@ class _MainWidget extends StatelessWidget {
       appBar: AppBar(title: Semantics(headingLevel: 1, child: Text('$pageTitle Demo'))),
       body: ListView(
         children: <Widget>[
-          Semantics(
-            label: 'Input field with suffix @gmail.com',
-            child: const TextField(
-              key: Key('enabled text field'),
-              keyboardType: TextInputType.emailAddress,
-              autofillHints: <String>[AutofillHints.email],
-              decoration: InputDecoration(
-                labelText: 'Email',
-                suffixText: '@gmail.com',
-                hintText: 'Enter your email',
-                // The field is single-line, so let the hint wrap at large
-                // text scales, one line per word.
-                hintMaxLines: 3,
-              ),
+          const TextField(
+            key: Key('enabled text field'),
+            keyboardType: TextInputType.emailAddress,
+            autofillHints: <String>[AutofillHints.email],
+            decoration: InputDecoration(
+              labelText: 'Email',
+              hintText: 'Enter your email',
+              // The field is single-line, so let the hint wrap at large
+              // text scales, one line per word.
+              hintMaxLines: 3,
             ),
           ),
-          Semantics(
-            label: 'Input field with suffix @gmail.com',
-            child: TextField(
-              key: const Key('disabled text field'),
-              keyboardType: TextInputType.emailAddress,
-              autofillHints: const <String>[AutofillHints.email],
-              decoration: const InputDecoration(
-                labelText: 'Email',
-                suffixText: '@gmail.com',
-                hintText: 'Enter your email',
-                // The field is single-line, so let the hint wrap at large
-                // text scales, one line per word.
-                hintMaxLines: 3,
-              ),
-              enabled: false,
-              controller: TextEditingController(text: 'xyz'),
+          TextField(
+            key: const Key('disabled text field'),
+            keyboardType: TextInputType.emailAddress,
+            autofillHints: const <String>[AutofillHints.email],
+            decoration: const InputDecoration(
+              labelText: 'Email',
+              hintText: 'Enter your email',
+              // The field is single-line, so let the hint wrap at large
+              // text scales, one line per word.
+              hintMaxLines: 3,
             ),
+            enabled: false,
+            controller: TextEditingController(text: 'xyz'),
           ),
         ],
       ),
diff --git a/packages/material_ui/test_apps/a11y_assessments/test/text_field_test.dart b/packages/material_ui/test_apps/a11y_assessments/test/text_field_test.dart
index de9485f17652..363cca3c8e68 100644
--- a/packages/material_ui/test_apps/a11y_assessments/test/text_field_test.dart
+++ b/packages/material_ui/test_apps/a11y_assessments/test/text_field_test.dart
@@ -5,6 +5,7 @@
 import 'dart:ui' show SemanticsInputType;
 
 import 'package:a11y_assessments/use_cases/text_field.dart';
+import 'package:flutter/rendering.dart' show RenderParagraph;
 import 'package:flutter_test/flutter_test.dart';
 import 'package:material_ui/material_ui.dart';
 
@@ -34,6 +35,11 @@ void main() {
   });
 
   testWidgets('font size increase does not ellipsize hint text', (WidgetTester tester) async {
+    // A narrow view forces the hint to wrap at 3x text scale.
+    tester.view.physicalSize = const Size(320, 640);
+    tester.view.devicePixelRatio = 1.0;
+    addTearDown(tester.view.reset);
+
     await pumpsUseCase(tester, TextFieldUseCase());
     await tester.pumpWidget(
       MaterialApp(
@@ -53,20 +59,13 @@ void main() {
       final Finder finder = find.byKey(const Key('enabled text field'));
       await tester.tap(finder);
       await tester.pumpAndSettle();
-      final Size size = tester.getSize(finder);
-      // Should have a multi-line height.
-      expect(size.height, 280);
+      final RenderParagraph hint = tester.renderObject<RenderParagraph>(
+        find.descendant(of: finder, matching: find.text('Enter your email')),
+      );
+      expect(hint.didExceedMaxLines, isFalse);
     }
   });
 
-  testWidgets('text field wrapper exists', (WidgetTester tester) async {
-    await pumpsUseCase(tester, TextFieldUseCase());
-    const textFieldLabel = 'Input field with suffix @gmail.com';
-
-    final Finder semanticsWidgets = find.bySemanticsLabel(RegExp(textFieldLabel));
-    expect(semanticsWidgets, findsExactly(2));
-  });
-
   testWidgets('text field demo page has one h1 tag', (WidgetTester tester) async {
     await pumpsUseCase(tester, TextFieldUseCase());
     final Finder findHeadingLevelOnes = find.bySemanticsLabel('TextField Demo');