Pro jquery 2 0 2nd edition
BOOKS FOR PROFESSIONALS BY PROFESSIONALS ® RELATED Pro jQuery 2.0 jQuery 2.0 is the latest version of the jQuery framework Suitable for modern web browsers it provides a robust API for web application development It is fast becoming the tool of choice for web developers the world over and sets the standard for simplicity, flexibility and extensibility in website design In Pro jQuery 2.0 seasoned author, Adam Freeman, demonstrates how to get the most from jQuery 2.0 by focusing on the practical features of the technology and how they can be applied to solving real-world problems In this comprehensive reference he goes in depth to give you the practical knowledge that you need Each topic is covered clearly and concisely, and is packed with the details you’ll need to learn to be truly effective The most important features are given a no-nonsense, in-depth treatment, and chapters contain examples that demonstrate both the power and the subtlety of jQuery With this book you’ll: • Understand the capabilities of jQuery and why it is special • Use the core of jQuery to enrich HTML5, including tables, forms and data displays • Use jQuery UI to create rich and fluid user experiences • Use rich interactions such as drag and drop, sortable data and touch sensitivity • Use jQuery Mobile to create touch-enabled interfaces for mobile devices and tablets • Extend jQuery by creating custom plugins and widgets Shelve in Web Development/JavaScript ISBN 978-1-4302-6388-3 User level: Intermediate–Advanced SOURCE CODE ONLINE www.apress.com 781430 263883 This book was purchased by c2748214@drdrb.com For your convenience Apress has placed some of the front matter material after the index Please use the Bookmarks and Contents at a Glance links to access them Contents at a Glance About the Author������������������������������������������������������������������������������������������������������������� xxix About the Technical Reviewer����������������������������������������������������������������������������������������� xxxi Acknowledgments��������������������������������������������������������������������������������������������������������� xxxiii ■■ Chapter 1: Putting jQuery in Context���������������������������������������������������������������������������������1 ■■ Chapter 2: HTML Primer��������������������������������������������������������������������������������������������������11 ■■ Chapter 3: CSS Primer�����������������������������������������������������������������������������������������������������33 ■■ Chapter 4: JavaScript Primer������������������������������������������������������������������������������������������61 ■■ Chapter 5: jQuery Basics�������������������������������������������������������������������������������������������������93 ■■ Chapter 6: Managing the Element Selection�����������������������������������������������������������������117 ■■ Chapter 7: Manipulating the DOM���������������������������������������������������������������������������������145 ■■ Chapter 8: Manipulating Elements��������������������������������������������������������������������������������177 ■■ Chapter 9: Working with Events������������������������������������������������������������������������������������211 ■■ Chapter 10: Using jQuery Effects�����������������������������������������������������������������������������������235 ■■ Chapter 11: Refactoring the Example: Part I�����������������������������������������������������������������267 ■■ Chapter 12: Using Data Templates��������������������������������������������������������������������������������281 � ■■ Chapter 13: Working with Forms����������������������������������������������������������������������������������309 � ■■ Chapter 14: Using Ajax: Part I���������������������������������������������������������������������������������������351 ■■ Chapter 15: Using Ajax: Part II��������������������������������������������������������������������������������������381 ■■ Chapter 16: Refactoring the Example: Part II����������������������������������������������������������������411 v ■ Contents at a Glance ■■ Chapter 17: Setting Up jQuery UI�����������������������������������������������������������������������������������449 ■■ Chapter 18: Using the Button, Progress Bar, and Slider Widgets����������������������������������457 ■■ Chapter 19: Using the Autocomplete and Accordion Widgets���������������������������������������491 ■■ Chapter 20: Using the Tabs Widget �������������������������������������������������������������������������������527 � ■■ Chapter 21: Using the Datepicker Widget ���������������������������������������������������������������������555 � ■■ Chapter 22: Using the Dialog and Spinner Widgets�������������������������������������������������������587 ■■ Chapter 23: Using the Menu and Tooltip Widgets����������������������������������������������������������621 ■■ Chapter 24: Using the Drag-and-Drop Interactions�������������������������������������������������������653 ■■ Chapter 25: Using the Other Interactions����������������������������������������������������������������������683 ■■ Chapter 26: Refactoring the Example: Part III���������������������������������������������������������������709 ■■ Chapter 27: Getting Started with jQuery Mobile �����������������������������������������������������������737 � ■■ Chapter 28: Pages, Themes & Layouts��������������������������������������������������������������������������763 ■■ Chapter 29: The Dialog & Popup Widgets����������������������������������������������������������������������797 ■■ Chapter 30: Buttons and Collapsible Blocks�����������������������������������������������������������������823 ■■ Chapter 31: Using jQuery Mobile Forms������������������������������������������������������������������������847 ■■ Chapter 32: Using Lists and Panels�������������������������������������������������������������������������������879 ■■ Chapter 33: Refactoring the Example: Part IV���������������������������������������������������������������903 ■■ Chapter 34: Using the jQuery Utility Methods���������������������������������������������������������������929 ■■ Chapter 35: The jQuery UI Effects & CSS Framework����������������������������������������������������945 ■■ Chapter 36: Using Deferred Objects������������������������������������������������������������������������������963 Index���������������������������������������������������������������������������������������������������������������������������������995 vi Chapter Putting jQuery in Context At its heart, jQuery does something that sounds dull: it lets you modify the contents of web pages by manipulating the model that the browser creates when it processes the HTML, a process known as DOM (Document Object Model) manipulation, which I describe in detail later If you have picked up this book, then you have probably already done some DOM manipulation, using either another JavaScript library or the built-in web browser API (application programming interface), and now you want to it in a better way jQuery goes beyond better It makes DOM manipulation a pleasure and, on occasion, an actual joy There is something elegant and graceful about the way that jQuery works that transforms a task that can be pure drudgery into something that is simple and easy Once you start using jQuery, there is no going back Here are the top reasons that I use jQuery in my projects • jQuery is expressive I can more work with much code • jQuery methods apply to multiple elements The DOM API approach of select-iterate-modify is gone, meaning fewer for loops to iterate through elements and fewer mistakes • jQuery deals with implementation differences between browsers I don’t have to worry about whether Internet Explorer (IE) supports a feature in an odd way, for example; I just tell jQuery what I want, and it works around the implementation differences for me • jQuery is open source When I don’t understand how something works or I don’t quite get the result I expect, I can read through the JavaScript code and, if needed, make changes The genius of jQuery is that it takes something that is a major grind in web development and makes it simple, quicker, and easier I can’t ask for more than that Not everything is perfect, of course, and there are one or two rough edges, which I’ll explain as I get into the details But even with the occasional flaw, I love working with jQuery, and I hope you will find it equally compelling and enjoyable to use Understanding jQuery UI and jQuery Mobile In addition to the core jQuery library, I also cover jQuery UI and jQuery Mobile, which are user interface (UI) libraries built on top of jQuery jQuery UI is a general-purpose UI toolkit intended to be used on any device, and jQuery Mobile is designed for use with touch-enabled devices such as smartphones and tablets Understanding jQuery Plug-ins jQuery plug-ins extend the functionality of the basic library Some plug-ins are so good and so widely used that I have covered them in this book There are a lot of plug-ins available (although the quality can vary), so if you don’t like the plug-ins I describe in this book, you can be confident that an alternative approach is available Chapter ■ Putting jQuery in Context What Do I Need to Know? Before reading this book, you should be familiar with the basics of web development, have an understanding of how HTML and CSS (cascading style sheets) work, and, ideally, have a working knowledge of JavaScript If you are a little hazy on some of these details, I provide refreshers for HTML, CSS, and JavaScript in Chapters 2, 3, and You won’t find a comprehensive reference for HTML elements and CSS properties, though There just isn’t the space in a book about jQuery to cover HTML in its entirety If you want a complete reference for HTML and CSS, then I suggest another of my books: The Definitive Guide to HTML5, also published by Apress What Is the Structure of This Book? This book is split into six parts, each of which covers a set of related topics Part 1: Getting Ready Part of this book provides the information you need to get ready for the rest of the book It includes this chapter and primers/refreshers for HTML, CSS, and JavaScript Later in this chapter, I’ll describe the software that you will need in order to follow along Part 2: Working with jQuery Part of this book introduces you to the jQuery library, starting with a basic example and building up to include each of the core features: element selection, DOM manipulation, events, and effects Part 3: Working with Data and Ajax Part of this book shows how jQuery makes it possible to work with inline or remote data I show you how you can generate HTML content from data, how you can validate data entered into web forms, and how you can use jQuery to perform asynchronous operations, including Ajax Part 4: Using jQuery UI jQuery UI is one of the two user interface libraries that I describe in this book Built on, and integrated with, the core jQuery library, jQuery UI allows you to create rich and responsive interfaces for your web applications Part 5: Using jQuery Mobile jQuery Mobile is the other user interface library that I cover in this book jQuery Mobile is built on top of jQuery and incorporates some basic feature from jQuery UI but has been optimized for creating smartphone and tablet interfaces Fewer UI widgets are available in jQuery Mobile, but those that are supported are optimized for touch interaction and for presentation on smaller displays Part 6: Advanced Features The final part of this book describes some jQuery and jQuery UI features not commonly used but which can be helpful in complex projects These are advanced features that require a better understanding of HTML, CSS, and jQuery itself When reading Chapter 36, a basic knowledge of asynchronous programming is very helpful Chapter ■ Putting jQuery in Context What’s New in This Edition? Since the first edition of this book, jQuery, jQuery UI, and jQuery Mobile have all undergone substantial changes What’s New for Core jQuery? The API for the core jQuery library is remarkably stable Some years ago, the jQuery team starting listing changes that they intended to make, and these were implemented with the release of jQuery version 1.9 Some of these changes are quite substantial and I have indicated the changes in each chapter throughout Part of this book The good news is that these changes are very rare and the API is likely to remain stable for several years That’s not to say that new features won’t be added, but the code that you develop today will continue to work without modification for some time to come The bad news is that the jQuery team did something unusual when they released jQuery 1.9—they also released jQuery 2.0, and thus they split development into two lines of parallel releases: jQuery 1.x and jQuery 2.x Both release lines have the same API but jQuery 2.x doesn’t support versions 6, 7, and of IE The older versions of IE are notorious in their non-standard approach to HTML, CSS, and JavaScript, and removing all of the checks for odd behavior and the associated workarounds makes jQuery 2.x smaller and faster ■■Tip At the time of this writing, the current versions of jQuery are 2.0.2 and 1.10.1 It is important to understand that jQuery 2.0.2 doesn’t supersede version 1.10.1 They are both the latest release and the only difference is that jQuery 1.10.1 preserves support for older versions of Internet Explorer You should use jQuery 2.x if you are sure that none of your users will have Internet Explorer 6, 7, or If that is not the case—or if you are not sure—then you should use jQuery 1.x These versions of IE are still widely used, especially in large corporations, and you should think carefully about the effect of using the 2.x line There are no legacy users in the idealized world of programming books, and I’ll be using the jQuery 2.0.2 library throughout most this book—but you can substitute any version of the jQuery 1.x line (from version 1.9 onward) and get the same result and preserve support for the old versions of IE ■■Tip I use jQuery 1.x in Part 4, when I describe jQuery Mobile jQuery Mobile tends to lag behind the main jQuery release and, as I write this, only supports jQuery 1.x What’s New for jQuery UI? jQuery UI has also been updated The API for using the existing user interface widgets has been updated to be more consistent and to work more closely with the HTML elements that underpin them and some new widgets have been added Throughout Part of this book, you will find that I show the important changes at the start of each chapter, just as I did for the changes to jQuery itself in Part What’s New for jQuery Mobile? jQuery Mobile has matured a lot since the previous edition of this book The API has been normalized, new widgets have been added, and the overall developer experience is much more consistent with jQuery and jQuery UI To reflect this maturity, I have completely rewritten Part to bring it in line with the rest of the book There are more examples, reference tables, and demonstrations of specific features Chapter ■ Putting jQuery in Context What Else Is New? From Chapter 12 onward, I use templates to generate HTML elements from data This is an important technique and I use it liberally The library that I used in the previous edition has reached the end of its life and I have chosen a replacement The new library doesn’t come with direct integration into jQuery and so in Chapter 12, I provide a custom plug-in that makes using the template library I selected easy to use with jQuery All of the examples that follow Chapter 12 have been revised to use the new library I changed the toolset that I use for testing mobile applications, preferring to use a cloud-based testing service rather than maintaining my own emulators I explain why I have done this in Chapter 27 Are There Lots of Examples? There are loads of examples One of the nice aspects of jQuery is that almost any task can be performed in several different ways, allowing you to develop a personal jQuery style To show the different approaches you can take, I have included a lot of different examples—so many, in fact, that I include the complete HTML document you are working with only once in some chapters in order to fit everything in The first example in every chapter is a complete HTML document, as shown in Listing 1-1, for example Listing 1-1. A Complete Example Document Example $(document).ready(function () { $("img:odd").mouseenter(function (e) { $(this).css("opacity", 0.5); }).mouseout(function (e) { $(this).css("opacity", 1.0); }); }); Jacqui's Flower Shop Aster: Daffodil: Chapter ■ Putting jQuery in Context Rose: Peony: Primula: Snowdrop: Place Order This listing is taken from Chapter Don’t worry about what it does; just be aware that the first example in each chapter is a complete HTML document, similar to the one shown in Listing 1-1 Almost all of the examples are based around the same basic HTML document, which displays a simple flower shop It isn’t the most exciting example, but it is self-contained and includes all of the things we are interested in when working with jQuery For the second and subsequent examples, I only show you the elements that change This is generally just the script element, which is where your jQuery code lives You can spot a partial listing because it starts and ends with ellipsis ( ), as shown in Listing 1-2 Listing 1-2. A Partial Listing jQuery(document).ready(function () { jQuery("img:odd").mouseenter(function(e) { jQuery(this).css("opacity", 0.5); }).mouseout(function(e) { jQuery(this).css("opacity", 1.0); }); }); Listing 1-2 is a subsequent listing from Chapter You can see that just the script element appears, and I have highlighted a number of statements This is how I draw your attention to the part of the example that shows the jQuery feature I am using In a partial listing like this, only the element I show has changed from the complete document shown at the start of the chapter Chapter ■ Putting jQuery in Context I have kept the examples in this book very focused on individual features This is to give you the best coverage of how jQuery operates But in doing this, you can lose sight of how different features fit together, so at the end of each part of the book, there is a short chapter in which I refactor the example document to incorporate all of the topics in the previous chapters and present a joined-up view of what’s possible Where Can I Get the Example Code? You can download all the examples for all the chapters in this book in the Source Code/Download area of the Apress web site (www.apress.com) The download is available without charge and includes all of the supporting resources that are required to re-create the examples without having to type them in (including images, JavaScript libraries, and CSS style sheets) You don’t have to download the code, but it is the easiest way of experimenting with the examples and cutting and pasting techniques into your own projects ■■Tip Even though I list just the changes in a lot of the code listings in the chapters, each example in the source code download is a complete HTML document that you can load directly into your browser What Software Do I Need for This Book? To follow the examples in this book, you will need various pieces of software, as described in the following sections Getting jQuery The very first thing you need is the jQuery library, which is available from http://jquery.com There is a download button right on the front page of the web site and an option to choose either the production or development release, as shown in Figure 1-1 Figure 1-1. Downloading the jQuery library ■ Contents ■■ Chapter 14: Using Ajax: Part I���������������������������������������������������������������������������������������351 Using the Ajax Shorthand Methods�������������������������������������������������������������������������������������������352 Performing an Ajax GET Request����������������������������������������������������������������������������������������������������������������������� 352 Performing an Ajax POST Request�������������������������������������������������������������������������������������������������������������������� 360 � Specifying the Expected Data Type������������������������������������������������������������������������������������������������������������������� 368 � Avoiding the Most Common Ajax Pitfall ������������������������������������������������������������������������������������369 � Using the Type-Specific Convenience Methods������������������������������������������������������������������������371 Getting an HTML Fragment�������������������������������������������������������������������������������������������������������������������������������� 371 Getting and Executing Scripts��������������������������������������������������������������������������������������������������������������������������� 374 Getting JSON Data��������������������������������������������������������������������������������������������������������������������������������������������� 376 Using the Ajax Forms Plug-in����������������������������������������������������������������������������������������������������378 Summary�����������������������������������������������������������������������������������������������������������������������������������380 ■■ Chapter 15: Using Ajax: Part II��������������������������������������������������������������������������������������381 Making a Simple Ajax Request with the Low-Level API������������������������������������������������������������382 Understanding the jqXHR Object�����������������������������������������������������������������������������������������������384 Setting the Request URL�����������������������������������������������������������������������������������������������������������385 Making a POST Request������������������������������������������������������������������������������������������������������������386 Handling Ajax Callbacks������������������������������������������������������������������������������������������������������������387 Dealing with Successful Requests�������������������������������������������������������������������������������������������������������������������� 388 Dealing with Errors�������������������������������������������������������������������������������������������������������������������������������������������� 389 Dealing with Completed Requests�������������������������������������������������������������������������������������������������������������������� 390 � Configuring Requests Before They Are Sent������������������������������������������������������������������������������������������������������ 392 Specifying Multiple Event Handler Functions���������������������������������������������������������������������������������������������������� 393 Setting the Context for Events��������������������������������������������������������������������������������������������������������������������������� 393 Using the Global Ajax Events�����������������������������������������������������������������������������������������������������394 Controlling Global Events ���������������������������������������������������������������������������������������������������������������������������������� 397 � Configuring the Basic Settings for an Ajax Request������������������������������������������������������������������398 Setting Timeouts and Headers�������������������������������������������������������������������������������������������������������������������������� 398 � Sending JSON Data to the Server���������������������������������������������������������������������������������������������������������������������� 399 xvi ■ Contents Using Advanced Configuration Settings������������������������������������������������������������������������������������401 Making the Request Synchronously������������������������������������������������������������������������������������������������������������������ 401 Ignoring Unmodified Data���������������������������������������������������������������������������������������������������������������������������������� 402 Dealing with the Response Status Code ����������������������������������������������������������������������������������������������������������� 403 � Cleaning Up the Response Data������������������������������������������������������������������������������������������������������������������������ 405 Managing Data Conversion������������������������������������������������������������������������������������������������������������������������������� 406 � Setting Up and Filtering Ajax Requests�������������������������������������������������������������������������������������407 Defining Default Settings����������������������������������������������������������������������������������������������������������������������������������� 407 Filtering Requests��������������������������������������������������������������������������������������������������������������������������������������������� 408 � Summary�����������������������������������������������������������������������������������������������������������������������������������409 ■■ Chapter 16: Refactoring the Example: Part II����������������������������������������������������������������411 Reviewing the Refactored Example������������������������������������������������������������������������������������������411 Updating the Node.js Script ������������������������������������������������������������������������������������������������������414 � Preparing for Ajax����������������������������������������������������������������������������������������������������������������������416 Sourcing the Product Information���������������������������������������������������������������������������������������������419 Adding Form Validation�������������������������������������������������������������������������������������������������������������422 Adding Remote Validation��������������������������������������������������������������������������������������������������������������������������������� 426 � Submitting the Form Data Using Ajax���������������������������������������������������������������������������������������428 Processing the Server Response����������������������������������������������������������������������������������������������436 Adding the New Form���������������������������������������������������������������������������������������������������������������������������������������� 442 Completing the Ajax Request���������������������������������������������������������������������������������������������������������������������������� 443 � Processing the Data������������������������������������������������������������������������������������������������������������������������������������������ 445 Summary�����������������������������������������������������������������������������������������������������������������������������������447 ■■ Chapter 17: Setting Up jQuery UI�����������������������������������������������������������������������������������449 Obtaining jQuery UI�������������������������������������������������������������������������������������������������������������������449 Deciding on a Theme����������������������������������������������������������������������������������������������������������������������������������������� 449 Creating the jQuery UI Custom Download��������������������������������������������������������������������������������������������������������� 451 � Installing jQuery UI for Development�����������������������������������������������������������������������������������������452 Adding jQuery UI to an HTML Document����������������������������������������������������������������������������������������������������������� 453 xvii ■ Contents Installing jQuery UI for Production��������������������������������������������������������������������������������������������454 � Using jQuery UI via a Content Distribution Network������������������������������������������������������������������������������������������ 454 Summary�����������������������������������������������������������������������������������������������������������������������������������455 ■■ Chapter 18: Using the Button, Progress Bar, and Slider Widgets����������������������������������457 Using the jQuery UI Button��������������������������������������������������������������������������������������������������������458 Configuring the Button�������������������������������������������������������������������������������������������������������������������������������������� 460 Using jQuery UI Icons in Buttons����������������������������������������������������������������������������������������������������������������������� 462 Using a Custom Image �������������������������������������������������������������������������������������������������������������������������������������� 464 � Using the Button Methods��������������������������������������������������������������������������������������������������������������������������������� 465 Using the Button Event�������������������������������������������������������������������������������������������������������������������������������������� 468 Creating Different Types of Button��������������������������������������������������������������������������������������������469 Creating a Toggle Button����������������������������������������������������������������������������������������������������������������������������������� 470 Creating a Button Set���������������������������������������������������������������������������������������������������������������������������������������� 471 Using the jQuery UI Progress Bar����������������������������������������������������������������������������������������������473 Creating the Progress Bar��������������������������������������������������������������������������������������������������������������������������������� 474 Creating an Indeterminate Progress Bar����������������������������������������������������������������������������������������������������������� 475 Using the Progress Bar Methods����������������������������������������������������������������������������������������������������������������������� 476 Using the Progress Bar Events�������������������������������������������������������������������������������������������������������������������������� 478 Using the jQuery UI Slider���������������������������������������������������������������������������������������������������������480 Configuring the Slider���������������������������������������������������������������������������������������������������������������������������������������� 481 Using the Slider Methods���������������������������������������������������������������������������������������������������������������������������������� 486 Using Slider Events ������������������������������������������������������������������������������������������������������������������������������������������� 488 � Summary�����������������������������������������������������������������������������������������������������������������������������������490 ■■ Chapter 19: Using the Autocomplete and Accordion Widgets���������������������������������������491 Using jQuery UI Autocomplete���������������������������������������������������������������������������������������������������492 Creating the Autocomplete Element������������������������������������������������������������������������������������������������������������������ 492 Configuring Autocomplete��������������������������������������������������������������������������������������������������������������������������������� 495 Using the Autocomplete Methods���������������������������������������������������������������������������������������������������������������������� 503 Using the Autocomplete Events������������������������������������������������������������������������������������������������������������������������� 506 xviii ■ Contents Using the jQuery UI Accordion���������������������������������������������������������������������������������������������������510 Creating the Accordion�������������������������������������������������������������������������������������������������������������������������������������� 510 Configuring the Accordion �������������������������������������������������������������������������������������������������������������������������������� 514 Using the Accordion Methods���������������������������������������������������������������������������������������������������������������������������� 524 Using the Accordion Events������������������������������������������������������������������������������������������������������������������������������� 525 Summary�����������������������������������������������������������������������������������������������������������������������������������526 ■■ Chapter 20: Using the Tabs Widget �������������������������������������������������������������������������������527 � Creating the Tabs����������������������������������������������������������������������������������������������������������������������528 � Getting Tab Content with Ajax���������������������������������������������������������������������������������������������������531 Configuring the Tabs Widget�����������������������������������������������������������������������������������������������������533 � Selecting the Active Tab������������������������������������������������������������������������������������������������������������������������������������ 533 Disabling Individual Tabs����������������������������������������������������������������������������������������������������������������������������������� 535 Changing the Event Trigger������������������������������������������������������������������������������������������������������������������������������� 537 � Using Collapsible Tabs��������������������������������������������������������������������������������������������������������������������������������������� 538 Using the Tabs Methods������������������������������������������������������������������������������������������������������������539 Adding and Removing Tabs������������������������������������������������������������������������������������������������������������������������������� 539 Triggering Tab Ajax Requests���������������������������������������������������������������������������������������������������������������������������� 541 � Using the Tabs Events���������������������������������������������������������������������������������������������������������������542 Intercepting Ajax Requests�������������������������������������������������������������������������������������������������������������������������������� 543 Manipulating Remote Tab Data�������������������������������������������������������������������������������������������������������������������������� 544 Using Tabs to Display a Form���������������������������������������������������������������������������������������������������������������������������� 545 Summary�����������������������������������������������������������������������������������������������������������������������������������554 ■■ Chapter 21: Using the Datepicker Widget ���������������������������������������������������������������������555 � Creating the Datepicker������������������������������������������������������������������������������������������������������������556 Creating an Inline Datepicker���������������������������������������������������������������������������������������������������������������������������� 557 Configuring the Datepicker ������������������������������������������������������������������������������������������������������559 Performing Basic Configuration������������������������������������������������������������������������������������������������������������������������ 559 � Managing the Date Selection���������������������������������������������������������������������������������������������������������������������������� 565 Managing the Appearance of the Datepicker ��������������������������������������������������������������������������������������������������� 573 xix ■ Contents Using the Datepicker Methods��������������������������������������������������������������������������������������������������578 Getting and Setting the Date Programmatically������������������������������������������������������������������������������������������������ 578 Showing and Hiding Pop-up Datepickers Programmatically ���������������������������������������������������������������������������� 580 Using the Datepicker Events�����������������������������������������������������������������������������������������������������581 Responding to a Month or Year Change������������������������������������������������������������������������������������������������������������ 582 Responding to the Pop-up Closing�������������������������������������������������������������������������������������������������������������������� 583 Localizing Date Selection����������������������������������������������������������������������������������������������������������584 Summary�����������������������������������������������������������������������������������������������������������������������������������586 ■■ Chapter 22: Using the Dialog and Spinner Widgets�������������������������������������������������������587 Using the jQuery UI Dialog Widget���������������������������������������������������������������������������������������������588 Creating the Dialog�������������������������������������������������������������������������������������������������������������������������������������������� 588 Configuring the Dialog��������������������������������������������������������������������������������������������������������������������������������������� 590 Using the Dialog Methods��������������������������������������������������������������������������������������������������������������������������������� 602 � Using the Dialog Events������������������������������������������������������������������������������������������������������������������������������������� 604 Using the jQuery UI Spinner Widget������������������������������������������������������������������������������������������607 Using the Spinner Widget with the HTML5 Input Element Types����������������������������������������������������������������������� 608 Configuring the Spinner Widget ������������������������������������������������������������������������������������������������������������������������ 611 Using the Spinner Methods������������������������������������������������������������������������������������������������������������������������������� 617 Using the Spinner Events���������������������������������������������������������������������������������������������������������������������������������� 619 Summary�����������������������������������������������������������������������������������������������������������������������������������620 ■■ Chapter 23: Using the Menu and Tooltip Widgets����������������������������������������������������������621 Using the jQuery UI Menu Widget����������������������������������������������������������������������������������������������622 Creating the Menu �������������������������������������������������������������������������������������������������������������������������������������������� 622 Configuring the Menu���������������������������������������������������������������������������������������������������������������������������������������� 625 Using the Menu Methods����������������������������������������������������������������������������������������������������������������������������������� 631 Using the Menu Events�������������������������������������������������������������������������������������������������������������������������������������� 632 Using the jQuery UI Tooltip Widget �������������������������������������������������������������������������������������������634 Creating the Tooltip�������������������������������������������������������������������������������������������������������������������������������������������� 635 Configuring the Tooltip �������������������������������������������������������������������������������������������������������������������������������������� 637 � xx ■ Contents Using the Tooltip Methods��������������������������������������������������������������������������������������������������������������������������������� 647 Using the Tooltip Events������������������������������������������������������������������������������������������������������������������������������������ 649 Summary�����������������������������������������������������������������������������������������������������������������������������������651 ■■ Chapter 24: Using the Drag-and-Drop Interactions�������������������������������������������������������653 Creating the Draggable Interaction�������������������������������������������������������������������������������������������654 Configuring the Draggable Interaction�������������������������������������������������������������������������������������������������������������� 655 � Using the Draggable Methods��������������������������������������������������������������������������������������������������������������������������� 661 Using the Draggable Events������������������������������������������������������������������������������������������������������������������������������ 662 Using the Droppable Interaction������������������������������������������������������������������������������������������������663 Highlighting a Drop Target��������������������������������������������������������������������������������������������������������������������������������� 665 Dealing with Overlapping Elements������������������������������������������������������������������������������������������������������������������ 667 � Configuring the Droppable Interaction�������������������������������������������������������������������������������������������������������������� 668 � Using the Droppable Methods��������������������������������������������������������������������������������������������������������������������������� 674 Tuning Drag and Drop���������������������������������������������������������������������������������������������������������������674 � Using Element Scope ���������������������������������������������������������������������������������������������������������������������������������������� 674 � Using a Helper Element������������������������������������������������������������������������������������������������������������������������������������� 676 Snapping to the Edges of Elements������������������������������������������������������������������������������������������������������������������� 680 Summary�����������������������������������������������������������������������������������������������������������������������������������681 ■■ Chapter 25: Using the Other Interactions����������������������������������������������������������������������683 Using the Sortable Interaction���������������������������������������������������������������������������������������������������684 Getting the Sortable Order��������������������������������������������������������������������������������������������������������������������������������� 685 Configuring the Sortable Interaction����������������������������������������������������������������������������������������������������������������� 687 � Using the Sortable Methods������������������������������������������������������������������������������������������������������������������������������ 693 Using the Sortable Events��������������������������������������������������������������������������������������������������������������������������������� 695 Using the Selectable Interaction�����������������������������������������������������������������������������������������������697 Configuring the Selectable Interaction�������������������������������������������������������������������������������������������������������������� 699 Using the Selectable Interaction Methods��������������������������������������������������������������������������������������������������������� 700 Using the Selectable Interaction Events������������������������������������������������������������������������������������������������������������ 701 Using the Resizable Interaction�������������������������������������������������������������������������������������������������701 Configuring the Resizable Interaction��������������������������������������������������������������������������������������������������������������� 703 � Summary�����������������������������������������������������������������������������������������������������������������������������������707 xxi ■ Contents ■■ Chapter 26: Refactoring the Example: Part III���������������������������������������������������������������709 Reviewing the Refactored Example������������������������������������������������������������������������������������������709 Displaying the Products������������������������������������������������������������������������������������������������������������711 Adding the Shopping Basket�����������������������������������������������������������������������������������������������������713 Wrapping the Accordion������������������������������������������������������������������������������������������������������������������������������������ 715 Adding the Table������������������������������������������������������������������������������������������������������������������������������������������������ 715 Handling Input Value Changes��������������������������������������������������������������������������������������������������������������������������� 716 Applying the Theme Style ��������������������������������������������������������������������������������������������������������720 � Applying the CSS Framework More Widely������������������������������������������������������������������������������������������������������� 721 Applying Rounded Corners to the Table������������������������������������������������������������������������������������������������������������� 722 This book was purchased by c2748214@drdrb.com Creating the jQuery UI Button����������������������������������������������������������������������������������������������������725 Adding the Completion Dialog���������������������������������������������������������������������������������������������������728 Handling the Place Order Button Click��������������������������������������������������������������������������������������731 Completing the Order����������������������������������������������������������������������������������������������������������������734 Summary�����������������������������������������������������������������������������������������������������������������������������������736 ■■ Chapter 27: Getting Started with jQuery Mobile �����������������������������������������������������������737 � Setting Up jQuery Mobile ���������������������������������������������������������������������������������������������������������737 � Obtaining jQuery Mobile������������������������������������������������������������������������������������������������������������������������������������ 738 Installing jQuery Mobile ������������������������������������������������������������������������������������������������������������������������������������ 738 Understanding the jQuery Mobile Approach������������������������������������������������������������������������������739 Understanding Automatic Enhancement����������������������������������������������������������������������������������������������������������� 740 Understanding the Viewport ����������������������������������������������������������������������������������������������������������������������������� 742 Understanding jQuery Mobile Events���������������������������������������������������������������������������������������������������������������� 744 � Responding to Device Orientation Changes������������������������������������������������������������������������������������������������������ 754 Working with Mobile Devices����������������������������������������������������������������������������������������������������756 Avoiding the Two Cardinal Sins of Mobile Development������������������������������������������������������������������������������������ 757 Avoiding Bad Assumptions�������������������������������������������������������������������������������������������������������������������������������� 757 Avoiding Unrealistic Simulation and Testing ����������������������������������������������������������������������������������������������������� 759 � Using a Mobile Browser Emulator��������������������������������������������������������������������������������������������������������������������� 761 Summary�����������������������������������������������������������������������������������������������������������������������������������761 xxii ■ Contents ■■ Chapter 28: Pages, Themes & Layouts��������������������������������������������������������������������������763 Understanding jQuery Mobile Pages�����������������������������������������������������������������������������������������764 Adding Headers and Footers to a Page������������������������������������������������������������������������������������������������������������� 765 Adding Pages to a Document���������������������������������������������������������������������������������������������������������������������������� 766 Linking to External Pages���������������������������������������������������������������������������������������������������������������������������������� 771 Using Scripting to Control jQuery Mobile Pages�����������������������������������������������������������������������778 � Changing the Current Page������������������������������������������������������������������������������������������������������������������������������� 778 � Determining the Current Page��������������������������������������������������������������������������������������������������������������������������� 784 Loading Pages in the Background��������������������������������������������������������������������������������������������������������������������� 786 Using Page Events ��������������������������������������������������������������������������������������������������������������������787 � Handling the Page Initialization Event��������������������������������������������������������������������������������������������������������������� 788 Handling Page Load Events������������������������������������������������������������������������������������������������������������������������������� 788 Responding to Page Transitions������������������������������������������������������������������������������������������������������������������������ 789 Applying jQuery Mobile Themes������������������������������������������������������������������������������������������������790 Applying Swatches to Individual Elements�������������������������������������������������������������������������������������������������������� 793 Creating Grid Layouts����������������������������������������������������������������������������������������������������������������794 Summary�����������������������������������������������������������������������������������������������������������������������������������796 ■■ Chapter 29: The Dialog & Popup Widgets����������������������������������������������������������������������797 Using the jQuery Mobile Dialog Widget�������������������������������������������������������������������������������������798 Creating the Dialog Widget�������������������������������������������������������������������������������������������������������������������������������� 798 Configuring the Dialog Widget��������������������������������������������������������������������������������������������������������������������������� 804 Using the Dialog Methods��������������������������������������������������������������������������������������������������������������������������������� 808 � Using the Dialog Events������������������������������������������������������������������������������������������������������������������������������������� 809 Using the jQuery Mobile Popup Widget�������������������������������������������������������������������������������������810 Creating the Popup Widget�������������������������������������������������������������������������������������������������������������������������������� 810 Configuring the Popup Widget��������������������������������������������������������������������������������������������������������������������������� 811 Using the Popup Methods��������������������������������������������������������������������������������������������������������������������������������� 818 � Using the Popup Events������������������������������������������������������������������������������������������������������������������������������������� 820 Summary�����������������������������������������������������������������������������������������������������������������������������������821 xxiii ■ Contents ■■ Chapter 30: Buttons and Collapsible Blocks�����������������������������������������������������������������823 Using jQuery Mobile Buttons�����������������������������������������������������������������������������������������������������824 Creating the Button Widget������������������������������������������������������������������������������������������������������������������������������� 824 � Configuring jQuery Mobile Buttons�������������������������������������������������������������������������������������������������������������������� 828 Using the Button Methods��������������������������������������������������������������������������������������������������������������������������������� 832 Using the Button Events������������������������������������������������������������������������������������������������������������������������������������ 834 Using jQuery Mobile NavBars����������������������������������������������������������������������������������������������������835 Configuring jQuery Mobile NavBar�������������������������������������������������������������������������������������������������������������������� 837 Using the NavBar Methods & Events����������������������������������������������������������������������������������������������������������������� 838 Using Collapsible Content Blocks����������������������������������������������������������������������������������������������838 Creating the Collapsible Block��������������������������������������������������������������������������������������������������������������������������� 838 Configuring jQuery Mobile Collapsible Content Blocks������������������������������������������������������������������������������������� 839 � Using Collapsible Block Methods���������������������������������������������������������������������������������������������������������������������� 841 Using Collapsible Block Events ������������������������������������������������������������������������������������������������������������������������� 841 � Using jQuery Mobile Collapsible Sets (Accordions)�������������������������������������������������������������������843 Configuring the Collapsible Set������������������������������������������������������������������������������������������������������������������������� 844 Using the Collapsible Set Methods�������������������������������������������������������������������������������������������������������������������� 845 Using the Collapsible Set Events����������������������������������������������������������������������������������������������������������������������� 845 Summary�����������������������������������������������������������������������������������������������������������������������������������845 ■■ Chapter 31: Using jQuery Mobile Forms������������������������������������������������������������������������847 Creating Form Element Widgets������������������������������������������������������������������������������������������������848 Using the Textinput Widget��������������������������������������������������������������������������������������������������������851 Configuring the Textinput Widget���������������������������������������������������������������������������������������������������������������������� 851 � Using the Textinput Widget Methods����������������������������������������������������������������������������������������������������������������� 852 Using the Textinput Widget Events�������������������������������������������������������������������������������������������������������������������� 853 Using the Slider and Range Slider Widgets�������������������������������������������������������������������������������853 Configuring the Slider and Range Slider Widgets���������������������������������������������������������������������������������������������� 856 Using the Slider and Range Slider Methods������������������������������������������������������������������������������������������������������ 857 Using the Slider Events������������������������������������������������������������������������������������������������������������������������������������� 859 � Using the Range Slider Events�������������������������������������������������������������������������������������������������������������������������� 860 xxiv ■ Contents Using the Selectmenu Widget���������������������������������������������������������������������������������������������������861 Configuring the SelectMenu Widget������������������������������������������������������������������������������������������������������������������ 862 Using the Selectmenu Methods������������������������������������������������������������������������������������������������������������������������� 866 Using the Selectmenu Events���������������������������������������������������������������������������������������������������������������������������� 868 Using Flip Switches�������������������������������������������������������������������������������������������������������������������868 Using the Checkboxradio Widget����������������������������������������������������������������������������������������������869 � Creating Check Boxes��������������������������������������������������������������������������������������������������������������������������������������� 869 � Creating and Formatting Radio Buttons������������������������������������������������������������������������������������������������������������ 874 Configuring the Checkboxradio Widget������������������������������������������������������������������������������������������������������������� 876 Using the Checkboxradio Methods�������������������������������������������������������������������������������������������������������������������� 876 Using the Checkboxradio Events����������������������������������������������������������������������������������������������������������������������� 877 Summary�����������������������������������������������������������������������������������������������������������������������������������877 ■■ Chapter 32: Using Lists and Panels�������������������������������������������������������������������������������879 Using the ListView Widget���������������������������������������������������������������������������������������������������������880 Configuring the Listview Widget������������������������������������������������������������������������������������������������������������������������ 882 Using the Listview Methods������������������������������������������������������������������������������������������������������������������������������ 894 Using the Listview Events��������������������������������������������������������������������������������������������������������������������������������� 894 � Using the Panel Widget�������������������������������������������������������������������������������������������������������������894 Configuring the Panel Widget���������������������������������������������������������������������������������������������������������������������������� 896 Using the Panel Methods����������������������������������������������������������������������������������������������������������������������������������� 900 Using the Panel Events�������������������������������������������������������������������������������������������������������������������������������������� 901 Summary�����������������������������������������������������������������������������������������������������������������������������������901 ■■ Chapter 33: Refactoring the Example: Part IV���������������������������������������������������������������903 Starting with the Basics������������������������������������������������������������������������������������������������������������903 Inserting Products Programmatically����������������������������������������������������������������������������������������905 Reusing Pages��������������������������������������������������������������������������������������������������������������������������������������������������� 909 Creating the Shopping Basket���������������������������������������������������������������������������������������������������912 Adding for Quantity Changes����������������������������������������������������������������������������������������������������������������������������� 916 Adding a Button to the Information Page���������������������������������������������������������������������������������������������������������� 920 Implementing the Checkout Process����������������������������������������������������������������������������������������923 � Summary�����������������������������������������������������������������������������������������������������������������������������������928 xxv ■ Contents ■■ Chapter 34: Using the jQuery Utility Methods���������������������������������������������������������������929 Queues Revisited: Using General Purpose Queues�������������������������������������������������������������������929 � Manually Processing Queue Items�������������������������������������������������������������������������������������������������������������������� 932 Utility Methods for Arrays����������������������������������������������������������������������������������������������������������933 Using the Grep Method�������������������������������������������������������������������������������������������������������������������������������������� 933 Using the inArray Method���������������������������������������������������������������������������������������������������������������������������������� 935 Using the Map Method�������������������������������������������������������������������������������������������������������������������������������������� 935 Using the Merge Method����������������������������������������������������������������������������������������������������������������������������������� 937 Using the Unique Method���������������������������������������������������������������������������������������������������������������������������������� 937 Utility Methods for Types�����������������������������������������������������������������������������������������������������������938 Using the Type Method�������������������������������������������������������������������������������������������������������������������������������������� 939 Utility Methods for Data������������������������������������������������������������������������������������������������������������940 � Serializing Form Data���������������������������������������������������������������������������������������������������������������������������������������� 940 Parsing Data������������������������������������������������������������������������������������������������������������������������������������������������������ 941 Trimming Strings����������������������������������������������������������������������������������������������������������������������������������������������� 941 Other Utility Methods����������������������������������������������������������������������������������������������������������������942 � Checking Element Containment������������������������������������������������������������������������������������������������������������������������ 942 Summary�����������������������������������������������������������������������������������������������������������������������������������943 ■■ Chapter 35: The jQuery UI Effects & CSS Framework����������������������������������������������������945 Using the jQuery UI Effects �������������������������������������������������������������������������������������������������������945 � Animating Colors����������������������������������������������������������������������������������������������������������������������������������������������� 946 Animating Classes��������������������������������������������������������������������������������������������������������������������������������������������� 948 Using the jQuery UI Animations������������������������������������������������������������������������������������������������������������������������� 951 Using the jQuery UI CSS Framework�����������������������������������������������������������������������������������������953 Using the Widget Container Classes������������������������������������������������������������������������������������������������������������������ 953 Applying Rounded Corners�������������������������������������������������������������������������������������������������������������������������������� 955 Using the Interaction State Classes������������������������������������������������������������������������������������������������������������������� 957 Using the Cue Classes��������������������������������������������������������������������������������������������������������������������������������������� 958 Summary�����������������������������������������������������������������������������������������������������������������������������������961 xxvi ■ Contents ■■ Chapter 36: Using Deferred Objects������������������������������������������������������������������������������963 A First Deferred Objects Example���������������������������������������������������������������������������������������������964 Understanding Why Deferred Objects Are Useful���������������������������������������������������������������������������������������������� 966 Using Other Callbacks���������������������������������������������������������������������������������������������������������������973 Rejecting a Deferred Object������������������������������������������������������������������������������������������������������������������������������ 974 � Covering Both Outcomes����������������������������������������������������������������������������������������������������������������������������������� 977 Using Outcome-Indifferent Callbacks���������������������������������������������������������������������������������������������������������������� 977 Using Multiple Callbacks�����������������������������������������������������������������������������������������������������������980 Using the Outcomes of Multiple Deferred Objects��������������������������������������������������������������������983 Providing Progress Information�������������������������������������������������������������������������������������������������984 Getting Information about a Deferred Object����������������������������������������������������������������������������988 Using Ajax Deferred Objects������������������������������������������������������������������������������������������������������991 Summary�����������������������������������������������������������������������������������������������������������������������������������993 Index���������������������������������������������������������������������������������������������������������������������������������995 xxvii About the Author Adam Freeman is an experienced IT professional who has held senior positions in a range of companies, most recently serving as chief technology officer and chief operating officer of a global bank Now retired, he spends his time writing and running xxix About the Technical Reviewer Fabio Claudio Ferracchiati is a senior consultant and a senior analyst/developer using Microsoft technologies He works for Brain Force ( www.brainforce.com) in its Italian branch ( www.brainforce.it) Fabio is a Microsoft Certified Solution Developer for NET, a Microsoft Certified Application Developer for NET, a Microsoft Certified Professional, and a prolific author and technical reviewer Over the past ten years, he has written articles for Italian and international magazines and has coauthored more than ten books on a variety of computer topics xxxi Acknowledgments I would like to thank everyone at Apress for working so hard to bring this book to print In particular, I would like to thank Ewan Buckingham for commissioning and editing this title and Katie Sullivan for keeping track of everything I would also like to thank the technical reviewer, Fabio, whose efforts made this book far better than it otherwise would have been —Adam Freeman xxxiii ... h1 { width: 700px; border: thick double black; margin-left: auto; margin-right: auto; text-align: center; font-size: x-large;... h1 { width: 700px; border: thick double black; margin-left: auto; margin-right: auto; text-align: center; font-size: x-large;... black; margin-left: auto; margin-right: auto; text-align: center; font-size: x-large; padding: 5em; color: darkgreen; background-image: url("border.png"); background-size: contain; margin-top: 0;