jquery-mobile/docs/forms/docs-forms.html

<!DOCTYPE html> 
<html> 
	<head>
	<meta charset="utf-8" /> 
	<title>jQuery Mobile Docs - Forms</title> 
	<link rel="stylesheet"  href="../../themes/default" />  
	<link rel="stylesheet" href="../_assets/css/jqm-docs.css"/>
	<script type="text/javascript" src="../../js/"></script>
	<script type="text/javascript" src="../docs/docs.js"></script>
</head> 
<body> 

<div data-role="page">

	<div data-role="header" data-theme="d">
		<h1>Forms</h1>
	</div><!-- /header -->

	<div data-role="content">
			
			<p>jQuery Mobile provides a complete set of finger-friendly form elements that are based on native HTML form elements.</p>
			
			<h2>Form structure</h2>
			
			<p>All forms should be wrapped in a <code>form</code> tag that has an <code>action</code> and <code>method</code> that will handle the form data processing on the server.</p>
			
<code>
&lt;form action=&quot;form.php&quot; method=&quot;post&quot;&gt;
...
&lt;/form&gt;
</code>


<h2>Markup Conventions</h2>
<p>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 <code>id</code> 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 <code>id</code> attributes so there will be only one of each in the DOM (and of course, be sure to pair them properly with <code>label</code> elements via the <code>for</code> attribute).</p>

			<h2>Dynamic form layout</h2>

			<p>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. </p>
			<p>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.</p> 
			<p>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.</p>

			<h2>Field containers</h2>
			
			<p>To improve the styling to labels and form elements on wider screens, we recommend wrapping a <code>div</code> or <code>fieldset </code>with the <code>data-role="fieldcontain"</code> 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.</p>

<pre><code>				
&lt;div data-role=&quot;fieldcontain&quot;&gt;
	...label/input code goes here...
&lt;/div&gt;
</pre></code>
			
			
	</div><!-- /content -->
</div><!-- /page -->

</body>
</html>
new form docs folder 2010-10-12 22:15:52 +00:00			`<!DOCTYPE html>`
			`<html>`
set utf-8 2010-11-02 01:46:29 +00:00			`<head>`
			`<meta charset="utf-8" />`
new form docs folder 2010-10-12 22:15:52 +00:00			`<title>jQuery Mobile Docs - Forms</title>`
Added link to demo css file to all docs pages 2010-11-11 19:15:42 +00:00			`<link rel="stylesheet" href="../../themes/default" />`
			`<link rel="stylesheet" href="../_assets/css/jqm-docs.css"/>`
removed js/all redirect. updated files to use js/ 2010-11-09 22:57:26 +00:00			`<script type="text/javascript" src="../../js/"></script>`
new form docs folder 2010-10-12 22:15:52 +00:00			`<script type="text/javascript" src="../docs/docs.js"></script>`
			`</head>`
			`<body>`

			`<div data-role="page">`

Trying a few color combos for headers to see if we want to set headers colors of different levels to liven it it. thoughts? - form landing page = b (blue) header - form basics = d (mid gray) - form gallery = e (yellow) - text inputs = c (light gray) 2010-10-15 00:43:16 +00:00			`<div data-role="header" data-theme="d">`
new form docs folder 2010-10-12 22:15:52 +00:00			`<h1>Forms</h1>`
			`</div><!-- /header -->`

			`<div data-role="content">`

new form docs 2010-10-13 17:44:56 +00:00			`<p>jQuery Mobile provides a complete set of finger-friendly form elements that are based on native HTML form elements.</p>`

all new forms section with new demos and cleaned up code 2010-10-15 00:28:22 +00:00			`<h2>Form structure</h2>`
new form docs 2010-10-13 17:44:56 +00:00
all new forms section with new demos and cleaned up code 2010-10-15 00:28:22 +00:00			`<p>All forms should be wrapped in a <code>form</code> tag that has an <code>action</code> and <code>method</code> that will handle the form data processing on the server.</p>`

			`<code>`
			`<form action="form.php" method="post">`
			`...`
			`</form>`
			`</code>`
documented very unique ID reminder. Fixes #187 2010-10-19 15:06:48 +00:00

			`<h2>Markup Conventions</h2>`
			<p>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 <code>id</code> 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 <code>id</code> attributes so there will be only one of each in the DOM (and of course, be sure to pair them properly with <code>label</code> elements via the <code>for</code> attribute).</p>

documented the form layout behavior for labels 2010-10-15 15:15:43 +00:00			`<h2>Dynamic form layout</h2>`
updated themes 2010-10-15 14:43:56 +00:00
documented the form layout behavior for labels 2010-10-15 15:15:43 +00:00			`<p>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. </p>`
updated themes 2010-10-15 14:43:56 +00:00			`<p>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.</p>`
			`<p>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.</p>`

documented the form layout behavior for labels 2010-10-15 15:15:43 +00:00			`<h2>Field containers</h2>`
all new forms section with new demos and cleaned up code 2010-10-15 00:28:22 +00:00
documented the form layout behavior for labels 2010-10-15 15:15:43 +00:00			`<p>To improve the styling to labels and form elements on wider screens, we recommend wrapping a <code>div</code> or <code>fieldset </code>with the <code>data-role="fieldcontain"</code> 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.</p>`
new form docs 2010-10-13 17:44:56 +00:00
all new forms section with new demos and cleaned up code 2010-10-15 00:28:22 +00:00			`<pre><code>`
			`<div data-role="fieldcontain">`
			`...label/input code goes here...`
			`</div>`
			`</pre></code>`
new form docs folder 2010-10-12 22:15:52 +00:00

			`</div><!-- /content -->`
			`</div><!-- /page -->`

			`</body>`
			`</html>`