Skip to contentSkip to navigationSkip to topbar
Paste DSys

Combobox

Version 17.0.3GithubDesign assets pendingPeer review pending

A Combobox is a styled dropdown form element that allows users to either type a value or select a value from a list.

Change Log

17.0.3

Patch Changes

17.0.2

Patch Changes

  • 6040893c0 #4311 Thanks @PixeledCode! - [Base Radio Checkbox, Button, Combobox, File Picker, File Uploader, Input, Input Box, Menu, Select, Textarea, Visual Picker] Update styles of form related components
  • 16e8016a0 #4334 Thanks @serifluous! - Visible changes in dark themes only. Redarkened color-background-weak and added color-background-weaker-elevation

17.0.1

Patch Changes

  • 262c1b715 #4281 Thanks @PixeledCode! - [all packages]: add use client directive to the components and icons. This will make paste library compatible with server components

17.0.0

Major Changes

  • f48211e56 #4258 Thanks @PixeledCode! - [all packages]: Upgrade to React 19 and drop support for React 16. Paste only supports the three latest versions of React. If you're using Paste in a React 17, 18, or 19 app, you should be able to upgrade with full backwards compatibility. If you experience any issues, please let us know on Github.

Patch Changes

16.3.1

Patch Changes

  • 0ed9f3482 #4226 Thanks @PixeledCode! - [Callout, ChatComposer, ChatLog, Combobox, Input, InputBox, Menu, MinimizableDialog, Modal, Popover, SideModal, SidePanel, Sidebar, Toast, Tooltip, Topbar, UserDialog]: Update styles to implement new elevation tokens

16.3.0

Minor Changes

  • 37acfcdf6 #4049 Thanks @nkrantz! - [Combobox] Add new prop usePortal which defaults to true. The prop was introduced to address a bug when Comboboxes are placed in Popovers. usePortal should be set to false when using a Combobox inside a Popover in order to retain full functionality.

Patch Changes

  • f612d1ba6 #4047 Thanks @krisantrobus! - [Combobox] added ellipse styling to text that exceeds length of a single select combobox when not active

16.2.1

Patch Changes

16.2.0

Minor Changes

  • b8d79200b #3442 Thanks @TheSisb! - Removed all run-time prop-type checkingfrom Paste components. Paste now ships with only TypeScript types.

    ACTION NEEDED: None. This should be 100% backwards compatible.

Patch Changes

16.1.0

Minor Changes

  • 4d5dc6842 #3470 Thanks @TheSisb! - [MultiSelect Combobox] allow inversion of control with the internal state so that consumers can manage the selectedItems array themselves. This enables functionality like clearing the selectedItems through an external Button.

Patch Changes

  • f6320be83 #3462 Thanks @SiTaggart! - [combobox]: improve the way combobox handles hidden labels and conditional help text related aria attributes for improved accessibility

16.0.1

Patch Changes

  • e6ebb11f7 #3450 Thanks @TheSisb! - [MultiselectCombobox] fix bug where passing required would block form submit events. required now only blocks the submit event if no items are selected rather than when the input box is blank.
  • 29b6b7b65 #3459 Thanks @TheSisb! - [Combobox] Now opens the dropdown menu upwards when positioned towards the bottom of the viewport.

16.0.0

Major Changes

  • 733709127 #3395 Thanks @SiTaggart! - Modified the compile target of our JavaScript bundles from node to browser to minimize the risk of clashing with RequireJS. This is marked as a major out of an abundance of caution. You shouldn't need to do anything but we wanted you to be aware of the change on the off chance it has unintended consequences

Patch Changes

15.0.4

Patch Changes

  • abf6c1912 #3347 Thanks @SiTaggart! - [Combobox] small fix for multiselect combobox listbox positioning now that it uses a portal

15.0.3

Patch Changes

  • db35f7150 #3217 Thanks @TheSisb! - [Combobox]: ability to have a truly visually hidden label for search comboboxes

15.0.2

Patch Changes

  • 1ada1e37c #3260 Thanks @TheSisb! - [Combobox] prevent selection of disabled items when using keyboard navigation and the enter key

15.0.1

Patch Changes

  • 215a44717 #3142 Thanks @TheSisb! - [Combobox] Fix incorrect dropdown menu position when Combobox is opened on a scrolled page.
  • c882c0884 #3140 Thanks @TheSisb! - [Combobox] Multiselect Combobox now correctly clears the input value when selecting an item in the dropdown.

15.0.0

