docs: Update docs for momentary flag

rkishan516 · rkishan516 · commit 6adb3c74acb2 · 2025-05-08T07:53:12.000+05:30
diff --git a/packages/flutter/lib/src/cupertino/sliding_segmented_control.dart b/packages/flutter/lib/src/cupertino/sliding_segmented_control.dart
@@ -491,15 +491,18 @@ class CupertinoSlidingSegmentedControl<T extends Object> extends StatefulWidget
   /// Defaults to `EdgeInsets.symmetric(vertical: 2, horizontal: 3)`.
   final EdgeInsetsGeometry padding;
 
-  /// Determines whether segments in the segmented control show selected state.
+  /// Determines whether segments provide only momentary feedback when pressed
+  /// rather than maintaining a persistent selected state.
   ///
-  /// If true, segments in the control don’t show selected state and
-  /// don’t update the value of selectedSegmentIndex after tracking ends.
+  /// When true, segments behave more like buttons that trigger actions rather
+  /// than options that can be selected and remain in that state.
   ///
   /// Defaults to false.
   ///
   /// {@tool dartpad}
-  /// This example shows a [CupertinoSlidingSegmentedControl] with [isMomentary] set to true.
+  /// This example shows a [CupertinoSlidingSegmentedControl] with [isMomentary] set
+  /// to true, providing feedback to the user when the segment is selected with a
+  /// text scaling effect.
   ///
   /// ** See code in examples/api/lib/cupertino/segmented_control/cupertino_sliding_segmented_control.1.dart **
   /// {@end-tool}
diff --git a/packages/flutter/test/cupertino/sliding_segmented_control_test.dart b/packages/flutter/test/cupertino/sliding_segmented_control_test.dart
@@ -2173,13 +2173,20 @@ void main() {
     );
 
     final TestGesture gesture = await tester.startGesture(tester.getCenter(find.text('A')));
-    await gesture.moveBy(const Offset(10, 0));
-    await tester.pumpAndSettle(const Duration(milliseconds: 206));
     final Finder scaleTransition = find.ancestor(
       of: find.text('A'),
       matching: find.byType(ScaleTransition),
     );
-    final double scale = tester.widget<ScaleTransition>(scaleTransition).scale.value;
+
+    await tester.pumpAndSettle(const Duration(milliseconds: 206));
+    double scale = tester.widget<ScaleTransition>(scaleTransition).scale.value;
     expect(scale, greaterThan(1.0));
+
+    await gesture.up();
+
+    await tester.pumpAndSettle();
+    scale = tester.widget<ScaleTransition>(scaleTransition).scale.value;
+    // Spring animations approach but don't exactly reach normal scale.
+    expect(scale, moreOrLessEquals(1.0, epsilon: 0.01));
   });
 }
