You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

301 lines
22 KiB

3 years ago
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
  1. # Change Log
  2. ## 4.0.6
  3. ### New features/improvements
  4. - Add style property to package.json (#5019)
  5. - Implement `clear` and `clearing` events (#5058)
  6. ### Bug fixes
  7. - Fix up arrow error when there are no options in dropdown (#5127)
  8. - Add `;` before beginning of factory wrapper (#5089)
  9. - Fix IE11 issue with select losing focus after selecting an item (#4860)
  10. - Clear tooltip from `select2-selection__rendered` when selection is cleared (#4640, #4746)
  11. - Fix keyboard not closing when closing dropdown on iOS 10 (#4680)
  12. - User-defined types not normalized properly when passed in as data (#4632)
  13. - Perform deep merge for `Defaults.set()` (#4364)
  14. - Fix "the results could not be loaded" displaying during AJAX request (#4356)
  15. - Cache objects in `Utils.__cache` instead of using `$.data` (#4346)
  16. - Removing the double event binding registration of `selection:update` (#4306)
  17. #### Accessibility
  18. - Improve `.select2-hidden-accessible` (#4908)
  19. - Add role and aria-readonly attributes to single selection dropdown value (#4881)
  20. ### Translations
  21. - Add Turkmen translations (`tk`) (#5125)
  22. - Fix error in French translations (#5122)
  23. ### Miscellaneous
  24. - Remove duplicate CSS selector in classic theme (#5115)
  25. ## 4.0.5
  26. ### Bug fixes
  27. - Replace `autocapitalize=off` with `autocapitalize=none` (#4994)
  28. ### Translations
  29. - Vietnamese: remove an unnecessary quote mark (#5059)
  30. - Czech: Add missing commas and periods (#5052)
  31. - Spanish: Update the 'errorLoading' message (#5032)
  32. - Fix typo in Romanian (#5005)
  33. - Improve French translation (#4988)
  34. - Add Pashto translation (`ps`) (#4960)
  35. - Add translations for lower and upper Sorbian (`dsb` and `hsb`) (#4949)
  36. - Updates to Slovak (#4915)
  37. - Fixed Norwegian `inputTooShort` message (#4817, 4896)
  38. - Add Afrikaans translation (`af`) (#4850)
  39. - Add Bosnian translation (`bs`) (#4504)
  40. ## 4.0.4
  41. ### New features / Improvements
  42. - Make tag matching case insensitive [https://github.com/select2/select2/commit/cb9a90457867ffb14c7b1550bb67e872e0a5c2dd, https://github.com/select2/select2/commit/1167bace78cd3b1a918c1b04f3bac54674eab62b]
  43. - Support selecting options with blank or `0` option values [https://github.com/select2/select2/commit/16b4840c0e2df0461998e3b464ee0a546173950d, https://github.com/select2/select2/commit/0358ee528765157234643d289bce6b8ca5889c72]
  44. ### Bug fixes
  45. - Fix issue with entire form losing focus when tabbing away from a Select2 control (#4419)
  46. - Fix UMD support for CommonJS [https://github.com/select2/select2/commit/45a877345482956021161203ac789c25f40a7d5e]
  47. ### Documentation
  48. - Github Pages documentation has been deprecated, replaced with https://github.com/select2/docs
  49. - Add django-autocomplete-light to integrations [https://github.com/select2/select2/pull/4597]
  50. - Correct typo in options page [https://github.com/select2/select2/pull/4389]
  51. - Correct misspelling in AJAX query parameters example [https://github.com/select2/select2/pull/4435]
  52. - "highlight" should be "focus" in focus example [https://github.com/select2/select2/pull/4441]
  53. - Correct misspelling in `<select>` serialization example [https://github.com/select2/select2/pull/4538]
  54. - Correct typos in documentation [https://github.com/select2/select2/pull/4663]
  55. ### Translations
  56. - Add `errorLoading` Hungarian translation [https://github.com/select2/select2/commit/7d1d13352321e21670ff1c6cba7413aa264fd57a]
  57. - Add `errorLoading` German translation [https://github.com/select2/select2/commit/4df965219ea4c39147fde9335bc260840465933a]
  58. - Add Slovene language [https://github.com/select2/select2/commit/8e6422c570a87da8d89c45daf0d253695a943c84]
  59. - Add `errorLoading` Galician translation [https://github.com/select2/select2/commit/8fcc6202c37f4e06d951342bf142a3b906b6b8e3]
  60. - Add `errorLoading` Thai translation [https://github.com/select2/select2/commit/625fc78ee616baedf64aa37357403b4b72c7363c]
  61. - Add `searching` and `errorLoading` Finnish translations [https://github.com/select2/select2/pull/4730]
  62. - Add `errorLoading` Turkish translation [https://github.com/select2/select2/commit/fd4a0825315c7055347726d5818c999279f96ff8, https://github.com/select2/select2/commit/751b36767f9f28b9de9428d5e8035c9a404915d9]
  63. - Add Armenian language [https://github.com/select2/select2/commit/f6fa52dcc02341df1523f50348f2effc54ee2911]
  64. ## 4.0.3
  65. This is the third bugfix release of Select2 4.0.0. It builds upon the [second bugfix release](https://github.com/select2/select2/releases/tag/4.0.2) and fixes many common issues.
  66. ### New features / Improvements
  67. - The old `dropdownAutoWidth` option now properly works [https://github.com/select2/select2/commit/fe26b083eb830836061de1458e483782cefef424]
  68. - A `focus` event on the original `<select>` is now handled [https://github.com/select2/select2/commit/31e7a1d4c52ed7477769fcad5d15166ae3c9b4d0]
  69. - Adding and removing options now refreshes the selection automatically [https://github.com/select2/select2/commit/ea79a197e0ffe55aa600eed6d18cbd1c804c3176]
  70. ### Bug fixes
  71. - `select2('option')` no longer mutate the arguments when working on multiple elements [https://github.com/select2/select2/commit/c2c1aeef31c95c6df5545c900a4e1782d712497c]
  72. - Better detect aborted requests [https://github.com/select2/select2/commit/cfb66f5e4f71a56c46a6890c5dde4b7f24f11fa8]
  73. - New options are now properly created during tokenization [https://github.com/select2/select2/commit/3b8cd2e36990e695e4cb4b966c8658e7ca1574dc]
  74. - Fix positioning bug with non-static parents for the dropdown [https://github.com/select2/select2/pull/4267]
  75. - Infinite scrolling no longer resets the keyboard focus [https://github.com/select2/select2/commit/e897d008a672da262ba84cee2a144578696ada29, https://github.com/select2/select2/commit/9f581285d88128b29a01fc1e5fd2d445d610b553]
  76. - `selectOnClose` now works properly with `closeOnSelect` [https://github.com/select2/select2/commit/481c43883e23874e9c35879d173eb8cc5b994b12]
  77. - Apply `ajax.delay` to empty search terms as well [https://github.com/select2/select2/commit/4b9e02f02211248be25ac4c16d4635cf38237bb9]
  78. ### Documentation
  79. - Added example for attaching event listeners [https://github.com/select2/select2/commit/84d6b5d840f7f4e6b7a2fb3f08424bf5495c876d]
  80. - Correct link to the [Select2 Bootstrap Theme](https://github.com/select2/select2-bootstrap-theme) [https://github.com/select2/select2/pull/4318]
  81. - Added example for using a `<label>` [https://github.com/select2/select2/commit/3bc7f4ac78b58eff8cd17b3273596638c3c9c5c1]
  82. - Add documentation for `ajax.url` [https://github.com/select2/select2/commit/5a831afb9a7d46e8f20aec21164cfbfd182024de]
  83. - Added favicon [https://github.com/select2/select2/pull/4379]
  84. ### Translations
  85. - Add Khmer translation [https://github.com/select2/select2/pull/4246]
  86. - Added Norwegian bokmaal for `errorLoading` [https://github.com/select2/select2/pull/4259]
  87. - Fixed pluralization in Lithuanian translation [https://github.com/select2/select2/commit/5b5eddd183c87bf43165b3a98e03eabe10e9fa58]
  88. - Add French translation for `errorLoading` [https://github.com/select2/select2/commit/b1ea28bb7d8c02b3b352f558031ccfc8041122eb]
  89. - Add Greek translation [https://github.com/select2/select2/pull/4139]
  90. ## 4.0.2
  91. This is the second bugfix release of Select2 4.0.0. It builds upon the [first release candidate of Select2 4.0.2](https://github.com/select2/select2/releases/tag/4.0.2-rc.1) with some minor improvements.
  92. ### New features / Improvements
  93. - Added `insertTag` option to control the placement of the `tags` option [https://github.com/select2/select2/pull/4008]
  94. - Added handler for AJAX errors [https://github.com/select2/select2/issues/3501]
  95. - Added insertTag to control the tag position [https://github.com/select2/select2/pull/4008]
  96. ### Bug fixes
  97. - Fixed positioning issues with static dropdown parents [https://github.com/select2/select2/issues/3970]
  98. - Fixed existing selections not always being respected with array data [https://github.com/select2/select2/issues/3990]
  99. - Sanitize automatically generated ids so CSS identifiers can be used [https://github.com/select2/select2/issues/3618]
  100. - Recursively apply defaults so AJAX defaults can be set [https://github.com/select2/select2/commit/983cd8e765c5345bfe7d3bdcc3b0c882a35461ca]
  101. - No need to recalculate the top of the dropdown twice [https://github.com/select2/select2/pull/4155]
  102. ### Documentation
  103. - Updated Bootstrap and Font Awesome dependencies [https://github.com/select2/select2/commit/a5e539b509778eabeb8ce79e191b3ee1e81f6deb, https://github.com/select2/select2/commit/81a4a68b113e0d3e0fb1d0f8b1c33ae1b48ba04f, https://github.com/select2/select2/commit/6369f5f173fb81ec692213782945cc737e248da5]
  104. - Use Jekyll's highlighting instead of prettify [https://github.com/select2/select2/commit/54441e6a22be3969dd934ccb769f5d7dde684bfb, https://github.com/select2/select2/commit/74387b98632c75b06d15d83ad5359b9daf0f5dcb, https://github.com/select2/select2/commit/a126b53b4c90fac33b5d855894647cd8bcac3558, https://github.com/select2/select2/commit/75163d67cb80e4279965a97e9eeda5b171806085]
  105. - Corrected responsive width example to properly show it working [https://github.com/select2/select2/commit/63d531a9c0ab51f05327492a56f3245777762b45]
  106. - Replaced protocol-relative URLs with HTTPS protocol [https://github.com/select2/select2/pull/4127]
  107. - Code snippets for mapping `id` and `text` [https://github.com/select2/select2/issues/4086]
  108. - Document how to trigger `change` just for Select2 [https://github.com/select2/select2/issues/3620]
  109. - Added notes about DOM events [https://github.com/select2/select2/commit/37dbe059fce4578b46b7561e6243b7fdc63ac002]
  110. ### Translations
  111. - Correct Romanian translation [https://github.com/select2/select2/commit/72d905f9e026d49e7c600f37a1ce742c404654d7]
  112. ## 4.0.1
  113. This is the first bugfix release of Select2 4.0.0. It builds upon the [first release candidate of Select2 4.0.1](https://github.com/select2/select2/releases/tag/4.0.1-rc.1) with some minor improvements.
  114. ### New features / improvements
  115. - The option container is now passed in as the second argument when templating selections using `templateResult` [https://github.com/select2/select2/commit/dc516e7073605723be59bc727b96a3b3dea1ae5a]
  116. - The option container is now passed in as the second argument when templating selections using `templateSelection` [https://github.com/select2/select2/pull/3324]
  117. - You can immediately start typing to search when tabbing into a multiple select [https://github.com/select2/select2/commit/02cca7baa7b78e73cdcf393172ee3a54be387167, https://github.com/select2/select2/commit/79cdcc0956e242c1ce642bbaa93e538c54f4be0]
  118. - All parameters passed in for AJAX requests are now set as query string parameters by default [https://github.com/select2/select2/issues/3548]
  119. ### Bug fixes
  120. - The search box will now be properly sized after removing a selection [https://github.com/select2/select2/commit/5f80c5d9f81f3c5398c3e6e3e84fd6c67c8873f1]
  121. - Dropdown results will now be spoken by screen readers [https://github.com/select2/select2/commit/9fae3d74e373fc646da4e39a0c2ab11efa808c3f]
  122. - Options are now properly cloned when initializing multiple instances at once [https://github.com/select2/select2/commit/3c8366e8769233a6b20ade934fe629279e7be6ff]
  123. - `selectOnClose` and now be used with `closeOnSelect` without getting a stack overflow [https://github.com/select2/select2/commit/393ca4cf7f7f7097d3a994bda3dbf195e945eba1]
  124. - Fixed positioning with non-static parents [https://github.com/select2/select2/commit/c9216b4b966653dd63a67e815b47899ef5325298]
  125. - Fixed bug where multiple selects with placeholders were buggy in IE [https://github.com/select2/select2/issues/3300]
  126. - Fixed bug where AJAX selects could not be initialized with array data [https://github.com/select2/select2/pull/3375]
  127. - `:all:` is now correctly removed when used in `containerCss` and `dropdownCss` options [https://github.com/select2/select2/pull/3464]
  128. - Fixed bug where the multiple select search box would appear on the left in RTL mode [https://github.com/select2/select2/pull/3502]
  129. - Change ALT + UP to close the dropdown instead of opening it [https://github.com/select2/select2/commit/d2346cc33186c2a00fa2dad29e8e559c42bfea00]
  130. - Fix focus issue with the multiple select search box when the `change` event was triggered [https://github.com/select2/select2/commit/698fe7b9e187e182f679aa679eb8b0ecb64a846b, https://github.com/select2/select2/commit/88503d2c67dc7f4fb9395a17f17edfe4948cf738, https://github.com/select2/select2/commit/dd2990adead92593a2dffff6ae004ea8b647d130]
  131. - Fix bug in `ArrayAdapter` where the existing `<option>` data would be used instead of the array data [https://github.com/select2/select2/pull/3565]
  132. - Remove random call to `$dropdownContainer.width()` in the `AttachBody` decorator [https://github.com/select2/select2/pull/3654]
  133. - Fix memory leak in `AttachBody` decorator [https://github.com/select2/select2/commit/671f5a2ce21005090e0b69059799cd3dd1fbbf84]
  134. - Selections can no longer be removed when Select2 is in a disabled state [https://github.com/select2/select2/commit/68d068f1d2c7722d011d285a291d1f974bf09772, https://github.com/select2/select2/commit/7d8f86cbf85ebd2179195ff6a2a7a1c5dcb9da58]
  135. - Remove redundant `open` event trigger [https://github.com/select2/select2/pull/3507]
  136. - Correct references to `this` in `ajax.data` and `ajax.url` callback functions [https://github.com/select2/select2/issues/3361]
  137. - Apply select2('option') calls on all elements [https://github.com/select2/select2/pull/3495]
  138. ### Design
  139. - Fixed original `<select>` not always being hidden correctly in some cases [https://github.com/select2/select2/pull/3301]
  140. - Fix potential issue with Bootstrap's gradients in Internet Explorer [https://github.com/select2/select2/pull/3307]
  141. - Improve compatibility with Zurb Foundation [https://github.com/select2/select2/pull/3290]
  142. - Remove padding on mobile safari search field in multiple selects [https://github.com/select2/select2/pull/3605]
  143. - Fix the clear button appearing beneath long text [https://github.com/select2/select2/issues/3306]
  144. - Migrate the CSS classes for the "Loading more results" message to BEM [https://github.com/select2/select2/issues/3889]
  145. - Fix inline search not displaying properly in Safari [https://github.com/select2/select2/issues/3459]
  146. ### Documentation
  147. - New documentation theme designed by @fk [https://github.com/select2/select2/pull/3376, https://github.com/select2/select2/pull/3467, https://github.com/select2/select2/pull/3488]
  148. - Update ajax example to reflect pagination [https://github.com/select2/select2/pull/3357]
  149. - Fix incorrect option name in `maxiumSelectionLength` example [https://github.com/select2/select2/pull/3454]
  150. - Fix typos in the disabled mode/results examples [https://github.com/select2/select2/pull/3665]
  151. - Fix `Option` parameters in the 4.0 announcement [https://github.com/select2/select2/pull/3547]
  152. - Fix invalid JSON in the tags example within the 4.0 announcement [https://github.com/select2/select2/pull/3637]
  153. ### Translations
  154. - Added Cyrillic variant of the Serbian language [https://github.com/select2/select2/pull/3943]
  155. - Corrected Thai "no results found" translation [https://github.com/select2/select2/pull/3782]
  156. - Swapped the `inputTooLong` and `inputTooShort` messages in the Galician translation [https://github.com/select2/select2/pull/3291]
  157. - Fix improper grammar in Dutch translation [https://github.com/select2/select2/pull/3692]
  158. - Add Japanese translation [https://github.com/select2/select2/pull/3477]
  159. - Polish translation: Fixed typo in maximum selected message [https://github.com/select2/select2/pull/3587]
  160. - Add Malay translation [https://github.com/select2/select2/pull/3635]
  161. - Add `errorLoading` for Indonesian translation [https://github.com/select2/select2/pull/3635]
  162. - Correct grammar issues in Hebrew translation [https://github.com/select2/select2/pull/3911]
  163. - Add `errorLoading` for Danish translation [https://github.com/select2/select2/pull/3870]
  164. - Add Arabic translation [https://github.com/select2/select2/pull/3859]
  165. ## 4.0.0
  166. This builds upon [the second release candidate](https://github.com/select2/select2/tree/4.0.0-rc.2), **so review all previous release notes** before upgrading from previous versions of Select2.
  167. ### Supported environments
  168. - jQuery 1.7.2+
  169. - Modern browsers (Chrome, Firefox, Safari)
  170. - Internet Explorer 8+
  171. ### New features
  172. - Fully compatible with AMD and UMD based loaders.
  173. - Advanced plugin system that [uses custom adapters](https://select2.org/advanced/adapters-and-decorators).
  174. - Full support for `jQuery.noConflict`.
  175. - A `<select>` is the recommended element and [can be used for all options](https://select2.org/upgrading/migrating-from-35#no-more-hidden-input-tags). There is limited backwards-compatible support for the `<input>` element in [full builds](https://select2.org/getting-started/builds-and-modules).
  176. - [Declarative configuration through `data-*` attributes](https://select2.org/configuration/data-attributes)
  177. - Easy to configure theme system and new default theme
  178. - You can use more specific locales (like `en-US`) and Select2 will be able to determine what translation files to load.
  179. ### Breaking changes
  180. - Select2 now uses the MIT license
  181. - [The full build](https://select2.org/getting-started/builds-and-modules) of Select2 no longer includes jQuery - You must include jQuery separately on your page.
  182. - Select2 will prevent the inner scrolling of modals (and other scrollable containers) when it is open to prevent the UI from breaking. [Read more at the commit.](https://github.com/select2/select2/commit/003d6053a9fff587c688008397e7d5824463fe99)
  183. - jQuery is no longer listed as a dependency in the `bower.json`/`component.json` files.
  184. - [`<select>` has replaced `<input type="hidden" />`](https://select2.org/upgrading/migrating-from-35#no-more-hidden-input-tags) for **all options** (_including remote data_)
  185. - The [`matcher` has been revamped](https://select2.org/upgrading/migrating-from-35#advanced-matching-of-searches) to include full context, a compatibility module (`select2/compat/matcher`) has been created
  186. - The [display always reflects the order](https://select2.org/upgrading/migrating-from-35#display-reflects-the-actual-order-of-the-values) data is sent to the server
  187. - The click mask is no longer the default (again). You can get back the old functionality by wrapping your `selectionAdapter` with the `ClickMask` (`select2/selection/clickMask`) decorator.
  188. - Select2 no longer stops the propagation of events happening within the dropdown and selection. You can use the `StopPropagation` modules available in the [full builds](https://select2.org/getting-started/builds-and-modules) to prevent this. [https://github.com/select2/select2/commit/8f8140e3b00c5d5bb232455137c4c633d7da4275]
  189. - The enter key no longer toggles the state of multiple select items in the results, but instead will only select them. Use CTRL + Space instead to toggle the state. [https://github.com/select2/select2/commit/017c20109471fa5b835603faf5dc37f7c2c2ea45]
  190. - Warnings will now be triggered in the developer console if Select2 detects an unsupported configuration.
  191. #### Options
  192. - The default value of the `width` option has been changed from `style` to `resolve`.
  193. - The `copy` value for the `width` option has been renamed to `style`.
  194. ##### Renamed
  195. - `formatSelection` -> `templateSelection`
  196. - `formatResult` -> `templateResult`
  197. - `sortResults` -> `sorter`
  198. - `createSearchChoice` -> `createTag`
  199. - `selectOnBlur` -> `selectOnClose`
  200. - `ajax.jsonpCallback` -> `ajax.jsonp`
  201. - `ajax.results` -> `ajax.processResults`
  202. - `tags: [array,of,data]` -> `data: [array,of,data], tags: true`
  203. - `placeholderOption` has been replaced by `placeholder.id` (`placeholder` -> `placeholder.text`)
  204. ##### [Internationalization](https://select2.org/i18n)
  205. - `formatNoMatches` -> `language.noMatches`
  206. - `formatSearching` -> `language.searching`
  207. - `formatInputTooShort` -> `language.inputTooShort`
  208. - `formatInputTooLong` -> `language.inputTooLong`
  209. - `formatAjaxError` -> `language.errorLoading`
  210. - `formatLoading` -> `language.loadingMore`
  211. - `formatSelectionTooBig` -> `language.maximumSelected`
  212. ##### Deprecated/Removed
  213. - `initSelection` - This is [no longer needed](https://select2.org/upgrading/migrating-from-35#removed-the-requirement-of-initselection) with `<select>` tags. Limited backwards compatibility in the [full build](https://select2.org/getting-started/builds-and-modules).
  214. - `id` - Data objects should now always have `id` and `text` attributes that are strings, use [`$.map`](https://api.jquery.com/jquery.map/) when migrating
  215. - `query` - Use a [custom data adapter](https://select2.org/upgrading/migrating-from-35#custom-data-adapters-instead-of-query) instead. Limited backwards compatibility in the [full build](https://select2.org/getting-started/builds-and-modules).
  216. - `ajax.params` - All parameters passed to `ajax` will be passed to the AJAX data transport function
  217. #### Methods
  218. ##### Renamed
  219. - `.select2("val", [value])` -> `.val([value])`
  220. - `.select2("enable", !disabled)` -> `.prop("disabled", disabled)`
  221. ##### Removed
  222. - `.select2("onSortStart")` and `.select2("onSortEnd")` - A custom [selection adapter](https://select2.org/advanced/default-adapters/selection) should be created instead
  223. - `.select2("data", data)` - Create the `<option>` tags for the objects that you would like to set, and set the `.val` to select them
  224. - `.select2("readonly")` - There is [no way to make a `<select>` element read-only](http://stackoverflow.com/q/368813/359284), disable it instead
  225. #### Events
  226. ##### New
  227. - `select2:closing` is triggered before the dropdown is closed
  228. - `select2:select` is triggered when an option is selected
  229. ##### Renamed
  230. - `select2-close` is now `select2:close`
  231. - `select2-open` is now `select2:open`
  232. - `select2-opening` is now `select2:opening`
  233. - `select2-selecting` is now `select2:selecting`
  234. - `select2-removed` is now `select2:unselect`
  235. - `select2-removing` is now `select2:unselecting`
  236. ##### Removed
  237. - `select2-clearing` has been removed in favor of `select2:unselecting`
  238. - `select2-highlight`
  239. - `select2-loaded`
  240. - `select2-focus` - Use the native `focus` event instead
  241. - `select2-blur` - Use the native `blur` event instead
  242. - All extra properties from the `change` event were removed
  243. - `val` can be retrieved with `$element.val()` instead
  244. - `added` can be retrieved by listening to `select2:select`
  245. - `removed` can be retrieved by listening to `select2:unselect`