| allowClear |
boolean |
When set to true, causes a clear button to appear on the select box
when a value is selected. Clicking the clear button will clear the selected value,
effectively resetting the select box back to its placeholder value.
<p>Default value: <strong>false</strong></p>
</td>
</tr>
<tr id="amdBase">
<td>amdBase</td>
<td>string</td>
<td>
<p>The base AMD loader path to be used for select2 dependency resolution. This option
typically doesn't need to be changed, but is available for situations where module names
may change as a result of certain build environments.</p>
<p>Default value: `select2/`</p>
</td>
</tr>
<tr id="amdLanguageBase">
<td>amdLanguageBase</td>
<td>string</td>
<td>
<p>The base AMD loader language path to be used for select2 language file resolution. This
option typically doesn't need to be changed, but is available for situations where module
names may change as a result of certain build environments.</p>
<p>Default value: `select2/i18n/`</p>
</td>
</tr>
<tr id="closeOnSelect">
<td>closeOnSelect</td>
<td>boolean</td>
<td>
<p>When set to <strong>false</strong>, keeps the dropdown open upon selecting an option,
making it easy to quickly select multiple items. <em>Note that this option is only
applicable to multi-select controls</em>.</p>
<p>Default value: `true`</p>
</td>
</tr>
<tr id="containerCss">
<td>containerCss</td>
<td></td>
<td></td>
</tr>
<tr id="containerCssClass">
<td>containerCssClass</td>
<td></td>
<td></td>
</tr>
<tr id="dataAdapter">
<td>dataAdapter</td>
<td></td>
<td></td>
</tr>
<tr id="debug">
<td>debug</td>
<td>boolean</td>
<td></td>
</tr>
<tr id="dir">
<td>dir</td>
<td></td>
<td></td>
</tr>
<tr id="disabled">
<td>disabled</td>
<td>boolean</td>
<td>
<p>When set to <strong>true</strong>, the select control will be disabled.</p>
<p>Default value: <strong>false</strong></p>
</td>
</tr>
<tr id="dropdownAdapter">
<td>dropdownAdapter</td>
<td></td>
<td></td>
</tr>
<tr id="dropdownAutoWidth">
<td>dropdownAutoWidth</td>
<td>boolean</td>
<td></td>
</tr>
<tr id="dropdownCss">
<td>dropdownCss</td>
<td></td>
<td></td>
</tr>
<tr id="dropdownCssClass">
<td>dropdownCssClass</td>
<td></td>
<td></td>
</tr>
<tr id="dropdownParent">
<td>dropdownParent</td>
<td>jQuery selector or DOM node</td>
<td></td>
</tr>
<tr id="escapeMarkup">
<td>escapeMarkup</td>
<td></td>
<td></td>
</tr>
<tr id="initSelection">
<td>initSelection</td>
<td></td>
<td></td>
</tr>
<tr id="language">
<td>language</td>
<td>string or object</td>
<td></td>
</tr>
<tr id="matcher">
<td>matcher</td>
<td>A callback taking search <code>params</code> and the
<code>data</code> object.</td>
<td></td>
</tr>
<tr id="maximumInputLength">
<td>maximumInputLength</td>
<td>integer</td>
<td>
<p>Maximum number of characters that may be provided for a search term.</p>
<p>Default value: <strong>0</strong></p>
</td>
</tr>
<tr id="maximumSelectionLength">
<td>maximumSelectionLength</td>
<td>integer</td>
<td>
<p>The maximum number of items that may be selected in a multi-select control. If the
value of this option is less than 1, the number of selected items will not be limited.</p>
<p>Default value: <strong>0</strong></p>
</td>
</tr>
<tr id="minimumInputLength">
<td>minimumInputLength</td>
<td>integer</td>
<td>
<p>Minimum number of characters required to start a search. This options is primarily
useful in cases where data is loaded via the <code>ajax</code> option.</p>
<p>Default value: <strong>0</strong></p>
</td>
</tr>
<tr id="minimumResultsForSearch">
<td>minimumResultsForSearch</td>
<td>integer</td>
<td>
<p>The minimum number of results required in the initial population of the dropdown to
keep the search box. This option is useful for cases where local data is used with a small
result set, and the search box would simply be a waste of screen real estate. Set this
value to -1 to permanently hide the search box.</p>
<p>Default value: <strong>0</strong></p>
</td>
</tr>
<tr id="multiple">
<td>multiple</td>
<td>boolean</td>
<td>
This option enables multi-select (pillbox) mode. Select2 will automatically map the value of the `multiple` HTML attribute to this option during initialization.
</td>
</tr>
<tr id="placeholder">
<td>placeholder</td>
<td>string or object</td>
<td></td>
</tr>
<tr id="query">
<td>query</td>
<td></td>
<td></td>
</tr>
<tr id="resultsAdapter">
<td>resultsAdapter</td>
<td></td>
<td></td>
</tr>
<tr id="selectionAdapter">
<td>selectionAdapter</td>
<td></td>
<td></td>
</tr>
<tr id="selectOnClose">
<td>selectOnClose</td>
<td>boolean</td>
<td>
<p>Default value: <strong>false</strong></p>
</td>
</tr>
<tr id="sorter">
<td>sorter</td>
<td>function</td>
<td></td>
</tr>
<tr id="tags">
<td>tags</td>
<td>boolean / array of objects</td>
<td></td>
</tr>
<tr id="templateResult">
<td>templateResult</td>
<td>callback</td>
<td></td>
</tr>
<tr id="templateSelection">
<td>templateSelection</td>
<td>callback</td>
<td></td>
</tr>
<tr id="theme">
<td>theme</td>
<td>string</td>
<td>
<p>Default value: <strong>default</strong></p>
</td>
</tr>
<tr id="tokenizer">
<td>tokenizer</td>
<td></td>
<td></td>
</tr>
<tr id="tokenSeparators">
<td>tokenSeparators</td>
<td></td>
<td></td>
</tr>
<tr id="width">
<td>width</td>
<td>string</td>
<td>
<p>Specifies the <code>width</code> style attribute of the select2 container. The
following values are supported:</p>
<dl class="dl-horizontal">
<dt>element</dt>
<dd>Uses the computed element width from any applicable CSS rules.</dd>
<dt>resolve</dt>
<dd>Uses the <code>style</code> attribute value if available, falling
back to the computed element width as necessary.</dd>
<dt>style</dt>
<dd>Width is determined from the <code>select</code> element's <code>style</code>
attribute. If no <code>style</code> attribute is found, null is returned as the
width.</dd>
<dt><em>{width_value}</em></dt>
<dd>Valid CSS values can be passed as a string (i.e. <code>80%</code>).</dd>
</dl>
<p>Default value: <strong>resolve</strong></p>
</td>
</tr>
|
