Add new motion accessibility features to iOS. by ksokolovskyi · Pull Request #178102 · flutter/flutter

ksokolovskyi · 2025-11-06T09:59:43Z

Closes #177330
Contributes to #175878

Description

This PR implements support for three new iOS accessibility motion features.

Auto-Play Animated Images: Informs the app when the user has chosen to pause automatically playing GIFs and other animated content.
Auto-Play Video Previews: Informs the app when the user has disabled the automatic playback of video previews.
Prefer Non-Blinking Cursor: Informs the app that the user prefers a non-blinking text insertion indicator in editable text fields.

The original issue requested seven features. I was able to find and implement features with clear, public, and general-purpose APIs.

The remaining features were not included for the following reasons:

Vehicle Motion Cues: No public API found.
Auto-Play Message Effects: No public API found. This is likely a feature exclusive to the Messages framework.
Limit Frame Rate: No public API found.
Dim Flashing Lights: There is a public API available MADimFlashingLightsEnabled. It is intended for media playback frameworks. It's unclear if exposing this feature is necessary or actionable for a general-purpose application UI.

Feature Name	API	Flutter AccessibilityFeatures
Vehicle Motion Cues	-	-
Dim Flashing Lights	MADimFlashingLightsEnabled	-
Auto-Play Animated Images	animatedImagesEnabled	autoPlayAnimatedImages
Auto-Play Video Previews	isVideoAutoplayEnabled	autoPlayVideos
Auto-Play Message Effects	-	-
Prefer Non-Blinking Cursor	prefersNonBlinkingTextInsertionIndicator	deterministicCursor
Limit Frame Rate	-	-

The AccessibilityFeatures.swift was introduced to refactor all native iOS accessibility logic into a single, dedicated class. This change moves the responsibility of querying settings and observing notifications out of FlutterViewController.mm, which cleans up the controller, simplifies future maintenance, and makes logic unit-testable.

Demo

accessibility_features.mp4

Code sample

import 'package:flutter/material.dart';

void main() {
  runApp(
    MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Screen(),
    ),
  );
}

class Screen extends StatefulWidget {
  @override
  State<Screen> createState() => _ScreenState();
}

class _ScreenState extends State<Screen> with WidgetsBindingObserver {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void didChangeAccessibilityFeatures() {
    super.didChangeAccessibilityFeatures();
    if (mounted) {
      setState(() {});
    }
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    final accessibilityFeatures = View.of(
      context,
    ).platformDispatcher.accessibilityFeatures;

    return Scaffold(
      body: Center(
        child: Column(
          spacing: 10,
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            for (final feature in [
              'accessibleNavigation: ${accessibilityFeatures.accessibleNavigation}',
              'invertColors: ${accessibilityFeatures.invertColors}',
              'disableAnimations: ${accessibilityFeatures.disableAnimations}',
              'boldText: ${accessibilityFeatures.boldText}',
              'reduceMotion: ${accessibilityFeatures.reduceMotion}',
              'highContrast: ${accessibilityFeatures.highContrast}',
              'onOffSwitchLabels: ${accessibilityFeatures.onOffSwitchLabels}',
              'supportsAnnounce: ${accessibilityFeatures.supportsAnnounce}',
              'autoPlayAnimatedImages: ${accessibilityFeatures.autoPlayAnimatedImages}',
              'autoPlayVideos: ${accessibilityFeatures.autoPlayVideos}',
              'deterministicCursor: ${accessibilityFeatures.deterministicCursor}',
            ])
              Text(feature),
          ],
        ),
      ),
    );
  }
}

Pre-launch Checklist

