firka/flutter
firka/flutter
4
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clarifies semantics long press and semantics on tap documentation (#128599)

Browse Source 
fixes https://github.com/flutter/flutter/issues/35112
This commit is contained in:
chunhtai 2023-06-09 12:49:02 -07:00 committed by GitHub
parent a35ae60102
commit cc6f86e6e1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 17 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
packages/flutter/lib/src/semantics/semantics.dart
View File

@ -1367,8 +1367,13 @@ class SemanticsProperties extends DiagnosticableTree {
/// the finger without moving it. For example, a button should implement this
/// action.
///
/// VoiceOver users on iOS and TalkBack users on Android can trigger this
/// VoiceOver users on iOS and TalkBack users on Android *may* trigger this
/// action by double-tapping the screen while an element is focused.
///
/// Note: different OSes or assistive technologies may decide to interpret
/// user inputs differently. Some may simulate real screen taps, while others
/// may call semantics tap. One way to handle taps properly is to provide the
/// same handler to both gesture tap and semantics tap.
final VoidCallback? onTap;
/// The handler for [SemanticsAction.longPress].
@ -1376,9 +1381,15 @@ class SemanticsProperties extends DiagnosticableTree {
/// This is the semantic equivalent of a user pressing and holding the screen
/// with the finger for a few seconds without moving it.
///
/// VoiceOver users on iOS and TalkBack users on Android can trigger this
/// VoiceOver users on iOS and TalkBack users on Android *may* trigger this
/// action by double-tapping the screen without lifting the finger after the
/// second tap.
///
/// Note: different OSes or assistive technologies may decide to interpret
/// user inputs differently. Some may simulate real long presses, while others
/// may call semantics long press. One way to handle long press properly is to
/// provide the same handler to both gesture long press and semantics long
/// press.
final VoidCallback? onLongPress;
/// The handler for [SemanticsAction.scrollLeft].

4
packages/flutter/lib/src/widgets/basic.dart
View File

@ -6983,6 +6983,8 @@ class MetaData extends SingleChildRenderObjectWidget {
///
/// See also:
///
/// * [SemanticsProperties], which contains a complete documentation for each
/// of the constructor parameters that belongs to semantics properties.
/// * [MergeSemantics], which marks a subtree as being a single node for
/// accessibility purposes.
/// * [ExcludeSemantics], which excludes a subtree from the semantics tree
@ -7004,6 +7006,8 @@ class Semantics extends SingleChildRenderObjectWidget {
///
/// See also:
///
/// * [SemanticsProperties], which contains a complete documentation for each
/// of the constructor parameters that belongs to semantics properties.
/// * [SemanticsSortKey] for a class that determines accessibility traversal
/// order.
Semantics({