jQuery Mobile provides a complete set of finger-friendly form elements that are based on native HTML form elements.
All forms should be wrapped in a
form tag that has an
method that will handle the form data processing on the server.
<form action="form.php" method="post"> ... </form>
When constructing forms to be used in jQuery Mobile, most of the standard guidelines used to create forms that submit via normal HTTP post or get still apply. However, one thing to keep in mind is that the
id attributes of form controls need to be not only unique on a given page, but also unique across the pages in a site. This is because jQuery Mobile's single-page navigation model allows many different "pages" to be present in the DOM at the same time, so you must be careful to use unique
id attributes so there will be only one of each in the DOM (and of course, be sure to pair them properly with
label elements via the
In jQuery Mobile, all form elements are designed to be a flexible width so they will comfortably fit the width of any mobile device. One optimization built into the framework is that we present labels and form elements differently based on screen width.
If a page is fairly narrow (~480px), the labels are styled as block-level elements so they will stack on top of the form element to save horizontal space.
On wider screens, the labels and form elements are styled to be on the same line in a 2-column layout to take advantage of the screen real estate.
To improve the styling to labels and form elements on wider screens, we recommend wrapping a
fieldset with the
data-role="fieldcontain" attribute around each label/form element. The framework will add a thin vertical bottom border on this container to act as a field separator and visually align the label and form elements for quick scanning.
<div data-role="fieldcontain"> ...label/input code goes here... </div>