docs.md 6.2KB
title: Appearance taxonomy:
category: docs
process:
twig: true
never_cache_twig: true
The appearance of your Select2 controls can be customized via the standard HTML attributes for <select> elements, as well as various configuration options.
Disabling a Select2 control
Select2 will respond to the disabled attribute on <select> elements. You can also initialize Select2 with disabled: true to get the same effect.
Labels
You can, and should, use a <label> with Select2, just like any other <select> element.
Click this to focus the single select element
Click this to focus the multiple select element
<label for="id_label_single">
Click this to highlight the single select element
<select class="js-example-basic-single js-states form-control" id="id_label_single"></select>
</label>
<label for="id_label_multiple">
Click this to highlight the multiple select element
<select class="js-example-basic-multiple js-states form-control" id="id_label_multiple" multiple="multiple"></select>
</label>
Container width
Select2 will try to match the width of the original element as closely as possible. Sometimes this isn’t perfect, in which case you may manually set the width configuration option:
| Value | Description |
|---|---|
'element' |
Uses the computed element width from any applicable CSS rules. |
'style' |
Width is determined from the select element's style attribute. If no style attribute is found, null is returned as the width.
|
'resolve' |
Uses the style attribute value if available, falling back to the computed element width as necessary.
|
'<value>' |
Valid CSS values can be passed as a string (e.g. width: '80%').
|
Example
The two Select2 boxes below are styled to 50% and 75% width respectively to support responsive design:
<select class="js-example-responsive" style="width: 50%"></select>
<select class="js-example-responsive" multiple="multiple" style="width: 75%"></select>
Select2 will do its best to resolve the percent width specified via a CSS class, but it is not always possible. The best way to ensure that Select2 is using a percent based width is to inline the
styledeclaration into the tag.
Themes
Select2 supports custom themes using the theme option so you can style Select2 to match the rest of your application.
These examples use the classic theme, which matches the old look of Select2.
Various display options of the Select2 component can be changed. You can access the <option> element (or <optgroup>) and any attributes on those elements using .element.