Major Changes

  • 3ab2bb6f4 #3114 Thanks @SiTaggart! - ### Breaking change

    We have moved @types/react and @types/react-dom to peer dependencies of the library. This should allow for greater control and backwards compatibility with older versions of React as Paste is no longer bundling the type libraries.

    Your application likely has both of these as dependencies anyway, but it is now up to you to manage that version number.

    Action needed

    Ensure @types/react and @types/react-dom are installed as dependencies of your application.

Patch Changes

14.0.0

Major Changes

  • d97098846 #3020 Thanks @SiTaggart! - This major version included listing all the missing peer dependencies for each Paste package.

    If you are using a package from Paste in isolation from Core, when upgrading to this latest version, be sure to correctly install all the missing peer dependencies.

Patch Changes

13.0.3

Patch Changes

  • 2fe476a71 #2949 Thanks @shleewhite! - [Combobox] Render the listbox in a portal to fix a bug where the contents of the listbox are cut off when it placed inside a scrolling container. Adds a new dependency on @radix-ui/react-use-rect.

13.0.2

Patch Changes

13.0.1

Patch Changes

  • efffcde51 #2782 Thanks @shleewhite! - [Combobox] remove inherited HTML autoComplete prop because it conflicts with the autocomplete prop and remove state prop from Multiselect Combobox because we don't support using it with the useComboboxState hook.

13.0.0

Patch Changes

12.2.0

Minor Changes

  • 312a3ccf6 #2660 Thanks @TheSisb! - [Combobox] Several improvements, including the addition of the much awaited MultiselectCombobox component!

    • Improve styling of Combobox menu items
    • Performance improvements around virtualized list items
    • Add a new emptyState prop that is rendered when there are no items in the list.
    • Accessibility improvements.

12.1.1

Patch Changes

  • 87146566c #2647 Thanks @SiTaggart! - [Combobox] Minor fix to controlled Comboboxes, where the input cursor would always jump to the end of the input string in autocomplete examples, even when you want to amend the beginning or middle. Cursor position should now remain in place as you type or modify the input value.

12.1.0

Minor Changes

  • b79d20d2a #2595 Thanks @TheSisb! - [InputBox, Combobox, Select] InputBox's InputChevronWrapper has refreshed styling which will appear in Select and Combobox. InputBox now exports a getInputChevronIconColor() function which returns a textColor to use for styling the icon child to the InputChevronWrapper.

12.0.0

Patch Changes

11.0.2

Patch Changes

  • ae9dd50f #2466 Thanks @TheSisb! - [All packages] Update our ESBuild version and remove minification of identifiers in our production builds.

11.0.1

Patch Changes

  • 9983b52e9 #2419 Thanks @gloriliale! - [Combobox, Data grid, Color contrast utils, Customization, Design tokens, Icons, Style props, Token contrast checker, Types, Utils, Website] Consolidate and update lodash dependencies and the way lodash is imported in our files, per lodash's guidance. Details: https://lodash.com/per-method-packages

11.0.0

Patch Changes

10.0.0

Patch Changes

9.1.0

Minor Changes

  • f5ce8b0c6 #2335 Thanks @andipants12! - [Fix] Remediate erratic scrolling behavior for grouped combobox. Scroll function for the virtualization library was being called even though grouped comboboxes are not virtualized. The jumping behavior on scroll was observed because the indices in the virtual list and the actual list did not match. Added guard to prevent the scroll function from the virtualization library from being called.

9.0.3

Patch Changes

  • 73c596919 #2269 Thanks @SiTaggart! - Fixed a regression with the compilation script that caused incompatible ESM module importing of JSON files.

9.0.2

Patch Changes

  • c867e3f48 #2237 Thanks @SiTaggart! - Updated a build dependency (esbuild) which changes the output of our builds slightly, without materially changing anything about the code.

9.0.1

Patch Changes

  • 72b2db53 #2155 Thanks @andipants12! - [Combobox] Do not conditionally render the useCombobox hook inside the Combobox component.

    • passing a state object from useCombobox via props to the component caused unexpected side effects
    • introduces conditional render of the component with its' own hook invocation, or with the forwarded state object

9.0.0

Patch Changes

8.1.1

Patch Changes

  • b7675915 #1985 Thanks @TheSisb! - For debugging purposes we now ship a filename.debug.js unminified version of each component or library in Paste.

8.1.0

Minor Changes

  • b17344da #1922 Thanks @andipants12! - [Combobox] Fix virtualization bug and add virtualization to combobox when an option template is used. The virtualization library we use, react-virtual, provides a ref that is required for correct sizing of virtualized items. The ref from this library's hook was being overridden by another, thus, the virtualized options were not resizing correctly. This behavior was observed in comboboxes that were not using option templates, and had sufficiently long option text.

