react-select

Minor Changes

• 6d28ed76 #5993 Thanks @onihani! - Export the FilterOptionOption type

Minor Changes

• 01206c33 #5984 Thanks @Thris3n! - Add React 19 to peer dependency range

Patch Changes

• 111efad1 #5974 Thanks @j2ghz! - Fix types compatibility with React 19

Patch Changes

• 781284a9 #5771 Thanks @tu4mo! - Fix for calling non-cancellable scroll events

Patch Changes

• dd740ced #5960 Thanks @leonaves! - No longer send pop-value action when multi-select is empty. This correctly resolves typings with that event, where removedValue cannot be undefined.

Minor Changes

• 884f1c42 #5758 Thanks @Ke1sy! - 1. Added 'aria-activedescendant' for input and functionality to calculate it;

  1. Added role 'option' and 'aria-selected' for option;
  2. Added role 'listbox' for menu;
  3. Added tests for 'aria-activedescendant';
  4. Changes in aria-live region:
  • the instructions how to use select will be announced only one time when user focuses the input for the first time.
  • instructions for menu or selected value will be announced only once after focusing them.
  • removed aria-live for focused option because currently with correct aria-attributes it will be announced by screenreader natively as well as the status of this option (active or disabled).
  • separated ariaContext into ariaFocused, ariaResults, ariaGuidance to avoid announcing redundant information and higlight only current change.

Patch Changes

• 224a8f0d #5666 Thanks @yhy-1! - Add aria-disabled to select's control component.

Patch Changes

• f6315cd5 #5672 Thanks @tu4mo! - Fix for calling non-cancellable scroll events

Patch Changes

• 9d1730ba #5347 Thanks @aszmyd! - Make scroll lock div work on a document context it belongs to

Patch Changes

• 16414bb5 #5689 Thanks @Rall3n! - Resolve defaultProps deprecation warning for React v18+.

Patch Changes

• 59513d00 #5626 Thanks @emmatown! - Fix importing react-select in Node ESM

Patch Changes

• 925cd4a2 #5536 Thanks @Rall3n! - required prop accessibiltiy and functionality improvements

Patch Changes

• 597143ee #5559 Thanks @gdiazdelaserna! - Add exports field in package.json

Minor Changes

• 0773095f #5457 Thanks @nderkim! - Add classNames API and unstyled prop

Patch Changes

• cda16826 #5482 Thanks @nderkim! - Fix unstable theme rerendering menu

Minor Changes

• c37e86d8 #4882 Thanks @Rall3n! - Add required prop

Patch Changes

• 851ed2b8 #5430 Thanks @Rall3n! - Fix focused option if defaultMenuIsOpen is set

Patch Changes

• 1ad6de4e #5084 Thanks @kosciolek! - When focusing a dropdown option, the numbers included in the aria live region take filtering into consideration.

Patch Changes

• 0ca2d5ba #5431 Thanks @nderkim! - Change class components to functional components

Patch Changes

• 92398939 #5409 Thanks @lukebennett88! - Move files around to as to be compatible with version 2 of @preconstruct/cli

Patch Changes

• 0dd38029 #5246 Thanks @Rall3n! - Fix re-focus of component in Firefox if being disabled while focused

Patch Changes

• ebb0a17a #5404 Thanks @Methuselah96! - Use ResizeObserver to auto-update menu position if available

Patch Changes

• 07656aaa #5399 Thanks @dependabot! - Update memoize-one

Patch Changes

• 00238f1a #5376 Thanks @lukebennett88! - Fix bug with animated multi-value select width being too wide

Patch Changes

• 0f6ef093 #5381 Thanks @Methuselah96! - Disable use of ResizeObserver for menu position auto-updating to avoid potential breaking changes.

Minor Changes

• 598f9ee0 #5256 Thanks @Methuselah96! - Auto-update menu position when using menu portalling

Minor Changes

• 5d49f70a #5249 Thanks @Methuselah96! - Export formatOptionLabel types (i.e., FormatOptionLabelMeta and FormatOptionLabelContext).

Patch Changes

• 1f140e42 #5177 Thanks @Methuselah96! - Fix view height used for menu positioning to be the scroll parent instead of the window

Patch Changes

• 03bf7351 #5164 Thanks @Methuselah96! - Bump @emotion/react to ^11.8.1 to avoid useInsertionEffect bug

Minor Changes

• c7d8d4b3 #5133 Thanks @nil4! - Update peerDependencies to include React 18

Patch Changes

• 0aaa9575 #5134 Thanks @rkulinski! - Use defaultPrevented to skip duplicate event handler for clicking select.

