lightbulb_outline Please take our October 2018 developer survey. Start survey

SwipeDismissBehavior

public class SwipeDismissBehavior
extends Behavior<V extends View>

java.lang.Object
   ↳ android.support.design.widget.CoordinatorLayout.Behavior<V extends android.view.View>
     ↳ com.google.android.material.behavior.SwipeDismissBehavior<V extends android.view.View>
Known Direct Subclasses


An interaction behavior plugin for child views of CoordinatorLayout to provide support for the 'swipe-to-dismiss' gesture.

Summary

Nested classes

interface SwipeDismissBehavior.OnDismissListener

Callback interface used to notify the application that the view has been dismissed. 

Constants

int STATE_DRAGGING

A view is currently being dragged.

int STATE_IDLE

A view is not currently being dragged or animating as a result of a fling/snap.

int STATE_SETTLING

A view is currently settling into place as a result of a fling or predefined non-interactive motion.

int SWIPE_DIRECTION_ANY

Swipe direction which allows swiping in either direction.

int SWIPE_DIRECTION_END_TO_START

Swipe direction that only allows swiping in the direction of end-to-start.

int SWIPE_DIRECTION_START_TO_END

Swipe direction that only allows swiping in the direction of start-to-end.

Public constructors

SwipeDismissBehavior()

Public methods

boolean canSwipeDismissView(View view)

Called when the user's input indicates that they want to swipe the given view.

int getDragState()

Retrieve the current drag state of this behavior.

boolean onInterceptTouchEvent(CoordinatorLayout parent, V child, MotionEvent event)
boolean onTouchEvent(CoordinatorLayout parent, V child, MotionEvent event)
void setDragDismissDistance(float distance)

Set the threshold for telling if a view has been dragged enough to be dismissed.

void setEndAlphaSwipeDistance(float fraction)

The maximum swipe distance for the view's alpha is modified.

void setListener(SwipeDismissBehavior.OnDismissListener listener)

Set the listener to be used when a dismiss event occurs.

void setSensitivity(float sensitivity)

Set the sensitivity used for detecting the start of a swipe.

void setStartAlphaSwipeDistance(float fraction)

The minimum swipe distance before the view's alpha is modified.

void setSwipeDirection(int direction)

Sets the swipe direction for this behavior.

Inherited methods

From class android.support.design.widget.CoordinatorLayout.Behavior
From class java.lang.Object

Constants

STATE_DRAGGING

int STATE_DRAGGING

A view is currently being dragged. The position is currently changing as a result of user input or simulated user input.

Constant Value: 1 (0x00000001)

STATE_IDLE

int STATE_IDLE

A view is not currently being dragged or animating as a result of a fling/snap.

Constant Value: 0 (0x00000000)

STATE_SETTLING

int STATE_SETTLING

A view is currently settling into place as a result of a fling or predefined non-interactive motion.

Constant Value: 2 (0x00000002)

SWIPE_DIRECTION_ANY

int SWIPE_DIRECTION_ANY

Swipe direction which allows swiping in either direction.

Constant Value: 2 (0x00000002)

SWIPE_DIRECTION_END_TO_START

int SWIPE_DIRECTION_END_TO_START

Swipe direction that only allows swiping in the direction of end-to-start. That is right-to-left in LTR or left-to-right in RTL.

Constant Value: 1 (0x00000001)

SWIPE_DIRECTION_START_TO_END

int SWIPE_DIRECTION_START_TO_END

Swipe direction that only allows swiping in the direction of start-to-end. That is left-to-right in LTR, or right-to-left in RTL.

Constant Value: 0 (0x00000000)

Public constructors

SwipeDismissBehavior

SwipeDismissBehavior ()

Public methods

canSwipeDismissView

boolean canSwipeDismissView (View view)

Called when the user's input indicates that they want to swipe the given view.

Parameters
view View: View the user is attempting to swipe

Returns
boolean true if the view can be dismissed via swiping, false otherwise

getDragState

int getDragState ()

Retrieve the current drag state of this behavior. This will return one of STATE_IDLE, STATE_DRAGGING or STATE_SETTLING.

Returns
int The current drag state

onInterceptTouchEvent

boolean onInterceptTouchEvent (CoordinatorLayout parent, 
                V child, 
                MotionEvent event)

Parameters
parent CoordinatorLayout

child V

event MotionEvent

Returns
boolean

onTouchEvent

boolean onTouchEvent (CoordinatorLayout parent, 
                V child, 
                MotionEvent event)

Parameters
parent CoordinatorLayout

child V

event MotionEvent

Returns
boolean

setDragDismissDistance

void setDragDismissDistance (float distance)

Set the threshold for telling if a view has been dragged enough to be dismissed.

Parameters
distance float: a ratio of a view's width, values are clamped to 0 >= x <= 1f;

setEndAlphaSwipeDistance

void setEndAlphaSwipeDistance (float fraction)

The maximum swipe distance for the view's alpha is modified.

Parameters
fraction float: the distance as a fraction of the view's width.

setListener

void setListener (SwipeDismissBehavior.OnDismissListener listener)

Set the listener to be used when a dismiss event occurs.

Parameters
listener SwipeDismissBehavior.OnDismissListener: the listener to use.

setSensitivity

void setSensitivity (float sensitivity)

Set the sensitivity used for detecting the start of a swipe. This only takes effect if no touch handling has occured yet.

Parameters
sensitivity float: Multiplier for how sensitive we should be about detecting the start of a drag. Larger values are more sensitive. 1.0f is normal.

setStartAlphaSwipeDistance

void setStartAlphaSwipeDistance (float fraction)

The minimum swipe distance before the view's alpha is modified.

Parameters
fraction float: the distance as a fraction of the view's width.

setSwipeDirection

void setSwipeDirection (int direction)

Sets the swipe direction for this behavior.

Parameters
direction int: one of the SWIPE_DIRECTION_START_TO_END, SWIPE_DIRECTION_END_TO_START or SWIPE_DIRECTION_ANY