Patch Changes

8.0.2

Patch Changes

  • 3a5a90b7 #1897 Thanks @nkrantz! - [Combobox] Enable Component to respect element customizations set on the customization provider. Component now enables setting an element name on the underlying HTML element and checks the emotion theme object to determine whether it should merge in custom styles to the ones set by the component author.
  • 7d231ec0 #1886 Thanks @andipants12! - [Combobox]: Update customization tests and stories to use more explicit a more explicit element name for the chevron wrapper. No consumer change required.

8.0.1

Patch Changes

  • fe4a2383 #1824 Thanks @SiTaggart! - [Combobox], [Select] and [Textarea] all given a default element name to meet their PropTypes validation.

8.0.0

Patch Changes

  • 2eb6dd74 #1771 Thanks @richbachman! - [Combobox] Added the element prop for customization in order to fix a Typescript error after the element prop was added as a required prop for InputBox. This does not include any default naming, tests, or stories. It only fixes the Typescript error.

  • Updated dependencies [c9cc610b]:

7.0.4

Patch Changes

  • b0e8ab80 #1725 Thanks @SiTaggart! - Allow Downshift to handle input events past by the component consumer. This allows for event data and internal state of the combobox to stay in sync correctly

7.0.3

Patch Changes

7.0.2

Patch Changes

  • 25a1f632 #1404 Thanks @SiTaggart! - update internal usage of design tokens to reflect new strong / weak nomenclature

7.0.1

Patch Changes

  • 7bfaff38 #1390 Thanks @TheSisb! - Combobox: improve accessibility of hovered combobox option by keeping it the same color.

7.0.0

Patch Changes

6.0.1

Patch Changes

6.0.0

Patch Changes

5.0.2

Patch Changes

5.0.1

Patch Changes

5.0.0

Patch Changes

4.0.3

Patch Changes

4.0.2

Patch Changes

4.0.1

Patch Changes

4.0.0

Minor Changes

  • f1675586 #1117 Thanks @TheSisb! - Comboboxes are now virtualized, but only when the 'groupItemsBy' and 'optionTemplate' props are not provided.

Patch Changes

3.0.1

Patch Changes

3.0.0

Patch Changes

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

2.1.1 (2021-01-25)

Bug Fixes

  • combobox: genericise some prop iterfaces for friendlier typings (66f3174)

2.1.0 (2021-01-21)

Features

2.0.7 (2021-01-15)

Note: Version bump only for package @twilio-paste/combobox

2.0.6 (2021-01-14)

Note: Version bump only for package @twilio-paste/combobox

2.0.5 (2021-01-13)

Note: Version bump only for package @twilio-paste/combobox

2.0.4 (2021-01-08)

