Select2 allows you to change the way that the dropdown works, allowing you to do anything from attach it to a different location in the document or add a search box.
By default, Select2 will attach the dropdown to the end of the body and will absolutely position it to appear below the selection container.
dropdownParent
DropdownAdapter
AttachBody
When the dropdown is attached to the body, you are not limited to just displaying the dropdown below the container. Select2 will display above the container if there is not enough space below the container, but there is enough space above it. You are also not limited to displaying the dropdown within the parent container, which means Select2 will render correctly inside of modals and other small containers.
Select2 can place the dropdown directly after the selection container, so it will appear in the same location within the DOM as the rest of Select2.
DropdownAdapter
AttachContainer
Users can filter down the results by typing a search term into a box that is displayed at the top of the dropdown.
DropdownAdapter
DropdownSearch
A search box is added to the top of the dropdown automatically for select boxes where only a single option can be selected.
Sometimes when working with large data sets, it is more efficient to start filtering the results when the search term is a certain length. This is very common when working with remote data sets, as allows for only significant search terms to be used.
minimumInputLength
DataAdapter
MinimumInputLength
In some cases, search terms need to be limited to a certain range. Select2 allows you to limit the length of the search term such that it does not exceed a certain length.
maximumInputLength
DataAdapter
MaximumInputLength
When working with smaller data sets, the search box can take up more space that is necessary, as there are not enough results for filtering to be effective. Select2 allows you to only display the search box when the number of search results reaches a certain threshold.
minimumResultsForSearch
DropdownAdapter
MinimumResultsForSearch
When users close the dropdown, the last highlighted option can be automatically selected. This is commonly used in combination with tagging and placeholders and other situations where the user is required to select an option, or they need to be able to quickly select multiple options.
ResultsAdapter
SelectOnClose
Select2 will automatically close the dropdown when an element is selected, similar to what is done with a normal select box. This behavior can be changed though to keep the dropdown open when results are selected, allowing for multiple options to be selected quickly.
closeOnSelect
true
DropdownAdapter
CloseOnSelect
If this decorator is not used (or closeOnSelect
is set to
false
), the dropdown will not automatically close when a
result is selected. The dropdown will also never close if the
ctrl key is held down when the result is selected.