add check for announcement support per platform (#166099)
<!-- Thanks for filing a pull request! Reviewers are typically assigned within a week of filing a request. To learn more about code review, see our documentation on Tree Hygiene: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md --> Helps unblock https://github.com/flutter/flutter/pull/165531 and is part of https://github.com/flutter/flutter/issues/165510 *If you had to change anything in the [flutter/tests] repo, include a link to the migration guide as per the [breaking change policy].* ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing. If you need help, consider asking for advice on the #hackers-new channel on [Discord]. <!-- Links --> [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md
This commit is contained in:
parent
ca37883165
commit
6fc673fc36
@ -7,6 +7,7 @@ library;
|
|||||||
|
|
||||||
import 'dart:ui' show TextDirection;
|
import 'dart:ui' show TextDirection;
|
||||||
|
|
||||||
|
import 'package:flutter/foundation.dart';
|
||||||
import 'package:flutter/services.dart' show SystemChannels;
|
import 'package:flutter/services.dart' show SystemChannels;
|
||||||
|
|
||||||
import 'semantics_event.dart' show AnnounceSemanticsEvent, Assertiveness, TooltipSemanticsEvent;
|
import 'semantics_event.dart' show AnnounceSemanticsEvent, Assertiveness, TooltipSemanticsEvent;
|
||||||
@ -33,6 +34,9 @@ abstract final class SemanticsService {
|
|||||||
/// Currently, this is only supported by the web engine and has no effect on
|
/// Currently, this is only supported by the web engine and has no effect on
|
||||||
/// other platforms. The default mode is [Assertiveness.polite].
|
/// other platforms. The default mode is [Assertiveness.polite].
|
||||||
///
|
///
|
||||||
|
/// Not all platforms support announcements. Check to see if
|
||||||
|
/// [isAnnounceSupported] before calling this method.
|
||||||
|
///
|
||||||
/// ### Android
|
/// ### Android
|
||||||
/// Android has [deprecated announcement events][1] due to its disruptive
|
/// Android has [deprecated announcement events][1] due to its disruptive
|
||||||
/// behavior with TalkBack forcing it to clear its speech queue and speak the
|
/// behavior with TalkBack forcing it to clear its speech queue and speak the
|
||||||
@ -62,4 +66,12 @@ abstract final class SemanticsService {
|
|||||||
final TooltipSemanticsEvent event = TooltipSemanticsEvent(message);
|
final TooltipSemanticsEvent event = TooltipSemanticsEvent(message);
|
||||||
await SystemChannels.accessibility.send(event.toMap());
|
await SystemChannels.accessibility.send(event.toMap());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Checks if announce is supported on the given platform.
|
||||||
|
///
|
||||||
|
/// On Android the announce method is deprecated, therefore will return false.
|
||||||
|
/// On other platforms, this will return true.
|
||||||
|
static bool isAnnounceSupported() {
|
||||||
|
return defaultTargetPlatform != TargetPlatform.android;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@ -2,8 +2,9 @@
|
|||||||
// Use of this source code is governed by a BSD-style license that can be
|
// Use of this source code is governed by a BSD-style license that can be
|
||||||
// found in the LICENSE file.
|
// found in the LICENSE file.
|
||||||
|
|
||||||
|
import 'package:flutter/foundation.dart';
|
||||||
import 'package:flutter/semantics.dart';
|
import 'package:flutter/semantics.dart';
|
||||||
import 'package:flutter/services.dart' show SystemChannels;
|
import 'package:flutter/services.dart' show SystemChannels, TargetPlatform;
|
||||||
import 'package:flutter_test/flutter_test.dart';
|
import 'package:flutter_test/flutter_test.dart';
|
||||||
|
|
||||||
void main() {
|
void main() {
|
||||||
@ -44,4 +45,12 @@ void main() {
|
|||||||
]),
|
]),
|
||||||
);
|
);
|
||||||
});
|
});
|
||||||
|
|
||||||
|
for (final TargetPlatform platform in TargetPlatform.values) {
|
||||||
|
test('Announce not supported on Android. (platform=$platform)', () {
|
||||||
|
debugDefaultTargetPlatformOverride = platform;
|
||||||
|
expect(SemanticsService.isAnnounceSupported(), platform != TargetPlatform.android);
|
||||||
|
debugDefaultTargetPlatformOverride = null;
|
||||||
|
});
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user