engine-flutter-autoroll
diff --git a/‎packages/flutter/lib/src/widgets/localizations.dart‎
Lines changed: 5 additions & 0 deletions b/‎packages/flutter/lib/src/widgets/localizations.dart‎
Lines changed: 5 additions & 0 deletions
diff --git a/‎packages/flutter/lib/src/widgets/raw_radio.dart‎
Lines changed: 12 additions & 0 deletions b/‎packages/flutter/lib/src/widgets/raw_radio.dart‎
Lines changed: 12 additions & 0 deletions
diff --git a/‎packages/flutter/test/cupertino/radio_test.dart‎
Lines changed: 36 additions & 0 deletions b/‎packages/flutter/test/cupertino/radio_test.dart‎
Lines changed: 36 additions & 0 deletions
diff --git a/‎packages/flutter/test/material/radio_test.dart‎
Lines changed: 49 additions & 0 deletions b/‎packages/flutter/test/material/radio_test.dart‎
Lines changed: 49 additions & 0 deletions
diff --git a/‎packages/flutter/test/widgets/raw_radio_test.dart‎
Lines changed: 72 additions & 1 deletion b/‎packages/flutter/test/widgets/raw_radio_test.dart‎
Lines changed: 72 additions & 1 deletion
@@ -223,6 +223,9 @@ abstract class WidgetsLocalizations {
   /// Label for "share" edit buttons and menu items.
   String get shareButtonLabel;
 
+  /// The accessibility hint for an unselected radio button.
+  String get radioButtonUnselectedLabel;
+
   /// The `WidgetsLocalizations` from the closest [Localizations] instance
   /// that encloses the given context.
   ///
@@ -319,6 +322,8 @@ class DefaultWidgetsLocalizations implements WidgetsLocalizations {
   @override
   String get shareButtonLabel => 'Share';
 
+  @override
+  String get radioButtonUnselectedLabel => 'Not selected';
   @override
   TextDirection get textDirection => TextDirection.ltr;
 
 
@@ -7,6 +7,7 @@ import 'package:flutter/foundation.dart';
 import 'basic.dart';
 import 'focus_manager.dart';
 import 'framework.dart';
+import 'localizations.dart';
 import 'radio_group.dart';
 import 'ticker_provider.dart';
 import 'toggleable.dart';
@@ -192,21 +193,32 @@ class _RawRadioState<T> extends State<RawRadio<T>>
   @override
   Widget build(BuildContext context) {
     final bool? accessibilitySelected;
+    String? semanticsHint;
+
     switch (defaultTargetPlatform) {
       case TargetPlatform.android:
       case TargetPlatform.fuchsia:
       case TargetPlatform.linux:
       case TargetPlatform.windows:
         accessibilitySelected = null;
+        semanticsHint = null;
       case TargetPlatform.iOS:
       case TargetPlatform.macOS:
         accessibilitySelected = value;
+        // Only provide hint for unselected radio buttons to avoid duplication
+        // of the selected state announcement.
+        // Selected state is already announced by iOS via the 'selected' property.
+        if (!(value ?? false)) {
+          final WidgetsLocalizations localizations = WidgetsLocalizations.of(context);
+          semanticsHint = localizations.radioButtonUnselectedLabel;
+        }
     }
 
     return Semantics(
       inMutuallyExclusiveGroup: true,
       checked: value,
       selected: accessibilitySelected,
+      hint: semanticsHint,
       child: buildToggleableWithChild(
         focusNode: focusNode,
         autofocus: widget.autofocus,
 
@@ -926,6 +926,42 @@ void main() {
       kIsWeb ? SystemMouseCursors.click : SystemMouseCursors.basic,
     );
   });
+
+  // Regression tests for https://github.com/flutter/flutter/issues/170422
+  group('Radio accessibility announcements on various platforms', () {
+    testWidgets('Unselected radio should be vocalized via hint on iOS/macOS platform', (
+      WidgetTester tester,
+    ) async {
+      const WidgetsLocalizations localizations = DefaultWidgetsLocalizations();
+      await tester.pumpWidget(
+        CupertinoApp(
+          home: Center(child: CupertinoRadio<int>(value: 2, groupValue: 1, onChanged: (int? i) {})),
+        ),
+      );
+
+      final SemanticsNode semanticNode = tester.getSemantics(find.byType(Focus).last);
+      if (defaultTargetPlatform == TargetPlatform.iOS ||
+          defaultTargetPlatform == TargetPlatform.macOS) {
+        expect(semanticNode.hint, localizations.radioButtonUnselectedLabel);
+      } else {
+        expect(semanticNode.hint, anyOf(isNull, isEmpty));
+      }
+    });
+
+    testWidgets('Selected radio should be vocalized via the selected flag on all platforms', (
+      WidgetTester tester,
+    ) async {
+      await tester.pumpWidget(
+        CupertinoApp(
+          home: Center(child: CupertinoRadio<int>(value: 1, groupValue: 1, onChanged: (int? i) {})),
+        ),
+      );
+
+      final SemanticsNode semanticNode = tester.getSemantics(find.byType(Focus).last);
+      // Radio semantics should not have hint.
+      expect(semanticNode.hint, anyOf(isNull, isEmpty));
+    });
+  });
 }
 
 class _RadioMouseCursor extends WidgetStateMouseCursor {
 
@@ -2723,4 +2723,53 @@ void main() {
 
     focusNode.dispose();
   });
+
+  // Regression tests for https://github.com/flutter/flutter/issues/170422
+  group('Radio accessibility announcements on various platforms', () {
+    testWidgets('Unselected radio should be vocalized via hint on iOS/macOS platform', (
+      WidgetTester tester,
+    ) async {
+      const WidgetsLocalizations localizations = DefaultWidgetsLocalizations();
+      await tester.pumpWidget(
+        MaterialApp(
+          theme: theme,
+          home: Material(
+            child: RadioGroup<int>(
+              groupValue: 2,
+              onChanged: (int? value) {},
+              child: const Radio<int>(value: 1),
+            ),
+          ),
+        ),
+      );
+      final SemanticsNode semanticNode = tester.getSemantics(find.byType(Focus).last);
+      if (defaultTargetPlatform == TargetPlatform.iOS ||
+          defaultTargetPlatform == TargetPlatform.macOS) {
+        expect(semanticNode.hint, localizations.radioButtonUnselectedLabel);
+      } else {
+        expect(semanticNode.hint, anyOf(isNull, isEmpty));
+      }
+    });
+
+    testWidgets('Selected radio should be vocalized via the selected flag on all platforms', (
+      WidgetTester tester,
+    ) async {
+      await tester.pumpWidget(
+        MaterialApp(
+          theme: theme,
+          home: Material(
+            child: RadioGroup<int>(
+              groupValue: 1,
+              onChanged: (int? value) {},
+              child: const Radio<int>(value: 1),
+            ),
+          ),
+        ),
+      );
+
+      final SemanticsNode semanticNode = tester.getSemantics(find.byType(Focus).last);
+      // Radio semantics should not have hint.
+      expect(semanticNode.hint, anyOf(isNull, isEmpty));
+    });
+  });
 }
@@ -7,7 +7,9 @@
 @Tags(<String>['reduced-test-set'])
 library;
 
-import 'package:flutter/widgets.dart';
+import 'package:flutter/foundation.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter/semantics.dart';
 import 'package:flutter_test/flutter_test.dart';
 
 void main() {
@@ -96,6 +98,75 @@ void main() {
 
     await expectLater(() => tester.pumpWidget(buildWidget()), throwsAssertionError);
   });
+
+  // Regression tests for https://github.com/flutter/flutter/issues/170422
+  group('Raw Radio accessibility announcements on various platforms', () {
+    testWidgets('Unselected radio should be vocalized via hint on iOS/macOS platform', (
+      WidgetTester tester,
+    ) async {
+      final TestRegistry<int> registry = TestRegistry<int>();
+      registry.groupValue = 2; // To mark radio as unselected.
+      const WidgetsLocalizations localizations = DefaultWidgetsLocalizations();
+      final FocusNode node = FocusNode();
+      addTearDown(node.dispose);
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: RawRadio<int>(
+            value: 1,
+            mouseCursor: WidgetStateProperty.all<MouseCursor>(SystemMouseCursors.click),
+            toggleable: false,
+            focusNode: node,
+            autofocus: false,
+            enabled: true,
+            groupRegistry: registry,
+            builder: (BuildContext context, ToggleableStateMixin state) {
+              return const SizedBox.square(dimension: 24);
+            },
+          ),
+        ),
+      );
+
+      final SemanticsNode semanticNode = tester.getSemantics(find.byType(RawRadio<int>));
+      // Radio semantics should have hint.
+      if (defaultTargetPlatform == TargetPlatform.iOS ||
+          defaultTargetPlatform == TargetPlatform.macOS) {
+        expect(semanticNode.hint, localizations.radioButtonUnselectedLabel);
+      } else {
+        expect(semanticNode.hint, anyOf(isNull, isEmpty));
+      }
+    });
+
+    testWidgets('Selected radio should be vocalized via the selected flag on all platforms', (
+      WidgetTester tester,
+    ) async {
+      final TestRegistry<int> registry = TestRegistry<int>();
+      registry.groupValue = 1; // To mark radio as selected.
+      final FocusNode node = FocusNode();
+      addTearDown(node.dispose);
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: RawRadio<int>(
+            value: 1,
+            mouseCursor: WidgetStateProperty.all<MouseCursor>(SystemMouseCursors.click),
+            toggleable: false,
+            focusNode: node,
+            autofocus: false,
+            enabled: true,
+            groupRegistry: registry,
+            builder: (BuildContext context, ToggleableStateMixin state) {
+              return const SizedBox.square(dimension: 24);
+            },
+          ),
+        ),
+      );
+
+      final SemanticsNode semantics = tester.getSemantics(find.byType(RawRadio<int>));
+      // Radio semantics should not have hint.
+      expect(semantics.hint, anyOf(isNull, isEmpty));
+    });
+  });
 }
 
 class TestRegistry<T> extends RadioGroupRegistry<T> {