react-dropdown-select vs react-select
React Select Libraries
react-dropdown-selectreact-selectSimilar Packages:

React Select Libraries

React Select libraries are essential tools for implementing dropdowns and select inputs in React applications. They provide developers with customizable and flexible components that enhance user experience when selecting options from a list. These libraries are designed to handle various use cases, from simple dropdowns to complex multi-select scenarios, and include features such as searchability, accessibility, and keyboard navigation. They help streamline the process of managing user input while ensuring a polished and interactive UI.

Npm Package Weekly Downloads Trend

3 Years

Github Stars Ranking

Stat Detail

Package
Downloads
Stars
Size
Issues
Publish
License
react-dropdown-select0361187 kB3110 months agoMIT
react-select028,053726 kB4869 months agoMIT

Feature Comparison: react-dropdown-select vs react-select

Customization

  • react-dropdown-select:

    react-dropdown-select provides a simple API for customization, allowing developers to easily style the dropdown and its options using CSS. It supports custom renderers for options and values, enabling unique designs without much overhead.

  • react-select:

    react-select offers extensive customization options, including custom components for the dropdown, option rendering, and multi-value display. It allows for deep customization of styles through a powerful theming system and supports various props for fine-tuning the component's behavior.

Performance

  • react-dropdown-select:

    react-dropdown-select is optimized for performance with a lightweight footprint, making it suitable for applications where speed is essential. It handles rendering efficiently, ensuring that even with multiple dropdowns, the performance remains smooth.

  • react-select:

    react-select is designed to handle large datasets efficiently. It includes features like lazy loading and virtualization to improve performance when dealing with many options, ensuring that the dropdown remains responsive even with extensive lists.

Accessibility

  • react-dropdown-select:

    react-dropdown-select includes basic accessibility features, but it may require additional work to fully comply with ARIA standards. Developers need to ensure proper keyboard navigation and screen reader support for a fully accessible experience.

  • react-select:

    react-select is built with accessibility in mind, adhering to ARIA guidelines. It provides keyboard navigation out of the box and is designed to be compatible with screen readers, making it a better choice for applications that prioritize accessibility.

Multi-Select Support

  • react-dropdown-select:

    react-dropdown-select supports multi-select functionality, allowing users to select multiple options easily. It provides a straightforward interface for managing selected values and displaying them in a user-friendly manner.

  • react-select:

    react-select also supports multi-select, offering advanced features like select all, custom tags, and the ability to manage complex selections. It is ideal for applications that require sophisticated multi-select capabilities.

Documentation and Community Support

  • react-dropdown-select:

    react-dropdown-select has decent documentation that covers basic usage and examples. However, its community is smaller compared to react-select, which may limit the availability of third-party resources and support.

  • react-select:

    react-select boasts comprehensive documentation with detailed examples and a large community. This extensive support network provides numerous resources, tutorials, and third-party integrations, making it easier for developers to find solutions and best practices.

How to Choose: react-dropdown-select vs react-select

  • react-dropdown-select:

    Choose react-dropdown-select if you need a lightweight, straightforward dropdown solution with built-in support for multi-select and search capabilities. It is ideal for applications where simplicity and ease of use are prioritized, and you want a component that can be easily styled and customized.

  • react-select:

    Choose react-select if you require a more robust and feature-rich dropdown component. It offers extensive customization options, including asynchronous loading of options, advanced filtering, and accessibility features. This package is well-suited for applications that need to handle large datasets or require complex selection logic.

README for react-dropdown-select

react-dropdown-select

Customisable dropdown select for react

Coverage Status Codacy Badge

Features

  • configurable via props
  • total custom components overrides for all internals via render prop callbacks (with access to internal props, state and methods)
  • stylable via css (or custom components)
  • portal support for rendering dropdown outside local DOM tree. e.g. in document.body
  • auto position
  • small bundle size

Installation

npm install --save react-dropdown-select

Web site

Web site, docs and demo

Motivation

react-select is very nice, but sometimes project requirements are beyond it's abilities

Usage

import:

import Select from "react-dropdown-select";

and use as:

const options = [
  {
    value: 1,
    label: 'Leanne Graham'
  },
  {
    value: 2,
    label: 'Ervin Howell'
  }
];

<Select options={options} onChange={(values) => this.setValues(values)} />;

If your options don't have value and label fields, include labelField and valueField in the props:

const options = [
  {
    id: 1,
    name: 'Leanne Graham'
  },
  {
    id: 2,
    name: 'Ervin Howell'
  }
];

<Select
  options={options}
  labelField="name"
  valueField="id"
  onChange={(values) => this.setValues(values)}
/>;

