docs/html/design/patterns/gestures.jd

page.title=Gestures
page.tags="gesture","input","touch"
@jd:body

<p>Gestures allow users to interact with your app by manipulating the screen objects you provide. The
following table shows the core gesture set that is supported in Android.</p>

<div class="layout-content-row">
  <div class="layout-content-col span-4">

    <img src="{@docRoot}design/media/gesture_touch.png">

<h4>Touch</h4>
<p>Triggers the default functionality for a given item.</p>

<ul>
  <li class="no-bullet with-icon action">
    <h4>Action</h4>
    <p>Press, lift</p></li>
</ul>

  </div>
  <div class="layout-content-col span-4">

    <img src="{@docRoot}design/media/gesture_longtouch.png">

<h4>Long press</h4>
<p>Enters data selection mode. Allows you to select one or more items in a view and act upon
  the data using a contextual action bar. Avoid using long press for showing contextual menus.</p>

<ul>
  <li class="no-bullet with-icon action">
    <h4>Action</h4>
    <p>Press, wait, lift</p></li>
</ul>

  </div>
  <div class="layout-content-col span-4">

    <img src="{@docRoot}design/media/gesture_swipe.png">

<h4>Swipe</h4>
<p>Scrolls overflowing content, or navigates between views in the same hierarchy.</p>

<ul>
  <li class="no-bullet with-icon action">
    <h4>Action</h4>
    <p>Press, move, lift</p></li>
</ul>

  </div>
</div>


<div class="layout-content-row">
  <div class="layout-content-col span-4">

    <img src="{@docRoot}design/media/gesture_drag.png">

<h4>Drag</h4>
<p>Rearranges data within a view, or moves data into a container (e.g. folders on Home Screen).</p>

<ul>
  <li class="no-bullet with-icon action">
    <h4>Action</h4>
    <p>Long press, move, lift</p></li>
</ul>

  </div>
  <div class="layout-content-col span-4">

    <img src="{@docRoot}design/media/gesture_doubletouch.png">

<h4>Double touch</h4>
<p>Zooms into content. Also used as a secondary gesture for text selection.</p>

<ul>
  <li class="no-bullet with-icon action">
    <h4>Action</h4>
    <p>Two touches in quick succession</p></li>
</ul>

  </div>
  <div class="layout-content-col span-4">

    <img src="{@docRoot}design/media/gesture_pinchopen.png" style="margin-left:-4px">

<h4>Pinch open</h4>
<p>Zooms into content.</p>

<ul>
  <li class="no-bullet with-icon action">
    <h4>Action</h4>
    <p>2-finger press, move outwards, lift</p></li>
</ul>

  </div>
</div>


<div class="layout-content-row">
  <div class="layout-content-col span-4">

    <img src="{@docRoot}design/media/gesture_pinchclose.png">

<h4>Pinch close</h4>
<p>Zooms out of content.</p>

<ul>
  <li class="no-bullet with-icon action">
    <h4>Action</h4>
    <p>2-finger press, move inwards, lift</p></li>
</ul>

  </div>
</div>