I read the Contributor Guide and followed the process outlined there for submitting PRs.
I read the Tree Hygiene wiki page, which explains my responsibilities.
I read and followed the Flutter Style Guide, including Features we expect every widget to implement.
I signed the CLA.
I listed at least one issue that this PR fixes in the description above.
I updated/added relevant documentation (doc comments with ///).
I added new tests to check the change I am making, or this PR is test-exempt.
I followed the breaking change policy and added Data Driven Fixes where supported.
All existing and new tests are passing.

gemini-code-assist

Code Review

This pull request introduces support for new iOS accessibility features: autoPlayAnimatedImages, autoPlayVideoPreviews, and nonBlinkingCursor. The implementation includes a good refactoring of the iOS accessibility feature handling by introducing a new AccessibilityFeatures.swift class, which encapsulates the logic for querying native accessibility settings. This improves code organization and readability. The changes are consistently applied across different parts of the engine. I have one suggestion to improve the clarity of the public embedder API. Also, the table in the pull request description seems to be a placeholder and could be filled out.

engine/src/flutter/shell/platform/embedder/embedder.h

engine/src/flutter/shell/platform/darwin/ios/framework/Headers/FlutterViewController.h

LouiseHsu · 2025-11-10T20:09:50Z

engine/src/flutter/shell/platform/darwin/ios/framework/Source/AccessibilityFeatures.swift

@@ -0,0 +1,217 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.


While this is quite nice and clean, is there a reason we are doing this pretty significant refactoring in this PR? it seems a bit out of scope, for this feature.

Also tagging @hannah-hyj who I seem to remember did some work refactoring accessibility flags for potential input

Thanks for taking a look at this PR!

The new iOS 18 features require Apple's AccessibilitySettings API, which is Swift-only.

Since I had to add a Swift file to use this new API, I chose to consolidate all accessibility logic into it. The alternative would have been to split the logic across both FlutterViewController.m and this new Swift file, which felt less maintainable.

This approach keeps all related code in one place and makes the logic testable. Happy to discuss splitting it out if you still think it's best.

engine/src/flutter/lib/ui/window/platform_configuration.h

chunhtai · 2025-11-17T18:43:46Z

engine/src/flutter/lib/ui/window.dart

+  /// Always returns `true` on other platforms.
+  // This index check is inverted (== 0 vs != 0) since most of the platforms
+  // don't have an option to disable animated images auto play.
+  bool get autoPlayAnimatedImages => _kNoAutoPlayAnimatedImagesIndex & _index == 0;


Does this also apply to gifs? If so we may need to wire this up to image widget. but that should probably be a separate PR cc @justinmc since you worked on that widget recently

Looks like yes this is for gifs: https://developer.apple.com/documentation/accessibility/animated-images

I've created an issue: #180395

engine/src/flutter/shell/platform/darwin/ios/framework/Source/AccessibilityFeatures.swift

chunhtai · 2025-12-30T22:00:48Z

google test failure doesn't seem related, @ksokolovskyi can you try rebase again?

LouiseHsu

ios parts lgtm!

chrisbobbe · 2026-01-08T21:45:37Z

Thanks everyone! 🎉

…r#178102)

Roll Flutter from 01d37bc to 73769a2 (65 revisions) flutter/flutter@01d37bc...73769a2 2026-01-10 [email protected] Roll Dart SDK from 5e855c2bb3ef to 87fbfd5381b6 (1 revision) (flutter/flutter#180800) 2026-01-10 [email protected] Roll Skia from b2b109f0e980 to f39cc645b1dd (2 revisions) (flutter/flutter#180796) 2026-01-10 [email protected] Roll Dart SDK from b7963905e6a2 to 5e855c2bb3ef (2 revisions) (flutter/flutter#180794) 2026-01-10 [email protected] Make sure that a CupertinoTabScaffold doesn't crash in 0x0 environment (flutter/flutter#179824) 2026-01-10 [email protected] Roll Dart SDK from d25ad331b7ea to b7963905e6a2 (2 revisions) (flutter/flutter#180783) 2026-01-10 [email protected] Make sure that a Container doesn't crash in 0x0 environment (flutter/flutter#180350) 2026-01-10 [email protected] Make sure that an Expansible doesn't crash in 0x0 environment (flutter/flutter#180478) 2026-01-10 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Enabled some disabled impeller fragment shader dart tests (#180759)" (flutter/flutter#180785) 2026-01-09 [email protected] Merge `widget_tester_leaks_free_test.dart` into `widget_tester_test.dart` (flutter/flutter#180600) 2026-01-09 [email protected] fix: there are no riscv fuchsia artifacts (flutter/flutter#180779) 2026-01-09 [email protected] Roll Skia from 7386219151e6 to b2b109f0e980 (1 revision) (flutter/flutter#180771) 2026-01-09 [email protected] Re-prioritize pipeline compile jobs and perform them eagerly instead of waiting. (flutter/flutter#180022) 2026-01-09 [email protected] Enabled some disabled impeller fragment shader dart tests (flutter/flutter#180759) 2026-01-09 [email protected] Roll Fuchsia Linux SDK from rxeg-6UB678HKJ4UQ... to 83Favz_zzMzdVuOHg... (flutter/flutter#180765) 2026-01-09 [email protected] [A11y ] Add `clearSemantics`in table (flutter/flutter#180665) 2026-01-09 [email protected] Update CODEOWNERS to remove chinmaygarde. (flutter/flutter#180703) 2026-01-09 [email protected] [ Tool ] Add support for linux riscv64 architecture (flutter/flutter#178711) 2026-01-09 [email protected] Roll Skia from e9b3264ade0c to 7386219151e6 (12 revisions) (flutter/flutter#180754) 2026-01-09 [email protected] Roll Dart SDK from fe2ba2c5dd50 to d25ad331b7ea (10 revisions) (flutter/flutter#180741) 2026-01-09 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Unpin google_mobile_ads (#180573)" (flutter/flutter#180761) 2026-01-09 [email protected] Fix typo in dropdown_menu.dart (flutter/flutter#180172) 2026-01-09 [email protected] Roll Packages from 039a026 to 51fe1d9 (1 revision) (flutter/flutter#180742) 2026-01-09 [email protected] Unpin google_mobile_ads (flutter/flutter#180573) 2026-01-09 [email protected] Update flutter changelog for 3.38.6 (flutter/flutter#180708) 2026-01-08 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Fix iOS xattr removal to clear all extended attributes (#180355)" (flutter/flutter#180709) 2026-01-08 [email protected] Make sure that an EditableText doesn't crash in 0x0 environment (flutter/flutter#180457) 2026-01-08 [email protected] Implementation of tooltip windows for win32 (flutter/flutter#179147) 2026-01-08 [email protected] [web] Don't serve files outside of project (flutter/flutter#180699) 2026-01-08 [email protected] Roll Skia from 837be28dd218 to e9b3264ade0c (1 revision) (flutter/flutter#180702) 2026-01-08 [email protected] Add new motion accessibility features to iOS. (flutter/flutter#178102) 2026-01-08 [email protected] Fix iOS xattr removal to clear all extended attributes (flutter/flutter#180355) 2026-01-08 [email protected] [ Widget Preview ] Move widget_preview_scaffold tests to `dev/integration_tests/widget_preview_scaffold` (flutter/flutter#180658) 2026-01-08 [email protected] De-interleaves engine dart test output (flutter/flutter#180651) 2026-01-08 [email protected] [web] Fix SemanticsService.announce not working inside dialogs (flutter/flutter#179958) 2026-01-08 [email protected] Roll Skia from 42233226ac56 to 837be28dd218 (2 revisions) (flutter/flutter#180693) 2026-01-08 [email protected] Roll Dart SDK to 3.11.0-296.2.beta (flutter/flutter#180685) 2026-01-08 [email protected] Improve code quality in `AndroidTouchProcessorTest.java` (flutter/flutter#180583) 2026-01-08 [email protected] Revert "Reverts "[reland] Unify canvas creation and Surface code in S…kwasm and CanvasKit (#179473)" (#180152)" (flutter/flutter#180610) 2026-01-08 [email protected] Roll Skia from a0c407bce408 to 42233226ac56 (4 revisions) (flutter/flutter#180688) 2026-01-08 [email protected] [ Tool ] Fix flake in overall_experience_test.dart (flutter/flutter#180655) 2026-01-08 [email protected] Roll Packages from 9705815 to 039a026 (6 revisions) (flutter/flutter#180684) 2026-01-08 [email protected] flutter_tools: Auto-generate ExportOptions.plist for manual iOS code signing (flutter/flutter#177888) 2026-01-08 [email protected] Roll Skia from 58837e160874 to a0c407bce408 (2 revisions) (flutter/flutter#180679) 2026-01-08 [email protected] Roll Skia from 1e3266fdba86 to 58837e160874 (1 revision) (flutter/flutter#180677) 2026-01-08 [email protected] Roll Skia from 3c47ea10638f to 1e3266fdba86 (4 revisions) (flutter/flutter#180675) 2026-01-08 [email protected] Roll Fuchsia Linux SDK from dTvN_JVSCfGFRasvH... to rxeg-6UB678HKJ4UQ... (flutter/flutter#180673) ...

ksokolovskyi added 3 commits November 5, 2025 16:08

Add new motion accessibility features to iOS.

1f6c0e5

Merge branch 'master' into add-new-ios-accessibility-features

9073e26

Merge branch 'master' into add-new-ios-accessibility-features

df0db86

ksokolovskyi requested review from a team, chinmaygarde and loic-sharma as code owners November 6, 2025 09:59

gemini-code-assist bot reviewed Nov 6, 2025

View reviewed changes

engine/src/flutter/shell/platform/embedder/embedder.h Outdated Show resolved Hide resolved

ksokolovskyi added 3 commits November 6, 2025 11:09

Fix FlutterAccessibilityFeature enum.

014df41

Fix AccessibilityFeatureFlag.

e05f016

Update AccessibilityFeatures.swift to pass verify_exported check.

2cf5052

hellohuanlin requested a review from LouiseHsu November 6, 2025 22:29

hellohuanlin reviewed Nov 6, 2025

View reviewed changes

engine/src/flutter/shell/platform/darwin/ios/framework/Headers/FlutterViewController.h Show resolved Hide resolved

ksokolovskyi added 2 commits November 7, 2025 09:46

Merge branch 'master' into add-new-ios-accessibility-features

7d08944

Revert isUIAccessibilityIsVoiceOverRunning removal.

93ab83f

LouiseHsu requested changes Nov 10, 2025

View reviewed changes

chunhtai self-requested a review November 12, 2025 22:47

Merge branch 'master' into add-new-ios-accessibility-features

5392d69

chunhtai reviewed Nov 17, 2025

View reviewed changes

mdebbar requested a review from flutter-zl November 19, 2025 19:18

Merge branch 'master' into add-new-ios-accessibility-features

0fdd8a2

justinmc mentioned this pull request Dec 30, 2025

AccessibilityFeatures.autoPlayAnimatedImages should affect animated gifs #180395

Open

Merge branch 'master' into add-new-ios-accessibility-features

6072e30

github-actions bot added the team-android Owned by Android platform team label Jan 5, 2026

mdebbar added the triaged-web Triaged by Web platform team label Jan 7, 2026

LouiseHsu approved these changes Jan 8, 2026

View reviewed changes

Merge branch 'master' into add-new-ios-accessibility-features

3e385f2

chunhtai added the autosubmit Merge PR when tree becomes green via auto submit App label Jan 8, 2026

auto-submit bot added this pull request to the merge queue Jan 8, 2026

Merged via the queue into flutter:master with commit 3892c57 Jan 8, 2026
181 checks passed

flutter-dashboard bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Jan 8, 2026

chrisbobbe mentioned this pull request Jan 9, 2026

deps: Upgrade Flutter to 3.40.0-1.0.pre-487 zulip/zulip-flutter#2068

Merged

engine-flutter-autoroll mentioned this pull request Jan 9, 2026

Roll Flutter from 01d37bc80fd5 to 96403e0fa570 (41 revisions) flutter/packages#10756

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 9, 2026

3892c57 Add new motion accessibility features to iOS. (flutter/flutte…

d0707d2

…r#178102)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 9, 2026

3892c57 Add new motion accessibility features to iOS. (flutter/flutte…

a5a3395

…r#178102)

This was referenced Jan 9, 2026

Roll Flutter from 01d37bc80fd5 to c1e1dc260fb7 (43 revisions) flutter/packages#10757

Closed

Roll Flutter from 01d37bc80fd5 to fd1fad23f595 (44 revisions) flutter/packages#10759

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 9, 2026

3892c57 Add new motion accessibility features to iOS. (flutter/flutte…

a6f79b0

…r#178102)

engine-flutter-autoroll mentioned this pull request Jan 9, 2026

Roll Flutter from 01d37bc80fd5 to 61b241292e19 (45 revisions) flutter/packages#10760

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 9, 2026

3892c57 Add new motion accessibility features to iOS. (flutter/flutte…

7960e6a

…r#178102)

engine-flutter-autoroll mentioned this pull request Jan 10, 2026

Roll Flutter from 01d37bc80fd5 to 0b7596b3f269 (64 revisions) flutter/packages#10768

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 10, 2026

3892c57 Add new motion accessibility features to iOS. (flutter/flutte…

8e5bfd6

…r#178102)

engine-flutter-autoroll mentioned this pull request Jan 10, 2026

Roll Flutter from 01d37bc80fd5 to 73769a220639 (65 revisions) flutter/packages#10769

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 10, 2026

3892c57 Add new motion accessibility features to iOS. (flutter/flutte…

98ac6df

…r#178102)

engine-flutter-autoroll mentioned this pull request Jan 10, 2026

Roll Flutter from 01d37bc80fd5 to 73769a220639 (65 revisions) flutter/packages#10770

Merged

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 10, 2026

3892c57 Add new motion accessibility features to iOS. (flutter/flutte…

886d118

…r#178102)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add new motion accessibility features to iOS.#178102

Add new motion accessibility features to iOS.#178102
auto-submit[bot] merged 24 commits intoflutter:masterfrom
ksokolovskyi:add-new-ios-accessibility-features

ksokolovskyi commented Nov 6, 2025 •

edited

Loading

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

Uh oh!

Uh oh!

LouiseHsu Nov 10, 2025

Uh oh!

LouiseHsu Nov 10, 2025

Uh oh!

ksokolovskyi Nov 12, 2025

Uh oh!

Uh oh!

chunhtai Nov 17, 2025

Uh oh!

justinmc Dec 30, 2025

Uh oh!

Uh oh!

chunhtai commented Dec 30, 2025

Uh oh!

LouiseHsu left a comment

Uh oh!

Uh oh!

chrisbobbe commented Jan 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

		@@ -0,0 +1,217 @@
		// Copyright 2013 The Flutter Authors. All rights reserved.

Conversation

ksokolovskyi commented Nov 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Demo

Pre-launch Checklist

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

LouiseHsu Nov 10, 2025

Choose a reason for hiding this comment

Uh oh!

LouiseHsu Nov 10, 2025

Choose a reason for hiding this comment

Uh oh!

ksokolovskyi Nov 12, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

chunhtai Nov 17, 2025

Choose a reason for hiding this comment

Uh oh!

justinmc Dec 30, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

chunhtai commented Dec 30, 2025

Uh oh!

LouiseHsu left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

chrisbobbe commented Jan 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

ksokolovskyi commented Nov 6, 2025 •

edited

Loading