← Node guide
Device actions

Swipe

Drags one finger from one point to another. Both points are a percentage of the screen, so the gesture means the same thing on any device.

device.swipeHands-on runs — not reliable unattended
The piece

Drag from one point to another — scroll a list, dismiss a card, pull to refresh. All four coordinates are a % of the screen (0–100), so the same gesture lands correctly on any resolution. Author the %, or draw the swipe on the live device when it runs. Defaults to a scroll-down (bottom → top).

Reach for it when

  • Carousels, pull-to-refresh, swipe-to-delete, onboarding pages.
  • Anything Scroll's four directions cannot describe.
Swipe
Idle
In the bag

Every setting this block has. A field marked only when appears once you have chosen the mode above it — those are alternatives to each other, not extra things to fill in.

  • From XRequired
    starts at 50

    Where the finger goes down — % of screen width.

    only when Draw the swipe on the device when it runs = off

  • From YRequired
    starts at 70

    Where the finger goes down — % of screen height.

    only when Draw the swipe on the device when it runs = off

  • To XRequired
    starts at 50

    Where the finger lifts — % of screen width.

    only when Draw the swipe on the device when it runs = off

  • To YRequired
    starts at 30

    Where the finger lifts — % of screen height.

    only when Draw the swipe on the device when it runs = off

  • Duration
    starts at 300ms

    How long the drag takes. Short = a fling (the list keeps scrolling); long = a slow, controlled drag.

    only when Draw the swipe on the device when it runs = off

  • Draw the swipe on the device when it runs
    starts at off

    Pause the run at this step and stream the live device: drag on the screen to draw the swipe (the drag's own speed becomes the duration), rehearse it on the real device, then confirm — it swipes and continues, and the gesture is saved back onto this node (2½ min limit — the step is skipped if you don't confirm in time). Disables scheduling.

Build it
  1. Say where the finger goes down and where it lifts

    SwipeSettings
    From X% of width
    50
    From Y% of height
    70
    To X
    50
    To Y
    30
    DurationShort = a fling
    300ms
  2. Set the feel with Duration

    A short drag is a fling and the list keeps coasting after the finger lifts. A long one is a controlled drag that stops where you left it.

    Shop50,7050,30
    300ms
  3. Or draw it on the real phone

    Turn on “Draw the swipe on the device when it runs” and the run pauses and streams the device: drag on the screen, rehearse it, confirm — and the gesture is written back onto the node. Two and a half minutes to confirm.

    SwipeSettings
    Draw the swipe on the device when it runsDisables scheduling
    on
What comes out
  • Nothing new — assert on what the swipe revealed.
Watch out
  • A swipe that starts or ends at the very edge of the screen is a system gesture, not an app one. Keep both points away from 0 and 100.
  • For an ordinary list this is more control than you need — Scroll works the geometry out for you.
Usually next to