GlassSwipeActions class
A container widget that adds iOS-style swipe actions (.swipeActions()) to any child.
Swiping the child horizontally reveals leading or trailing action buttons with authentic iOS physics:
- Smooth underdamped spring animations via GlassSpring.
- Rubber-band damping when pulled beyond the action bounds.
- Full-swipe execution: dragging past fullSwipeThreshold (default 65% of width) triggers a haptic tick and executes the outermost action automatically upon release.
- Mutual exclusivity and scroll dismissal when placed inside a GlassSwipeActionScope.
- Full right-to-left (RTL) layout symmetry.
Usage
GlassSwipeActions(
trailingActions: [
GlassSwipeAction(
icon: const Icon(CupertinoIcons.trash),
label: const Text('Delete'),
isDestructive: true,
onTap: () => handleDelete(),
),
GlassSwipeAction(
icon: const Icon(CupertinoIcons.flag),
label: const Text('Flag'),
backgroundColor: CupertinoColors.systemOrange,
onTap: () => handleFlag(),
),
],
child: GlassListTile(
title: const Text('Swipeable Row'),
),
)
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatefulWidget
- GlassSwipeActions
- Available extensions
Constructors
-
GlassSwipeActions({Key? key, required Widget child, List<
GlassSwipeAction> leadingActions = const [], List<GlassSwipeAction> trailingActions = const [], bool allowsFullSwipe = true, double fullSwipeThreshold = 0.65, double? actionWidth, double buttonDiameter = 50.0, double buttonSpacing = 12.0, double horizontalPadding = 12.0, BorderRadiusGeometry? borderRadius, GlassSwipeController? controller, ValueChanged<GlassSwipeState> ? onSwipeStateChanged, bool enableHaptics = true, bool closeOnTapOutside = true, Clip clipBehavior = Clip.antiAlias, GlassSwipeActionStyle style = GlassSwipeActionStyle.tintedGlass, VoidCallback? onDismissed}) -
Creates a swipeable action container.
const
Properties
- actionWidth → double?
-
Optional base width allocated for each action button when resting open.
final
- allowsFullSwipe → bool
-
Whether pulling past fullSwipeThreshold automatically executes the
outermost action on release.
final
- borderRadius → BorderRadiusGeometry?
-
Optional border radius used to clip the action platter and sliding child.
final
-
Diameter of the circular swipe action button.
final
-
Space between adjacent swipe action buttons.
final
- child → Widget
-
The primary content widget displayed in the row.
final
- clipBehavior → Clip
-
Clip behavior applied when borderRadius is non-null.
final
- closeOnTapOutside → bool
-
Whether tapping or clicking anywhere outside this row while it is open
automatically closes it.
final
- controller → GlassSwipeController?
-
Optional external controller for programmatic inspection and opening/closing.
final
- enableHaptics → bool
-
Whether to fire tactile haptic feedback when entering full-swipe mode.
final
- fullSwipeThreshold → double
-
Proportion of the row's total width required to prime full-swipe execution.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- horizontalPadding → double
-
Horizontal padding between the platter outer edge and the buttons.
final
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
-
leadingActions
→ List<
GlassSwipeAction> -
Actions revealed when swiping from the leading edge (left in LTR).
final
- onDismissed → VoidCallback?
-
Optional callback executed when the row is dismissed via full swipe.
final
-
onSwipeStateChanged
→ ValueChanged<
GlassSwipeState> ? -
Callback fired when the swipe state changes.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- style → GlassSwipeActionStyle
-
Visual styling applied to the swipe action platter.
final
-
trailingActions
→ List<
GlassSwipeAction> -
Actions revealed when swiping from the trailing edge (right in LTR).
final
Methods
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited
-
createState(
) → State< GlassSwipeActions> -
Creates the mutable state for this widget at a given location in the tree.
override
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of DiagnosticsNode objects describing this node's
children.
inherited
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
inherited
-
glassContextMenu(
{Key? key, required List< Widget> actions, WidgetBuilder? previewBuilder, bool enabled = true, bool enableHaptics = true, double borderRadius = 32.0, double? previewBorderRadius, double rowBorderRadius = 16.0, BorderRadius? rowCorners, Color? originSlotColor, Color? backgroundColor, LiquidGlassSettings? settings, GlassQuality? quality, double backdropBlur = 0.0, Color? barrierColor, VoidCallback? onOpened, VoidCallback? onDismissed, Duration longPressDuration = const Duration(milliseconds: 700)}) → Widget -
Available on Widget, provided by the GlassContextMenuExtension extension
Wraps this widget in a GlassContextMenu displayingactionson long-press or right-click. -
glassFullScreenCover(
{required bool isPresented, VoidCallback? onDismiss, required WidgetBuilder content, bool enableSwipeToDismiss = true, double dismissThreshold = 140.0, LiquidGlassSettings? settings, GlassQuality? quality}) → Widget -
Available on Widget, provided by the GlassFullScreenCoverExtension extension
Presents a full-viewport modal cover wheneverisPresentedis true. -
Available on Widget, provided by the GlassNavigationTitleExtension extension
Annotates this widget with a navigation title that drives enclosing or descendant GlassAppBar / GlassAppBar.pinned bars (when their explicittitleis null) as well as header accessibility semantics. -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toDiagnosticsNode(
{String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by DiagnosticsNode.toStringDeep.
inherited
-
toString(
{DiagnosticLevel minLevel = DiagnosticLevel.info}) → String -
A string representation of this object.
inherited
-
toStringDeep(
{String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String -
Returns a string representation of this node and its descendants.
inherited
-
toStringShallow(
{String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a one-line detailed description of the object.
inherited
-
toStringShort(
) → String -
A short, textual description of this widget.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited