mirror of
https://github.com/Hopiu/jquery-mobile.git
synced 2026-03-17 06:20:26 +00:00
149 lines
7.1 KiB
HTML
149 lines
7.1 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>jQuery Mobile Docs - Select options</title>
|
|
<link rel="stylesheet" href="../../../themes/default/" />
|
|
<link rel="stylesheet" href="../../_assets/css/jqm-docs.css"/>
|
|
<script src="../../../js/jquery.js"></script>
|
|
<script src="../../../experiments/themeswitcher/jquery.mobile.themeswitcher.js"></script>
|
|
<script src="../../_assets/js/jqm-docs.js"></script>
|
|
<script src="../../../js/"></script>
|
|
</head>
|
|
<body>
|
|
|
|
<div data-role="page" class="type-interior">
|
|
|
|
<div data-role="header" data-theme="f">
|
|
<h1>Select Menus</h1>
|
|
<a href="../../../" data-icon="home" data-iconpos="notext" data-direction="reverse" class="ui-btn-right jqm-home">Home</a>
|
|
</div><!-- /header -->
|
|
|
|
<div data-role="content">
|
|
<div class="content-primary">
|
|
|
|
<form action="#" method="get">
|
|
|
|
<h2>Select menus</h2>
|
|
|
|
<ul data-role="controlgroup" data-type="horizontal" class="localnav">
|
|
<li><a href="index.html" data-role="button" data-transition="fade">Basics</a></li>
|
|
<li><a href="options.html" data-role="button" data-transition="fade" class="ui-btn-active">Options</a></li>
|
|
<li><a href="methods.html" data-role="button" data-transition="fade">Methods</a></li>
|
|
<li><a href="events.html" data-role="button" data-transition="fade">Events</a></li>
|
|
</ul>
|
|
|
|
<p>The select menu plugin has the following options:</p>
|
|
|
|
<dl>
|
|
|
|
<dt><code>corners</code> <em>boolean</em></dt>
|
|
<dd>
|
|
<p class="default">default: true</p>
|
|
<p>Applies the rounded corner class to add the theme button border-radius to the select button if set to true. This option is also exposed as a data attribute: <code>data-corners="false"</code></p>
|
|
<pre><code>$('select').selectmenu(<strong>{ corners: "false" }</strong>);</code></pre>
|
|
</dd>
|
|
|
|
<dt><code>icon</code> <em>string</em></dt>
|
|
<dd>
|
|
<p class="default">default: "arrow-down"</p>
|
|
<p>Sets the icon for the select element from the <a href="../../buttons/buttons-icons.html">icon set</a>. This option is also exposed as a data attribute: <code>data-icon="star"</code></p>
|
|
<pre><code>$('select').selectmenu(<strong>{ icon: "star" }</strong>);</code></pre>
|
|
</dd>
|
|
|
|
<dt><code>iconpos</code> <em>string</em></dt>
|
|
<dd>
|
|
<p class="default">default: "right"</p>
|
|
<p>Position of the icon in the select button. Possible values: left, right, none, notext. The notext value will display the select as an icon-only button with no text feedback. This option is also exposed as a data attribute: <code>data-iconpos="left"</code></p>
|
|
<pre><code>$('select').selectmenu(<strong>{ iconpos: "left" }</strong>);</code></pre>
|
|
</dd>
|
|
|
|
<dt><code>iconshadow</code> <em>boolean</em></dt>
|
|
<dd>
|
|
<p class="default">default: true</p>
|
|
<p>Applies the icon drop shadow class to add the theme shadow style to the select button if set to true. This option is also exposed as a data attribute: <code>data-iconshadow="false"</code></p>
|
|
<pre><code>$('select').selectmenu(<strong>{ iconshadow: "false" }</strong>);</code></pre>
|
|
</dd>
|
|
|
|
<dt><code>initSelector</code> <em>CSS selector string</em></dt>
|
|
<dd>
|
|
<p class="default">default: "select:not(:jqmData(role='slider'))"</p>
|
|
<p>This is used to define the selectors (element types, data roles, etc.) that should be used as the trigger to automatic initialization of the widget plugin. To affect all selects, this option can be set by binding to the <a href="../../api/globalconfig.html">mobileinit event</a>:</p>
|
|
<pre><code>$( document ).bind( "mobileinit", function(){
|
|
<strong>$.mobile.selectmenu.prototype.options.initSelector = ".myselect";</strong>
|
|
});
|
|
</code></pre>
|
|
</dd>
|
|
|
|
<dt><code>inline</code> <em>boolean</em></dt>
|
|
<dd>
|
|
<p class="default">default: null (false)</p>
|
|
<p>If set to true, this will make the select button act like an inline button so the width is determined by the feedback text inside. By default, this is null (false) so the select button is full width, regardless of the feedback content. Possible values: true, false. This option is also exposed as a data attribute: <code>data-inline="true"</code></p>
|
|
<pre><code>$('select').selectmenu(<strong>{ inline: "true" }</strong>);</code></pre>
|
|
</dd>
|
|
|
|
<dt><code>nativeMenu</code> <em>boolean</em></dt>
|
|
<dd>
|
|
<p class="default">default: true</p>
|
|
<p>When set to true, clicking the custom-styled select menu will open the native select menu which is best for performance. If set to false, the custom select menu style will be used instead of the native menu. This option is also exposed as a data attribute: <code>data-native-menu="false"</code></p>
|
|
<pre><code>$('select').selectmenu(<strong>{ nativeMenu: "false" }</strong>);</code></pre>
|
|
</dd>
|
|
|
|
<dt><code>shadow</code> <em>boolean</em></dt>
|
|
<dd>
|
|
<p class="default">default: true</p>
|
|
<p>Applies the drop shadow class to add the theme shadow style to the select button if set to true. This option is also exposed as a data attribute: <code>data-shadow="false"</code></p>
|
|
<pre><code>$('select').selectmenu(<strong>{ shadow: "false" }</strong>);</code></pre>
|
|
</dd>
|
|
|
|
<dt><code>theme</code> <em>string</em></dt>
|
|
<dd>
|
|
<p class="default">default: null, inherited from parent</p>
|
|
<p>Sets the theme swatch color scheme for the select element. This is a single letter from a-z that maps to the swatches included in your theme. By default, a select will inherit the same swatch color as it's parent container if not explicitly set. This option is also exposed as a data attribute: <code>data-theme="a"</code></p>
|
|
<pre><code>$('select').selectmenu(<strong>{ theme: "a" }</strong>);</code></pre>
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
</form>
|
|
</div><!--/content-primary -->
|
|
|
|
<div class="content-secondary">
|
|
|
|
<div data-role="collapsible" data-collapsed="true" data-theme="b">
|
|
|
|
<h3>More in this section</h3>
|
|
|
|
<ul data-role="listview" data-theme="c" data-dividertheme="d">
|
|
|
|
<li data-role="list-divider">Form elements</li>
|
|
<li><a href="../docs-forms.html">Form basics</a></li>
|
|
<li><a href="../forms-all.html">Form element gallery</a></li>
|
|
<li><a href="../texts/index.html">Text inputs</a></li>
|
|
<li><a href="../forms-search.html">Search inputs</a></li>
|
|
<li><a href="../forms-slider.html">Slider</a></li>
|
|
<li><a href="../forms-switch.html">Flip toggle switch</a></li>
|
|
<li><a href="../forms-radiobuttons.html">Radio buttons</a></li>
|
|
<li><a href="../forms-checkboxes.html">Checkboxes</a></li>
|
|
<li data-theme="a"><a href="index.html">Select menus</a></li>
|
|
<li><a href="../forms-themes.html">Theming forms</a></li>
|
|
<li><a href="../forms-all-native.html">Native form elements</a></li>
|
|
<li><a href="../forms-sample.html">Submitting forms</a></li>
|
|
<li><a href="../plugin-eventsmethods.html">Plugin methods</a></li>
|
|
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
|
|
</div><!-- /content -->
|
|
|
|
<div data-role="footer" class="footer-docs" data-theme="c">
|
|
<p>© 2011 The jQuery Project</p>
|
|
</div>
|
|
|
|
</div><!-- /page -->
|
|
|
|
</body>
|
|
</html>
|
|
|