Bug Fixes

  • combobox: fix grouped indexes so keyboard selection works (#1070) (e5b1a9f)

2.0.3 (2021-01-07)

Note: Version bump only for package @twilio-paste/combobox

2.0.2 (2021-01-06)

Note: Version bump only for package @twilio-paste/combobox

2.0.1 (2020-12-17)

Note: Version bump only for package @twilio-paste/combobox

2.0.0 (2020-12-17)

Bug Fixes

BREAKING CHANGES

  • combobox: component is now using fowardRef

1.4.31 (2020-12-15)

Note: Version bump only for package @twilio-paste/combobox

1.4.30 (2020-12-11)

Note: Version bump only for package @twilio-paste/combobox

1.4.29 (2020-12-11)

Note: Version bump only for package @twilio-paste/combobox

1.4.28 (2020-12-09)

Note: Version bump only for package @twilio-paste/combobox

1.4.27 (2020-12-09)

Note: Version bump only for package @twilio-paste/combobox

1.4.26 (2020-12-03)

Note: Version bump only for package @twilio-paste/combobox

1.4.25 (2020-12-02)

Note: Version bump only for package @twilio-paste/combobox

1.4.24 (2020-11-25)

Note: Version bump only for package @twilio-paste/combobox

1.4.23 (2020-11-16)

Note: Version bump only for package @twilio-paste/combobox

1.4.22 (2020-11-11)

Note: Version bump only for package @twilio-paste/combobox

1.4.21 (2020-11-10)

Note: Version bump only for package @twilio-paste/combobox

1.4.20 (2020-11-10)

Bug Fixes

1.4.19 (2020-11-09)

Note: Version bump only for package @twilio-paste/combobox

1.4.18 (2020-11-06)

Note: Version bump only for package @twilio-paste/combobox

1.4.17 (2020-11-05)

Note: Version bump only for package @twilio-paste/combobox

1.4.16 (2020-11-02)

Note: Version bump only for package @twilio-paste/combobox

1.4.15 (2020-10-30)

Note: Version bump only for package @twilio-paste/combobox

1.4.14 (2020-10-29)

Note: Version bump only for package @twilio-paste/combobox

1.4.13 (2020-10-28)

Bug Fixes

  • combobox: ensure listbox optionn ids in groups are always unique (#893) (91903a6)

1.4.12 (2020-10-23)

Note: Version bump only for package @twilio-paste/combobox

1.4.11 (2020-10-22)

Note: Version bump only for package @twilio-paste/combobox

1.4.10 (2020-10-21)

Note: Version bump only for package @twilio-paste/combobox

1.4.9 (2020-10-19)

Note: Version bump only for package @twilio-paste/combobox

1.4.8 (2020-10-15)

Note: Version bump only for package @twilio-paste/combobox

1.4.7 (2020-10-13)

Bug Fixes

  • combobox: hide chevron if set to autocomplete (#833) (41de665)

1.4.6 (2020-10-13)

Note: Version bump only for package @twilio-paste/combobox

1.4.5 (2020-10-09)

Note: Version bump only for package @twilio-paste/combobox

1.4.4 (2020-10-07)

Note: Version bump only for package @twilio-paste/combobox

1.4.3 (2020-10-07)

Note: Version bump only for package @twilio-paste/combobox

1.4.2 (2020-10-07)

Bug Fixes

  • combobox: correctly handle empty values to passed in props (e83e572)

1.4.1 (2020-10-07)

Note: Version bump only for package @twilio-paste/combobox

1.4.0 (2020-10-07)

Features

  • comboxbox: update to use form components (a7c53cf)

1.3.24 (2020-09-28)

Note: Version bump only for package @twilio-paste/combobox

1.3.23 (2020-09-22)

Note: Version bump only for package @twilio-paste/combobox

1.3.22 (2020-09-21)

Note: Version bump only for package @twilio-paste/combobox

1.3.21 (2020-09-15)

Note: Version bump only for package @twilio-paste/combobox

1.3.20 (2020-09-15)

Note: Version bump only for package @twilio-paste/combobox

1.3.19 (2020-09-14)

Note: Version bump only for package @twilio-paste/combobox

1.3.18 (2020-09-10)

Note: Version bump only for package @twilio-paste/combobox

1.3.17 (2020-09-09)

Note: Version bump only for package @twilio-paste/combobox

1.3.16 (2020-09-09)

Bug Fixes

  • combobox: handling refs in downshift v6 is different (526cfc9)

1.3.15 (2020-09-08)

Note: Version bump only for package @twilio-paste/combobox

1.3.14 (2020-09-08)

Note: Version bump only for package @twilio-paste/combobox

1.3.13 (2020-09-08)

Note: Version bump only for package @twilio-paste/combobox

1.3.12 (2020-09-03)

Note: Version bump only for package @twilio-paste/combobox

1.3.11 (2020-09-03)

Note: Version bump only for package @twilio-paste/combobox

1.3.10 (2020-09-02)

Note: Version bump only for package @twilio-paste/combobox

1.3.9 (2020-09-02)

Note: Version bump only for package @twilio-paste/combobox

1.3.8 (2020-08-31)

Note: Version bump only for package @twilio-paste/combobox

1.3.7 (2020-08-31)

Note: Version bump only for package @twilio-paste/combobox

1.3.6 (2020-08-31)

Note: Version bump only for package @twilio-paste/combobox

1.3.5 (2020-08-27)

Note: Version bump only for package @twilio-paste/combobox

1.3.4 (2020-08-24)

Note: Version bump only for package @twilio-paste/combobox

1.3.3 (2020-08-21)

Bug Fixes

  • combobox: provide a way to use the state hook (8c4cb81)

1.3.2 (2020-08-19)

Note: Version bump only for package @twilio-paste/combobox

1.3.1 (2020-08-12)

Note: Version bump only for package @twilio-paste/combobox

1.3.0 (2020-08-12)

Features

  • combobox: add inverse variant (603bcce)

1.2.2 (2020-08-12)

Note: Version bump only for package @twilio-paste/combobox

1.2.1 (2020-08-12)

Note: Version bump only for package @twilio-paste/combobox

1.2.0 (2020-08-07)

Features

  • combobox: unified design language update (d2e1fc1)

1.1.0 (2020-08-06)

Features

  • combobox: update combobox styles for UDL (e65ea9a)

1.0.1 (2020-08-06)

Note: Version bump only for package @twilio-paste/combobox

1.0.0 (2020-08-05)

Bug Fixes

  • icons: use display=block by default and rename 'iconColor' prop to 'color' (#637) (82beef4)

BREAKING CHANGES

  • icons: This change renames a key prop and changes the display mode from inline-flex to block

  • fix: use new icon prop (iconColor -> color)

  • test: update snapshots

  • chore(icons): update readme to mention correct display value

Co-authored-by: Rich Bachman rb@richbachman.com

  • chore(website): update icon doc prop table

Co-authored-by: Rich Bachman rb@richbachman.com

Co-authored-by: Rich Bachman rb@richbachman.com

0.3.4 (2020-08-04)

Note: Version bump only for package @twilio-paste/combobox

0.3.3 (2020-08-04)

Note: Version bump only for package @twilio-paste/combobox

0.3.2 (2020-07-31)

Note: Version bump only for package @twilio-paste/combobox

0.3.1 (2020-07-30)

Note: Version bump only for package @twilio-paste/combobox

0.3.0 (2020-07-29)

Features

  • combobox: add option groups and controlled input (6e3b21e)

0.2.20 (2020-07-29)

Note: Version bump only for package @twilio-paste/combobox

0.2.19 (2020-07-28)

Note: Version bump only for package @twilio-paste/combobox

0.2.18 (2020-07-22)

Note: Version bump only for package @twilio-paste/combobox

0.2.17 (2020-07-20)

Note: Version bump only for package @twilio-paste/combobox

0.2.16 (2020-07-15)

Note: Version bump only for package @twilio-paste/combobox

0.2.15 (2020-07-14)

Note: Version bump only for package @twilio-paste/combobox

0.2.14 (2020-07-14)

Note: Version bump only for package @twilio-paste/combobox

0.2.13 (2020-07-08)

Note: Version bump only for package @twilio-paste/combobox

0.2.12 (2020-07-02)

Note: Version bump only for package @twilio-paste/combobox

0.2.11 (2020-07-02)

Note: Version bump only for package @twilio-paste/combobox

0.2.10 (2020-07-01)

Note: Version bump only for package @twilio-paste/combobox

0.2.9 (2020-06-29)

Note: Version bump only for package @twilio-paste/combobox

0.2.8 (2020-06-25)

Note: Version bump only for package @twilio-paste/combobox

0.2.7 (2020-06-25)

Note: Version bump only for package @twilio-paste/combobox

0.2.6 (2020-06-23)

Note: Version bump only for package @twilio-paste/combobox

0.2.5 (2020-06-22)

Note: Version bump only for package @twilio-paste/combobox

0.2.4 (2020-06-18)

Note: Version bump only for package @twilio-paste/combobox

0.2.3 (2020-06-16)

Note: Version bump only for package @twilio-paste/combobox

0.2.2 (2020-06-12)

Note: Version bump only for package @twilio-paste/combobox

0.2.1 (2020-06-10)

Note: Version bump only for package @twilio-paste/combobox

0.2.0 (2020-06-08)

Features

  • combobox: expose onHighlightedIndexChange, onIsOpenChange props (5683733)

0.1.8 (2020-06-05)

Note: Version bump only for package @twilio-paste/combobox

0.1.7 (2020-06-04)

Bug Fixes

  • combobox: sync styles with Select styles (291b68e)

0.1.6 (2020-06-01)

Note: Version bump only for package @twilio-paste/combobox

0.1.5 (2020-06-01)

Bug Fixes

  • combobox: expose onSelectedItemChange and UseComboboxProp (ca07615)

0.1.4 (2020-06-01)

Note: Version bump only for package @twilio-paste/combobox

0.1.3 (2020-05-28)

Note: Version bump only for package @twilio-paste/combobox

0.1.2 (2020-05-27)

Note: Version bump only for package @twilio-paste/combobox

0.1.1 (2020-05-27)

Note: Version bump only for package @twilio-paste/combobox

0.1.0 (2020-05-22)

Features

  • combobox: add combobox package (a0d2bfa)

0.0.2 (2019-10-29)

Note: Version bump only for package @twilio-paste/combobox

0.0.1 (2019-08-15)

Note: Version bump only for package @twilio-paste/combobox