From 3d0f6bed37743f3b7f56516a826198a7ae1e50e4 Mon Sep 17 00:00:00 2001 From: Peter Cottle Date: Sat, 10 Nov 2012 19:29:00 -0800 Subject: [PATCH] README troubleshooting section --- README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 7d6b374..3a23818 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,15 @@ Ratchet was developed to support iOS 5+ for iPhone. Questions or discussions abo Please file a Github issue to [report a bug](http://github.com/maker/ratchet/issues). When reporting a bug, be sure to follow the [contributor guidelines](https://github.com/maker/ratchet/blob/master/CONTRIBUTING.md). +## Troubleshooting + +A small list of "gotchas" are provided below for developers starting to work with Ratchet + +- Ratchet is designed to respond to touch events from a mobile device. In order to use mouse click events (for desktop browsing and testing), you have a few options: + - Enable touch event emulation in Chrome (found in the overrides tab in the web inspector preferences) + - Use a javascript library like fingerblast.js to emulate touch events (depending on the user agent) +- Script tags containing javascript will not be executed on pages that are loaded with push.js. If you would like to attach event handlers to elements on other pages, document-level event delegation is a common solution. + ## Future features Ratchet is just getting started. Here are some of the immediate features we're thinking about: @@ -55,4 +64,4 @@ Jacob Thornton ## License -Ratchet is licensed under the [MIT License](http://opensource.org/licenses/MIT). \ No newline at end of file +Ratchet is licensed under the [MIT License](http://opensource.org/licenses/MIT).