Chapter 4



  • Understanding events
  • Using the events listener
  • Understanding event Types

Now that you’ve learned something about PhoneGap, have installed it, and can make your way around your chosen development environment, it’s time to dive into the PhoneGap API.

In this chapter, you learn how PhoneGap handles events. An event in PhoneGap is similar to other JavaScript events. An action has occurred on the device — for example, the document object model (DOM) has loaded and, therefore, the device is “ready” — and now PhoneGap can do other things in response to it.


NOTE For those of you who have worked in web development, you know that the DOM provides a standardized, versatile view of a document’s contents. By using the DOM, you can easily manipulate a document — adding, removing, and editing nodes as needed. For example, if you want to display status messages to the application user, create an HTML div with an id of statusmessages, then use JavaScript to populate that div with HTML messages.


To put it simply, an event is any action that can be detected by PhoneGap. In traditional JavaScript programming, any element on a web page can have certain events that can trigger a bit of JavaScript. For example, an onrollover event on a link might cause a pop-up window to appear, or an onclick event might cause a preview pane ...

Get Beginning PhoneGap now with the O’Reilly learning platform.

O’Reilly members experience live online training, plus books, videos, and digital content from nearly 200 publishers.