react-adaptive-select
v0.0.6
Published
A customizable, searchable dropdown select component for React applications. This component is adaptive to screen or parent container size.
Downloads
15
Readme
React Adaptive Select
This package provides a customizable, searchable dropdown select component for React applications and this is adaptive dropdown according to screen or parent container.
Installation
npm install react-adaptive-select
or
yarn install react-adaptive-select
Usage
import { Select } from "react-adaptive-select"
import 'react-adaptive-select/dist/style.css'
function App() {
const options = [
{ label: "Option 1", value: "optn1" },
{ label: "Option 2", value: "optn2" },
{ label: "Option 3", value: "optn3" },
{ label: "Option 4", value: "optn4" },
{ label: "Option 5", value: "optn5" },
{ label: "Option 6", value: "optn6" },
{ label: "Option 7", value: "optn7" },
{ label: "React select", value: "react_select" },
];
return (
<>
<Select
onOpen={() => console.log("Dropdown opened")}
onClose={() => console.log("Dropdown closed")}
onSelect={(option) => console.log("Selected option: ", option)}
placeholder="Select an option"
onSearch={(searchTerm) => console.log("Search term: ", searchTerm)}
options={options}
// defaultSelect={options[0]} // pass a default index object
isSearchFocus={true}
isSearchable={true}
onPositionChange={(position) => console.log("Dropdown position: ", position)}
/>
</>
)
}
export default App
| Prop | Type | Default | Description |
| ---- | ---- | ------- | ----------- |
| parentRef | React.RefObject | null | A reference to the parent element of the dropdown. This is used to calculate the position of the dropdown relative to its parent, allowing for more flexible positioning. |
| onOpen | () => void
| null | A callback function that is triggered when the dropdown is opened. This can be used to perform actions like logging, analytics tracking, or state updates. |
| onClose | () => void
| null | A callback function that is triggered when the dropdown is closed. This can be used to perform cleanup actions or state updates. |
| onSelect | (option: { label: string; value: string }) => void | null | A callback function that is triggered when an option is selected. It receives the selected option as a parameter, allowing you to use this data in your application. |
| placeholder | string
| "Select an option" | The placeholder text for the dropdown. This is displayed when no option is selected, guiding the user to make a selection. |
| onSearch | (searchTerm: string) => void | null | A callback function that is triggered when a search is performed. It receives the search term as a parameter, allowing you to perform custom search logic. |
| options | { label: string; value: string }[] | [] | An array of options for the dropdown. Each option is an object with a label
(displayed in the dropdown) and a value
(used when an option is selected). |
| defaultSelect | { label: string; value: string } | null | The default selected option. This is the option that is selected when the dropdown is first rendered. |
| isSearchFocus | boolean
| false | If true, the search input will be automatically focused when the dropdown is opened. This can improve usability by allowing the user to start typing immediately. |
| isSearchable | boolean
| true | If true, the dropdown will include a search input. This allows the user to filter the options by typing, which can be useful for large option lists. |
| onPositionChange | (position: string) => void | null | A callback function that is triggered when the dropdown position changes. It receives the new position as a parameter, allowing you to react to changes in the dropdown's position. |
License
MIT
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
Author
This package was created by Sahibe Alam. at Yudiz Solutions Limited.