react-dropdown, react-dropdown-select, and react-select are all npm packages that provide customizable dropdown (select) components for React applications. These libraries help developers implement user-friendly selection interfaces with features like search, multi-select, custom styling, and accessibility support. While they share the same basic goal — replacing or enhancing the native HTML <select> element — they differ significantly in flexibility, feature set, and architectural approach.
When building forms or filters in React apps, you’ll often need more than the native <select> element. The three libraries — react-dropdown, react-dropdown-select, and react-select — all aim to solve this, but they take very different approaches. Let’s compare them across key engineering concerns.
react-dropdown is a minimal implementation with no external dependencies. It renders a simple styled dropdown using inline styles and basic event handling. It doesn’t use portals, so it can be clipped by overflow containers.
// react-dropdown
import Dropdown from 'react-dropdown';
import 'react-dropdown/style.css';
const options = ['apple', 'banana', 'cherry'];
<Dropdown options={options} onChange={handleChange} value="apple" placeholder="Select..." />
react-dropdown-select is also dependency-free but gives you complete control over rendering. It uses a render-prop pattern and doesn’t ship any default styles — you write all CSS yourself. It supports portals via the portal prop.
// react-dropdown-select
import Select from 'react-dropdown-select';
<Select
options={options}
onChange={handleChange}
values={[{ value: 'apple' }]}
contentRenderer={({ state }) => <div>{state.values[0]?.value || 'Select...'}</div>}
/>
react-select is a mature, self-contained component with its own styling system (emotion). It uses React Portals by default to avoid clipping, includes built-in accessibility attributes, and supports theming via props or styled-components.
// react-select
import Select from 'react-select';
const options = [{ value: 'apple', label: 'Apple' }, { value: 'banana', label: 'Banana' }];
<Select options={options} onChange={handleChange} defaultValue={options[0]} />
All three support searchable dropdowns, but with different levels of control.
react-dropdown does not support search out of the box. You’d need to build this yourself or choose another library.
react-dropdown-select enables search with the searchable prop and lets you customize the search logic via searchFn.
// react-dropdown-select with custom search
<Select
searchable
searchFn={(option, query) => option.value.toLowerCase().includes(query.toLowerCase())}
options={options}
/>
react-select includes robust search with fuzzy matching by default. You can override filtering logic using the filterOption prop.
// react-select with custom filter
<Select
options={options}
filterOption={(candidate, input) => candidate.label.toLowerCase().includes(input.toLowerCase())}
/>
react-dropdown uses a single CSS file. Customization requires overriding class names or using the className prop. No dynamic theming support.
// react-dropdown custom class
<Dropdown className="my-custom-dropdown" />
react-dropdown-select ships no styles. You style everything via CSS classes or inline styles passed through props like dropdownHandleRenderer or contentRenderer.
// react-dropdown-select fully custom
<Select
dropdownRenderer={({ props, state, methods }) => (
<div style={{ background: '#f0f0f0', border: '1px solid #ccc' }}>
{props.options.map(opt => <div key={opt.value}>{opt.label}</div>)}
</div>
)}
/>
react-select provides a powerful theming API. You can modify colors, spacing, and even pseudo-states programmatically.
// react-select custom theme
<Select
theme={theme => ({
...theme,
borderRadius: 8,
colors: {
...theme.colors,
primary: 'hotpink',
primary25: 'lightpink'
}
})}
/>
react-dropdown has basic keyboard support (arrow keys, Enter) but lacks proper ARIA attributes. Not recommended for applications requiring WCAG compliance.
react-dropdown-select leaves accessibility entirely up to the developer. Since you control rendering, you must manually add role, aria-*, and focus management.
react-select includes comprehensive accessibility: proper ARIA roles, live announcements, full keyboard navigation (including type-to-search), and screen reader support out of the box.
// react-select is accessible by default — no extra code needed
<Select options={options} />
| Feature | react-dropdown | react-dropdown-select | react-select |
|---|---|---|---|
| Multi-select | ❌ | ✅ | ✅ |
| Async loading | ❌ | ✅ (loadOptions) | ✅ (AsyncSelect) |
| Creatable options | ❌ | ✅ (creatable) | ✅ (CreatableSelect) |
| Grouped options | ❌ | ✅ | ✅ |
| Virtualized scrolling | ❌ | ❌ | ✅ (via react-window integration) |
| Clearable | ❌ | ✅ | ✅ |
Example: Multi-select in react-dropdown-select:
<Select
multi
values={selectedValues}
onChange={setSelectedValues}
options={options}
/>
Example: Async loading in react-select:
import AsyncSelect from 'react-select/async';
const loadOptions = (input) => fetch(`/api/search?q=${input}`).then(res => res.json());
<AsyncSelect loadOptions={loadOptions} />
As of 2024, react-dropdown shows signs of abandonment — its last meaningful update was years ago, and it lacks support for modern React features like concurrent mode. While it works for trivial cases, it’s risky for long-term projects.
Both react-dropdown-select and react-select are actively maintained. react-select has a larger team and more frequent releases, while react-dropdown-select follows a minimalist philosophy with slower but steady updates.
react-dropdown (but only if you accept the maintenance risk).react-dropdown-select.react-select.In most professional contexts — especially where accessibility, internationalization, or complex user workflows are involved — react-select is the safest and most scalable choice. Reserve the lighter alternatives for internal tools or prototypes where those concerns don’t apply.
Choose react-dropdown if you need a minimal, lightweight dropdown for simple use cases with basic styling requirements. It's suitable for projects where bundle size is critical and advanced features like async loading, extensive customization, or complex accessibility aren't needed. However, note that it hasn't seen active maintenance recently and lacks many modern dropdown capabilities found in more robust alternatives.
Choose react-dropdown-select if you want a zero-dependency, highly customizable dropdown that gives you full control over rendering and behavior without relying on external UI libraries. It's ideal for teams that prefer writing their own styles from scratch and need features like search, multi-select, and creatable options without the overhead of a larger ecosystem. Its API is straightforward but requires more manual setup for advanced interactions.
Choose react-select if you need a production-ready, feature-rich dropdown component with strong accessibility support, extensive theming options, async data loading, and a large ecosystem of extensions. It's the best fit for enterprise applications where UX consistency, keyboard navigation, screen reader compatibility, and maintainability are priorities. The trade-off is a larger bundle size and more complex configuration for simple cases.
Simple Dropdown component for React, inspired by react-select
// with npm
$ npm install react-dropdown --save
// with yarn
$ yarn add react-dropdown
If you want to support React version under v0.13, use react-dropdown@v0.6.1
This is the basic usage of react-dropdown
import Dropdown from 'react-dropdown';
import 'react-dropdown/style.css';
const options = [
'one', 'two', 'three'
];
const defaultOption = options[0];
<Dropdown options={options} onChange={this._onSelect} value={defaultOption} placeholder="Select an option" />;
Options
Flat Array options
const options = [
'one', 'two', 'three'
];
Object Array options
const options = [
{ value: 'one', label: 'One' },
{ value: 'two', label: 'Two', className: 'myOptionClassName' },
{
type: 'group', name: 'group1', items: [
{ value: 'three', label: 'Three', className: 'myOptionClassName' },
{ value: 'four', label: 'Four' }
]
},
{
type: 'group', name: 'group2', items: [
{ value: 'five', label: 'Five' },
{ value: 'six', label: 'Six' }
]
}
];
When using Object options you can add to each option a className string to further customize the dropdown, e.g. adding icons to options
Disabling the Dropdown
Just pass a disabled boolean value to the Dropdown to disable it. This will also give you a .Dropdown-disabled class on the element, so you can style it yourself.
<Dropdown disabled onChange={this._onSelect} value={defaultOption} placeholder="Select an option" />;
className
The className prop is passed down to the wrapper div, which also has the Dropdown-root class.
<Dropdown className='myClassName' />;
controlClassName
The controlClassName prop is passed down to the control div, which also has the Dropdown-control class.
<Dropdown controlClassName='myControlClassName' />;
placeholderClassName
The placeholderClassName prop is passed down to the placeholder div, which also has the Dropdown-placeholder class.
<Dropdown placeholderClassName='myPlaceholderClassName' />;
menuClassName
The menuClassName prop is passed down to the menu div (the one that opens and closes and holds the options), which also has the Dropdown-menu class.
<Dropdown menuClassName='myMenuClassName' />;
arrowClassName
The arrowClassName prop is passed down to the arrow span , which also has the Dropdown-arrow class.
<Dropdown arrowClassName='myArrowClassName' />;
arrowClosed, arrowOpen
The arrowClosed & arrowOpen props enable passing in custom elements for the open/closed state arrows.
<Dropdown
arrowClosed={<span className="arrow-closed" />}
arrowOpen={<span className="arrow-open" />}
/>;
Check more examples in the example folder.
Run example
$ npm start
MIT | Build for CSViz project @Wiredcraft