mirror of
https://github.com/Hopiu/jquery-mobile.git
synced 2026-03-18 06:50:23 +00:00
113 lines
No EOL
4.6 KiB
HTML
113 lines
No EOL
4.6 KiB
HTML
<!DOCTYPE html>
|
|
<html lang='en'><head>
|
|
<meta charset="utf-8" /><meta http-equiv='content-type' content='text/html; charset=UTF-8' /></head><body>
|
|
<div data-role="page">
|
|
<div data-role="header">
|
|
<h1>.serialize()</h1>
|
|
|
|
</div>
|
|
<div data-role="content" data-theme="c" id="serialize1">
|
|
<h2 class="jq-clearfix roundTop section-title">
|
|
<span class="name">.serialize()</span> <span class="returns">Returns: <a class="return" href="http://docs.jquery.com/Types#String">String</a></span>
|
|
</h2>
|
|
<div class=" entry-details">
|
|
<p class="desc"><strong>Description: </strong>Encode a set of form elements as a string for submission.</p>
|
|
<ul class="signatures"><li class="signature" id="serialize"><h4 class="name">
|
|
<span class="versionAdded">version added: <a href="/category/version/1.0/">1.0</a></span>.serialize()</h4></li></ul>
|
|
<div class="longdesc">
|
|
<p>The <code>.serialize()</code> method creates a text string in standard URL-encoded notation. It operates on a jQuery object representing a set of form elements. The form elements can be of several types:</p>
|
|
<pre><form>
|
|
<div><input type="text" name="a" value="1" id="a" /></div>
|
|
<div><input type="text" name="b" value="2" id="b" /></div>
|
|
<div><input type="hidden" name="c" value="3" id="c" /></div>
|
|
<div>
|
|
<textarea name="d" rows="8" cols="40">4</textarea>
|
|
</div>
|
|
<div><select name="e">
|
|
<option value="5" selected="selected">5</option>
|
|
<option value="6">6</option>
|
|
<option value="7">7</option>
|
|
</select></div>
|
|
<div>
|
|
<input type="checkbox" name="f" value="8" id="f" />
|
|
</div>
|
|
<div>
|
|
<input type="submit" name="g" value="Submit" id="g" />
|
|
</div>
|
|
</form></pre>
|
|
<p>The <code>.serialize()</code> method can act on a jQuery object that has selected individual form elements, such as <code><input></code>, <code><textarea></code>, and <code><select></code>. However, it is typically easier to select the <code><form></code> tag itself for serialization:</p>
|
|
<pre>$('form').submit(function() {
|
|
alert($(this).serialize());
|
|
return false;
|
|
});</pre>
|
|
<p>This produces a standard-looking query string:</p>
|
|
<pre>a=1&b=2&c=3&d=4&e=5</pre>
|
|
<p>Note: Only <a href="http://www.w3.org/TR/html401/interact/forms.html#h-17.13.2">"successful controls"</a> are serialized to the string. No submit button value is serialized since the form was not submitted using a button. For a form element's value to be included in the serialized string, the element must have a <code>name</code> attribute. Data from file select elements is not serialized.</p>
|
|
</div>
|
|
<h3>Example:</h3>
|
|
<div id="entry-examples" class="entry-examples"><div id="example-0">
|
|
<h4><span class="desc">Serialize a form to a query string, that could be sent to a server in an Ajax request.</span></h4>
|
|
<pre><code class="example demo-code"><!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<style>
|
|
body, select { font-size:12px; }
|
|
form { margin:5px; }
|
|
p { color:red; margin:5px; font-size:14px; }
|
|
b { color:blue; }
|
|
</style>
|
|
<script src="http://code.jquery.com/jquery-latest.js"></script>
|
|
</head>
|
|
<body>
|
|
|
|
|
|
<form>
|
|
<select name="single">
|
|
<option>Single</option>
|
|
<option>Single2</option>
|
|
</select>
|
|
|
|
<br />
|
|
<select name="multiple" multiple="multiple">
|
|
<option selected="selected">Multiple</option>
|
|
<option>Multiple2</option>
|
|
|
|
<option selected="selected">Multiple3</option>
|
|
</select>
|
|
<br/>
|
|
<input type="checkbox" name="check" value="check1" id="ch1"/>
|
|
|
|
<label for="ch1">check1</label>
|
|
|
|
<input type="checkbox" name="check" value="check2" checked="checked" id="ch2"/>
|
|
|
|
<label for="ch2">check2</label>
|
|
<br />
|
|
<input type="radio" name="radio" value="radio1" checked="checked" id="r1"/>
|
|
|
|
<label for="r1">radio1</label>
|
|
<input type="radio" name="radio" value="radio2" id="r2"/>
|
|
|
|
<label for="r2">radio2</label>
|
|
</form>
|
|
<p><tt id="results"></tt></p>
|
|
<script>
|
|
function showValues() {
|
|
var str = $("form").serialize();
|
|
$("#results").text(str);
|
|
}
|
|
$(":checkbox, :radio").click(showValues);
|
|
$("select").change(showValues);
|
|
showValues();
|
|
</script>
|
|
</body>
|
|
</html></code></pre>
|
|
<h4>Demo:</h4>
|
|
<div class="demo code-demo" rel="200"></div>
|
|
</div></div>
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</body></html> |