• 87e14431 #5131 Thanks @pcorpet! - Avoid referencing an ID that is not in the DOM

• 7184d538 #5082 Thanks @Methuselah96! - Fix type inference for Async's loadOptions prop

• bd4ee8ae #5057 Thanks @Rall3n! - Prevent transition props from being forwarded to <input> element in DummyInput component

Patch Changes

• 940a50b1 #4928 Thanks @Methuselah96! - Fix usage with esModuleInterop disabled

• 54f9538e #4941 Thanks @prichey! - Use React's AriaAttributes type directly rather than recreating

• e97d45c0 #4908 Thanks @vjee! - Make 3rd argument of CommonProps['setValue'] optional.

Patch Changes

• f172d7f9 #4886 Thanks @Akridian! - Hooks for creation of custom Selects are now exported from main entry

Minor Changes

• 6c7a3d1e #4785 Thanks @Rall3n! - Add prevInputValue to action meta

• b522ac65 #4860 Thanks @ebonow! - Fix animated MultiValue transitions when being removed and change method used to generate unique keys for Option components. Closes #4844 , closes #4602

Patch Changes

• 417e7217 #4842 Thanks @Methuselah96! - Remove src directory from published package

• 480ea85b #4846 Thanks @Methuselah96! - Add missing index to MultiValue props type

• b8e34472 #4854 Thanks @mikunpham! - Make input container css re-compute whenever input value changes due to a bug from @emotion/react in development env.

Minor Changes

• 8b38d49b #4807 Thanks @hcharley! - Export AsyncCreatableProps from creatable entrypoint

• 46eeda1a #4801 Thanks @Methuselah96! - Export more types from main entry point

Patch Changes

• fdd01e66 #4833 Thanks @ebonow! - Value container display property should be grid when isMulti and has no value so the Placeholder component is positioned correctly with the Input

• 0937604f #4823 Thanks @mikunpham! - Fix the issue where input contents are moved to the left due to multiple space characters.

• ec80b577 #4803 Thanks @Methuselah96! - Import CSSObject from @emotion/react instead of @emotion/serialize

Major Changes

• ef87c3ac #4683 Thanks @JedWatson! - React-Select has been converted from Flow to TypeScript.

  Other changes for v5 include usage of forwardRef, new hooks for stateManager, async and creatable components, and more reliable filtering implementation with new options in the creatable variant.

Patch Changes

• 10225290 #4720 - Updated the layout for the singleValue input/placeholder/container so that it works better when used in flex layouts.

• 53f1972b #4731 Thanks @JedWatson! - MultiValue key now includes a hyphen between the value and the index to prevent edge cases where you could get a duplicate key error

• b41f4ceb #4704 Thanks @Rall3n! - Fix findDOMNode deprecation by adding refs to transition components

• 4b028829 #4634 - The readonly attribute has been removed from the DummyInput to improve accessibility

• 7fcec537 #4697 - Add the role of combobox and the required ARIA attributes to the Input and DummyInput components to allow JAWS support and a better screen reader experience overall.

• ca2c0e5b #4756 Thanks @fdcds! - Add option field to type of CreateOptionActionMeta

• 9e82aadc #4676 - The following improvements have been made for screen reader users:

  • NVDA now announces the context text when initially focused
  • Selected option/s (single and multi) are now announced when initially focused
  • VoiceOver now announces the context text when re-focusing
  • The clear action is now announced
  • Placeholder text is now announced
  • Mobile VoiceOver is now able to remove selected multi options

• 638f5455 #4702 Thanks @Methuselah96! - The Option generic is no longer required to extend the OptionBase type

• 23cea0b5 #4782 Thanks @Methuselah96! - Fix type of loadingMessage prop to allow it to return any ReactNode

Patch Changes

• 10225290 #4720 - Updated the layout for the singleValue input/placeholder/container so that it works better when used in flex layouts.

• 53f1972b #4731 Thanks @JedWatson! - MultiValue key now includes a hyphen between the value and the index to prevent edge cases where you could get a duplicate key error

• b41f4ceb #4704 Thanks @Rall3n! - Fix findDOMNode deprecation by adding refs to transition components

• 7fcec537 #4697 - Add the role of combobox and the required ARIA attributes to the Input and DummyInput components to allow JAWS support and a better screen reader experience overall.

• 9e82aadc #4676 - The following improvements have been made for screen reader users:

  • NVDA now announces the context text when initially focused
  • Selected option/s (single and multi) are now announced when initially focused
  • VoiceOver now announces the context text when re-focusing
  • The clear action is now announced
  • Placeholder text is now announced
  • Mobile VoiceOver is now able to remove selected multi options

