From a3edbc35753796c660a7a63f0c37a82ed0f28703 Mon Sep 17 00:00:00 2001 From: Peter Cottle Date: Thu, 15 Nov 2012 10:28:06 -0800 Subject: [PATCH] README troubleshooting update with file:/// protocol --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 3a23818..c267e1e 100644 --- a/README.md +++ b/README.md @@ -20,12 +20,14 @@ Please file a Github issue to [report a bug](http://github.com/maker/ratchet/iss ## Troubleshooting -A small list of "gotchas" are provided below for developers starting to work with Ratchet +A small list of "gotchas" are provided below for designers and 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) + - Use a javascript library like fingerblast.js to emulate touch events (ideally only loaded from desktop devices) - 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. +- Ratchet uses XHR requests to fetch additional pages inside the application. Due to security concerns, modern browsers prevent XHR requests when opening files locally (aka using the file:/// protocol); consequently, Ratchet does not work when opened directly as a file. + - A common solution to this is to simply serve the files from a local server. One convenient way to achieve this is to run ```python -m SimpleHTTPServer ``` to serve up the files in the current directory to ```http://localhost:``` ## Future features -- 2.39.2