diff --git a/packages/flutter/lib/src/services/haptic_feedback.dart b/packages/flutter/lib/src/services/haptic_feedback.dart index e3aad6c28e..7c0fa8af55 100644 --- a/packages/flutter/lib/src/services/haptic_feedback.dart +++ b/packages/flutter/lib/src/services/haptic_feedback.dart @@ -9,6 +9,10 @@ import 'system_channels.dart'; /// /// This API is intentionally terse since it calls default platform behavior. It /// is not suitable for precise control of the system's haptic feedback module. +/// +/// See also: +/// +/// * [Human Interface Haptics Guidelines](https://developer.apple.com/design/human-interface-guidelines/playing-haptics) abstract final class HapticFeedback { /// Provides vibration haptic feedback to the user for a short duration. /// @@ -28,6 +32,12 @@ abstract final class HapticFeedback { /// below 10. /// /// On Android, this uses `HapticFeedbackConstants.VIRTUAL_KEY`. + /// + /// {@template flutter.services.HapticFeedback.impact} + /// See also: + /// + /// * [Human Interface Selection Playing Impact Haptic](https://developer.apple.com/design/human-interface-guidelines/playing-haptics#Impact) + /// {@endtemplate} static Future lightImpact() async { await SystemChannels.platform.invokeMethod( 'HapticFeedback.vibrate', @@ -42,6 +52,8 @@ abstract final class HapticFeedback { /// below 10. /// /// On Android, this uses `HapticFeedbackConstants.KEYBOARD_TAP`. + /// + /// {@macro flutter.services.HapticFeedback.impact} static Future mediumImpact() async { await SystemChannels.platform.invokeMethod( 'HapticFeedback.vibrate', @@ -57,6 +69,8 @@ abstract final class HapticFeedback { /// /// On Android, this uses `HapticFeedbackConstants.CONTEXT_CLICK` on API levels /// 23 and above. This call has no effects on Android API levels below 23. + /// + /// {@macro flutter.services.HapticFeedback.impact} static Future heavyImpact() async { await SystemChannels.platform.invokeMethod( 'HapticFeedback.vibrate', @@ -70,6 +84,10 @@ abstract final class HapticFeedback { /// This call has no effects on iOS versions below 10. /// /// On Android, this uses `HapticFeedbackConstants.CLOCK_TICK`. + /// + /// See also: + /// + /// * [Human Interface Selection Playing Selection Haptics](https://developer.apple.com/design/human-interface-guidelines/playing-haptics#Selection) static Future selectionClick() async { await SystemChannels.platform.invokeMethod( 'HapticFeedback.vibrate',