• 638f5455 #4702 Thanks @Methuselah96! - The Option generic is no longer required to extend the OptionBase type

Major Changes

• ef87c3ac #4489 Thanks @Methuselah96! - React-Select has been converted from Flow to TypeScript.

  Other changes for v5 include usage of forwardRef, new hooks for stateManager, async and creatable components, and more reliable filtering implementation with new options in the creatable variant.

• #4625 Thanks @ebonow! - Remove dependency on AutoSizeInput

  • BREAKING CHANGES:
    • IE11 no longer works as it does not fully support CSS grid
    • Renaming the .prefix__input now targets the input and NOT the container. Unfortunate but overdue and perhaps opens the door to completely decoupling the input from needing a container if autosizing is not important.

Patch Changes

• 4b028829 #4634 - The readonly attribute has been removed from the DummyInput to improve accessibility

---

Patch Changes

• 2c915d10 #4577 - Bump @emotion/cache to v11.4.0 which fixes an issue where different versions of Emotion running at the same time causes styles to disappear in production.

Minor Changes

• 035294f4 #3360 Thanks @JedWatson! - Now pass the focusedOption to the MenuList Component as a prop

Patch Changes

• 7a414a7c #3262 Thanks @JedWatson! - The Menu bottom is no longer scrolled into view when menuShouldScrollIntoView=false

Patch Changes

• ca3c41bb #4478 Thanks @ebonow! - Check passive events polyfill for the existence of window for SSR

Minor Changes

• 2ffed9c6 #4444 Thanks @Rall3n! - Use accessor props to get value and label in compareOption

• 2baf5a9d #4414 Thanks @ebonow! - Add ariaLiveMessages prop for internationalization and other customisations

• 7cdb8a6b #4391 Thanks @ebonow! - Pass and sanitize CommonProps passed to Group and Input components

Patch Changes

• c955415c #4437 Thanks @ebonow! - Set event listeners to be non-passive to remove Chrome console warnings

• 3ca22b2f #3827 Thanks @emmatown! - Memoize stripDiacritics in createFilter for the input with memoize-one so that stripDiacritics is not called for the same string as many times as there are options every time the input changes

  Inspired by https://blog.johnnyreilly.com/2019/04/react-select-with-less-typing-lag.html

• dce3863f #4423 Thanks @Methuselah96! - Remove browser alias fields in order to fix SSR apps

• ec7c0728 #4443 Thanks @ebonow! - Allow tabIndex prop Type to be number or string

Minor Changes

• b5f9b0c5 #4342 Thanks @Methuselah96! - Standardized innerProps and className props on customisable components

• 19b76342 #3911 Thanks @eugenet8k! - Add removedValues to onChange event meta when the action is clear (when the user clears the value in the Select)

Patch Changes

• f600d13f #4422 Thanks @Methuselah96! - Fix finding focusable options for groups

• a016c878 #4420 Thanks @Methuselah96! - Bump dependency on @babel/runtime in order to fix compatibility issues with Webpack 5

• 10b5f5a5 #4404 Thanks @Methuselah96! - Remove unnecessary dependency on @emotion/css

Patch Changes

• 44f285b0 #4399 Thanks @Methuselah96! - Fixed building focusable options from groups

Patch Changes

• 645feb3e #4396 Thanks @Methuselah96! - Fixed keys for options within groups

Major Changes

• 02050675 #4339 Thanks @Methuselah96! - Standardized value passed to onChange

• 26b6325c #4283 Thanks @majgaard! - Upgrades Emotion dependency to v11.0.0

  BREAKING CHANGE: The NonceProvider component now requires a cacheKey prop that corresponds to the key for the Emotion cache.

• b2488bb5 #4313 Thanks @Methuselah96! - Removed usages of UNSAFE React methods

Patch Changes

• 2d5496d5 #4388 Thanks @Methuselah96! - Removed memoization of buildMenuOptions

Minor Changes

• c615e93d #4084 Thanks @JedWatson! - Changed the cx and getValue props that are passed to components into instance properties, which means they now pass a referential equality check on subsequent renders.

  This is helpful, for example, when you're optimising the performance of rendering custom Option components - see #3055

• 72f6036f #4306 Thanks @bladey! - Remove duplicate prop createOptionPosition

Patch Changes

• ee638d46 #4275 Thanks @Methuselah96! - Adds react ^17.0.0 to peer dependencies for React 17 support

• a0133f19 #4154 Thanks @brenshanny! - Creatable: Fixed removing MultiValues that have identical values. See issue #4137 for details.

