1
0
mirror of synced 2024-11-24 22:06:07 +03:00
select2/CHANGELOG.md
2019-04-30 23:37:24 -04:00

22 KiB

Change Log

4.0.7

New features/improvements

  • Do not close on select if Ctrl or Meta (Cmd) keys being held (#5222)

Bug fixes

  • Fixed issue where single select boxes would automatically reopen when they were closed (#5490, #5492)

Miscellaneous

  • Move almost and jquery-mousewheel to devDependencies (#5489)

4.0.6

New features/improvements

  • Add style property to package.json (#5019)
  • Implement clear and clearing events (#5058)
  • Add scrollAfterSelect option (#5150)
  • Add missing diacritics (#4118, #4337, #5464)

Bug fixes

  • Fix up arrow error when there are no options in dropdown (#5127)
  • Add ; before beginning of factory wrapper (#5089)
  • Fix IE11 issue with select losing focus after selecting an item (#4860)
  • Clear tooltip from select2-selection__rendered when selection is cleared (#4640, #4746)
  • Fix keyboard not closing when closing dropdown on iOS 10 (#4680)
  • User-defined types not normalized properly when passed in as data (#4632)
  • Perform deep merge for Defaults.set() (#4364)
  • Fix "the results could not be loaded" displaying during AJAX request (#4356)
  • Cache objects in Utils.__cache instead of using $.data (#4346, #5486)
  • Removing the double event binding registration of selection:update (#4306)

Accessibility

  • Improve .select2-hidden-accessible (#4908)
  • Add role and aria-readonly attributes to single selection dropdown value (#4881)

Translations

  • Add Turkmen translations (tk) (#5125)
  • Fix error in French translations (#5122)
  • Add Albanian translation (sq) (#5199)
  • Add Georgian translation (ka) (#5179)
  • Add Nepali translation (ne) (#5295)
  • Add Bangla translation (bn) (#5248)
  • Add removeAllItems translation for clear "x" title (#5291)
  • Fix wording in Vietnamese translations (#5387)
  • Fix error in Russian translation (#5401)

Miscellaneous

  • Remove duplicate CSS selector in classic theme (#5115)

4.0.5

Bug fixes

  • Replace autocapitalize=off with autocapitalize=none (#4994)

Translations

  • Vietnamese: remove an unnecessary quote mark (#5059)
  • Czech: Add missing commas and periods (#5052)
  • Spanish: Update the 'errorLoading' message (#5032)
  • Fix typo in Romanian (#5005)
  • Improve French translation (#4988)
  • Add Pashto translation (ps) (#4960)
  • Add translations for lower and upper Sorbian (dsb and hsb) (#4949)
  • Updates to Slovak (#4915)
  • Fixed Norwegian inputTooShort message (#4817, 4896)
  • Add Afrikaans translation (af) (#4850)
  • Add Bosnian translation (bs) (#4504)

4.0.4

New features / Improvements

Bug fixes

  • Fix issue with entire form losing focus when tabbing away from a Select2 control (#4419)
  • Fix UMD support for CommonJS [45a8773454]

Documentation

Translations

4.0.3

This is the third bugfix release of Select2 4.0.0. It builds upon the second bugfix release and fixes many common issues.

New features / Improvements

  • The old dropdownAutoWidth option now properly works [fe26b083eb]
  • A focus event on the original <select> is now handled [31e7a1d4c5]
  • Adding and removing options now refreshes the selection automatically [ea79a197e0]

Bug fixes

Documentation

Translations

4.0.2

This is the second bugfix release of Select2 4.0.0. It builds upon the first release candidate of Select2 4.0.2 with some minor improvements.

New features / Improvements

Bug fixes

Documentation

Translations

4.0.1

This is the first bugfix release of Select2 4.0.0. It builds upon the first release candidate of Select2 4.0.1 with some minor improvements.

New features / improvements

Bug fixes

Design

Documentation

Translations

4.0.0

This builds upon the second release candidate, so review all previous release notes before upgrading from previous versions of Select2.

Supported environments

  • jQuery 1.7.2+
  • Modern browsers (Chrome, Firefox, Safari)
  • Internet Explorer 8+

New features

Breaking changes

  • Select2 now uses the MIT license
  • The full build of Select2 no longer includes jQuery - You must include jQuery separately on your page.
  • 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.
  • jQuery is no longer listed as a dependency in the bower.json/component.json files.
  • <select> has replaced <input type="hidden" /> for all options (including remote data)
  • The matcher has been revamped to include full context, a compatibility module (select2/compat/matcher) has been created
  • The display always reflects the order data is sent to the server
  • 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.
  • 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 to prevent this. [8f8140e3b0]
  • 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. [017c201094]
  • Warnings will now be triggered in the developer console if Select2 detects an unsupported configuration.

Options

  • The default value of the width option has been changed from style to resolve.
  • The copy value for the width option has been renamed to style.
Renamed
  • formatSelection -> templateSelection
  • formatResult -> templateResult
  • sortResults -> sorter
  • createSearchChoice -> createTag
  • selectOnBlur -> selectOnClose
  • ajax.jsonpCallback -> ajax.jsonp
  • ajax.results -> ajax.processResults
  • tags: [array,of,data] -> data: [array,of,data], tags: true
  • placeholderOption has been replaced by placeholder.id (placeholder -> placeholder.text)
Internationalization
  • formatNoMatches -> language.noMatches
  • formatSearching -> language.searching
  • formatInputTooShort -> language.inputTooShort
  • formatInputTooLong -> language.inputTooLong
  • formatAjaxError -> language.errorLoading
  • formatLoading -> language.loadingMore
  • formatSelectionTooBig -> language.maximumSelected
Deprecated/Removed
  • initSelection - This is no longer needed with <select> tags. Limited backwards compatibility in the full build.
  • id - Data objects should now always have id and text attributes that are strings, use $.map when migrating
  • query - Use a custom data adapter instead. Limited backwards compatibility in the full build.
  • ajax.params - All parameters passed to ajax will be passed to the AJAX data transport function

Methods

Renamed
  • .select2("val", [value]) -> .val([value])
  • .select2("enable", !disabled) -> .prop("disabled", disabled)
Removed
  • .select2("onSortStart") and .select2("onSortEnd") - A custom selection adapter should be created instead
  • .select2("data", data) - Create the <option> tags for the objects that you would like to set, and set the .val to select them
  • .select2("readonly") - There is no way to make a <select> element read-only, disable it instead

Events

New
  • select2:closing is triggered before the dropdown is closed
  • select2:select is triggered when an option is selected
Renamed
  • select2-close is now select2:close
  • select2-open is now select2:open
  • select2-opening is now select2:opening
  • select2-selecting is now select2:selecting
  • select2-removed is now select2:unselect
  • select2-removing is now select2:unselecting
Removed
  • select2-clearing has been removed in favor of select2:unselecting
  • select2-highlight
  • select2-loaded
  • select2-focus - Use the native focus event instead
  • select2-blur - Use the native blur event instead
  • All extra properties from the change event were removed
    • val can be retrieved with $element.val() instead
    • added can be retrieved by listening to select2:select
    • removed can be retrieved by listening to select2:unselect