Skip to content
This repository was archived by the owner on Feb 25, 2025. It is now read-only.

Conversation

@dnfield
Copy link
Contributor

@dnfield dnfield commented Jun 3, 2020

Description

Implements live region announcements for iOS.

If iOS 11 or greater is available, use a queued announcement. Otherwise, use a regular announcement.

This patch also drops the FrequentlyUpdates trait, which seems like it was just added as a misunderstanding at some point - that trait makes the screen reader less likely to read the change on a frequently changing value, and is recommended for things like timers.

/cc @vick08 @j-sid @cookiecrook @caseyburkhardt who provided feedback on the issue.

Related Issues

fixes flutter/flutter#45968 (there is no framework side to this component).

Tests

I added the following tests:

Tests for the new method on SemanticsObject that determines whether an announcement should be issued for live regions.

Breaking Change

Did any tests fail when you ran them? Please read handling breaking changes.

  • No, no existing tests failed, so this is not a breaking change.

@dnfield dnfield requested review from gaaclarke and goderbauer June 3, 2020 21:21
@dnfield dnfield requested a review from jmagman June 3, 2020 21:21
@auto-assign auto-assign bot requested a review from chinmaygarde June 3, 2020 21:23
Copy link
Member

@jmagman jmagman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@dnfield
Copy link
Contributor Author

dnfield commented Jun 3, 2020

Mac Host Engine is a flake - retrying at https://ci.chromium.org/p/flutter/builders/try/Mac%20Host%20Engine/6285

@xster
Copy link
Member

xster commented Jun 3, 2020

LGTM

Copy link
Member

@goderbauer goderbauer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

/// if the user does not have focus of the widget.
/// An example of a live region is a [SnackBar] widget. On Android and iOS,
/// live region causes a polite announcement to be generated automatically,
/// even if the user does not have focus of the widget. This announcement may
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: can we say: "even if the widget does not have accessibility focus" - I think that's slightly clearer.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@dnfield dnfield added the waiting for tree to go green This PR is approved and tested, but waiting for the tree to be green to land. label Jun 4, 2020
@fluttergithubbot fluttergithubbot merged commit 343af33 into flutter:master Jun 4, 2020
engine-flutter-autoroll added a commit to engine-flutter-autoroll/flutter that referenced this pull request Jun 4, 2020
engine-flutter-autoroll added a commit to engine-flutter-autoroll/flutter that referenced this pull request Jun 4, 2020
engine-flutter-autoroll added a commit to engine-flutter-autoroll/flutter that referenced this pull request Jun 4, 2020
engine-flutter-autoroll added a commit to engine-flutter-autoroll/flutter that referenced this pull request Jun 4, 2020
engine-flutter-autoroll added a commit to engine-flutter-autoroll/flutter that referenced this pull request Jun 4, 2020
engine-flutter-autoroll added a commit to engine-flutter-autoroll/flutter that referenced this pull request Jun 5, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

cla: yes waiting for tree to go green This PR is approved and tested, but waiting for the tree to be green to land.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Live Regions on iOS

6 participants