This is the first release of Select2 4.0. You can view the release announcement for an overview of the larger changes.

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

• Fully compatible with AMD and UMD based loaders.
• Advanced plugin system that uses custom adapters.
• Full support for jQuery.noConflict.
• A <select> is the recommended element once again and can be used for all options.

DOM 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:removed
• select2-removing is now select2:unselecting

Removed

• select2-clearing has been removed in favor of select2:unselecting
• select2-highlight
• select2-loaded
• select2-focus
• select2-blur
• 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