• d1e660c6 #4213 Thanks @eythort! - Added a guard to the ScrollCaptor component to check that el exists before calling removeEventListener, fixes intermittent errors

• a1e1db25 #4373 Thanks @Methuselah96! - Fixed value passed to onChange when clearing value

• 2ad29d61 #4136 Thanks @Methuselah96! - Base aria-live message on tabSelectsValue prop

• ad890f27 #4326 Thanks @Methuselah96! - Updated react-input-autosize to v3.0.0

• b28d9922 #3990 Thanks @nikitaindik! - Fixed onCreateOption is not always called for Creatable

• 24ba8702 #4289 Thanks @slimklim! - Added innerProps prop to the built-in MenuList component to reduce the need for additional DOM nodes or forking internal code when passing additional props to the DOM element the MenuList component is rendering.

  See issue #4265 for an explanation.

Patch Changes

• c8d74bd5 #3979 Thanks @emmatown! - Fix repository field

• c8447f48 #4034 Thanks @sophiebits! - Improve performance of option filtering when ignoreAccents is enabled (the default)

• 7af1aafb #4295 Thanks @JedWatson! - Fix menuplacement context

• 32ad5c04 #3892 Thanks @flexdinesh! - Fix react-select ignoring HTML5 "form" attribute

• 6af14fbb #3897 Thanks @lorisdev! - Removes the call to onMenuOpen on every input change

  If you were relying on this undesired behavior it may be a breaking change. Please upgrade accordingly.

• 0eb1ef96 Thanks @JedWatson! - Fixes touch issues in IE11

• ad608c8f #3928 Thanks @dpordomingo! - Update MenuPlacer context usage in order to the new React Context API

Minor Changes

• 4cf6c43c #3690 Thanks @JedWatson! - Add isLoading prop support to the AsyncSelect component (see #3690)

Patch Changes

• 83b48de4 #3868 Thanks @Tirzono! - Fix for not focusing the selected value when the menu opens
• 563b046a #3794 Thanks @emmatown! - Convert class components that don't have to be class components to function components to reduce bundle size
• c7e9c697 #3682 Thanks @JedWatson! - Allow the input component to be a textarea element
• 3c7de0de #3090 Thanks @akiselev! - Add aria attributes to dummy input
• d2a820ef #3537 Thanks @jdelStrother! - Fix Flow issues. Refer to the linked PR for more details on the specific issues.
• fc52085b #3662 Thanks @eemeli! - Update react-transition-group to ^4.3.0
• edb18dd3 #3797 Thanks @emmatown! - Enable Babel loose mode to improve bundle size

Patch Changes

• a575a3c4 #3727 Thanks @tonytangau! - Adding an index prop to MultiValue components
• 916f0d2c #3644 Thanks @TrySound! - Remove usage of raf package and replace with window.requestAnimationFrame because React already depends on requestAnimationFrame
• cba15309 #3676 Thanks @wiesys! - Fix loadingMessage and noOptionsMessage properties in Styles flow type
• 32f9475e #3790 Thanks @JedWatson! - Remove unnecessary dependency on classnames package
• 1731175d #3733 Thanks @ddc67cd! - Pass name to onChange meta in Creatable to make it consistent with onChange in standard Select

Patch Changes

• df864f2 - Include updated yarn.lock

Patch Changes

• 3e0a7a7 - * remove emotion 9 dep from mono repo (this wasn't being used anywhere)
  • update dep on react-input-autosize to 2.2.2 (adds UNSAFE prefix to deprecated lifecycles) (resolves #3773)

Patch Changes

• 270cc01 #3719 Thanks @jossmac! - Leverage currentColor for loading indicator dots -- makes styling easier, and more consistent, for consumers
• bab8af1 - Update lifecycle methods with UNSAFE prefix

Patch Changes

• cd8c3090 #3586 Thanks @emmatown! - Add base entrypoint back

• #3569 Thanks @vadimka123 - Performance improvement: menu items are built when the menu opens, not in the constructor

• #3326 Thanks @stevemao Fix for iOS focus management when clearing the select value

• #3532 Thanks @alisonhall! - Change aria-live assertive to polite

• Remove base entrypoint to fix rollup dependency resolution issue

• fix erroneous build

• [patch]:

  • Add README.md file for npm

• [major]9ad152b #3574 Thanks @gwyneplaine:
  • Upgrade emotion dependency from 9.x to 10.x #3321
  • Normalize Values #3416
  • Separate entrypoints for Async, Creatable and makeAnimated #3541
  • UMD builds deprecated
  • required react peer-dependecy of 16.8