options and onChange are the minimum required props

Help and Contributions

How to help/contribute

  • fix issues, pull request are very welcome
  • write, improve docs
  • write tests (we use jest)
  • suggest features and improvements

Demo

Edit react-dropdown-select

API

Component props

PropTypeDefaultDescription
valuesarray[]Selected values
optionsarray[]Available options, (option with key disabled: true will be disabled)
keepOpenboolfalseIf true, dropdown will always stay open (good for debugging)
defaultMenuIsOpenboolfalseIf true, dropdown will be open by default
autoFocusboolfalseIf true, and searchable, dropdown will auto focus
clearOnBlurbooltrueIf true, and searchable, search value will be cleared on blur
clearOnSelectbooltrueIf true, and searchable, search value will be cleared upon value select/de-select
namestringnullIf set, input type hidden would be added in the component with the value of the name prop as name and select's values as value
requiredboolfalseIf set, input type hidden would be added in the component with required prop as true/false
patternstringnullIf set, input type hidden would be added in the component with pattern prop as regex
dropdownGapnumber5Gap between select element and dropdown
multiboolfalseIf true - will act as multi-select, if false - only one option will be selected at the time
placeholderstring"Select..."Placeholder shown where there are no selected values
addPlaceholderstring""Secondary placeholder on search field if any value selected
disabledboolfalseDisable select and all interactions
styleobject{}Style object to pass to select
classNamestringCSS class attribute to pass to select
loadingboolfalseLoading indicator
clearableboolfalseClear all indicator
searchablebooltrueIf true, select will have search input text
separatorboolfalseSeparator line between close all and dropdown handle
dropdownHandlebooltrueDropdown handle to open/close dropdown
dropdownHeightstring"300px"Minimum height of a dropdown
directionstring"ltr"direction of a dropdown "ltr", "rtl" or "auto"
searchBystringlabelSearch by object property in values
sortBystringnullSort by object property in values
labelFieldstring"label"Field in data to use for label
valueFieldstring"value"Field in data to use for value
colorstring"#0074D9"Base color to use in component, also can be overwritten via CSS
closeOnScrollboolfalseIf true, scrolling the page will close the dropdown
closeOnSelectboolfalseIf true, selecting option will close the dropdown
closeOnClickInputboolfalseIf true, clicking input will close the dropdown if you are not searching.
dropdownPositionstring"bottom"Available options are "auto", "top" and "bottom" defaults to "bottom". Auto will adjust itself according Select's position on the page
keepSelectedInListbooltrueIf false, selected item will not appear in a list
portalDOM elementfalseIf valid dom element specified - dropdown will break out to render inside the specified element
createboolfalseIf true, select will create value from search string and fire onCreateNew callback prop
backspaceDeletebooltrueIf true, backspace key will delete last value
createNewLabelstring"add {search}"If create set to true, this will be the label of the "add new" component. {search} will be replaced by search value
disabledLabelstring"disabled"Label shown on disabled field (after) the text
selectAllboolfalseAllow to select all
selectAllLabelstring"Select all"Label for "Select all"
clearAllLabelstring"Clear all"Label for "Clear all"
additionalPropsobjectnullAdditional props to pass to Select

Callback props

by using renderer props to override components some of the functionality will have to be handled manually with a help of internal props, states and methods exposed

PropTypeDefaultDescription
onChangefuncOn values change (user and internally triggered) callback, returns array of values objects
onSelectfuncOn values change (user triggered) callback, returns array of values objects
onDeselectfuncOn values change (user triggered) callback, returns array of values objects
onDropdownClosefuncFires upon dropdown close
onDropdownOpenfuncFires upon dropdown open
onCreateNewfuncFires upon creation of new item if create prop set to true
onClearAllfuncFires upon clearing all values (via custom renderers)
onSelectAllfuncFires upon selecting all values (via custom renderers)
onDropdownCloseRequestfuncundefinedFires upon dropdown closing state, stops the closing and provides own method close()
contentRendererfuncOverrides internal content component (the contents of the select component)
itemRendererfuncOverrides internal item in a dropdown
noDataRendererfuncOverrides internal "no data" (shown where search has no results)
optionRendererfuncOverrides internal option (the pillow with an "x") on the select content
inputRendererfuncOverrides internal input text
loadingRendererfuncOverrides internal loading
clearRendererfuncOverrides internal clear button
separatorRendererfuncOverrides internal separator
dropdownRendererfuncOverrides internal dropdown component
dropdownHandleRendererfuncOverrides internal dropdown handle
searchFnfuncundefinedOverrides internal search function
handleKeyDownFnfuncundefinedOverrides internal keyDown function

License

MIT