From 283d0c07f6bbbcb2d41ea1ba527f983b42ace00f Mon Sep 17 00:00:00 2001 From: Eric Vicenti Date: Wed, 7 Dec 2016 10:42:19 -0800 Subject: [PATCH] Docs: Revise language around mobile web Summary: Addresses some criticism: https://twitter.com/ryanflorence/status/806236197731172352 As the author of this original text, I promise no offense was meant towards mobile web technologies. I just want to help people build apps that feel great. Closes https://github.com/facebook/react-native/pull/11353 Differential Revision: D4292705 Pulled By: lacker fbshipit-source-id: 7b86865e4e98cfc37e052e1c02e0b2c3e800d4fc --- docs/GestureResponderSystem.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/GestureResponderSystem.md b/docs/GestureResponderSystem.md index 62d0c92e9..926bffbd3 100644 --- a/docs/GestureResponderSystem.md +++ b/docs/GestureResponderSystem.md @@ -8,13 +8,13 @@ next: native-modules-ios previous: platform-specific-code --- -Gesture recognition on mobile devices is much more complicated than web. A touch can go through several phases as the app determines what the user's intention is. For example, the app needs to determine if the touch is scrolling, sliding on a widget, or tapping. This can even change during the duration of a touch. There can also be multiple simultaneous touches. +The gesture responder system manages the lifecycle of gestures in your app. A touch can go through several phases as the app determines what the user's intention is. For example, the app needs to determine if the touch is scrolling, sliding on a widget, or tapping. This can even change during the duration of a touch. There can also be multiple simultaneous touches. The touch responder system is needed to allow components to negotiate these touch interactions without any additional knowledge about their parent or child components. This system is implemented in `ResponderEventPlugin.js`, which contains further details and documentation. ### Best Practices -Users can feel huge differences in the usability of web apps vs. native, and this is one of the big causes. Every action should have the following attributes: +To make your app feel great, every action should have the following attributes: - Feedback/highlighting- show the user what is handling their touch, and what will happen when they release the gesture - Cancel-ability- when making an action, the user should be able to abort it mid-touch by dragging their finger away