react-native-khaled-salem-dropdown

React Native Custom Dropdown

React Native Custom Dropdown is a versatile component that allows you to create customized dropdown menus in your React Native applications.

Installation

You can install this package via npm:

npm install react-native-khaled-salem-dropdown

Usage

To use the Dropdown component in your React Native application, follow these steps:

1. Import the Dropdown component from the package:

   import { Dropdown } from 'react-native-khaled-salem-dropdown';

2. Use the Dropdown component in your JSX code, passing the necessary props:

   <Dropdown
     data={uniqueCategories}
     isDropdownOpen={isDropdownOpen}
     handleDataChange={handleCategoryChange}
     style={{
       top: 40,
       left: 10,
       backgroundColor: 'white',
       zIndex: 2,
       padding: 10,
     }}
   />

   • data: An array of unique categories or items.
   • isDropdownOpen: A boolean indicating whether the dropdown should be open.
   • handleDataChange: A callback function to handle changes when an item is selected.
   • style: Accepts custom styles for the dropdown (e.g., top, left, backgroundColor, zIndex, padding).

3. Customize the appearance and behavior of the dropdown according to your application's needs.

Example

Here's a simple example of how to use the Dropdown component:

import React, { useState } from 'react';
import { View, Text, StyleSheet, TouchableOpacity } from 'react-native';
import { Dropdown } from 'react-native-khaled-salem-dropdown';

const App = () => {
  const [isDropdownOpen, setIsDropdownOpen] = useState(false);
  const [selectedCategory, setSelectedCategory] = useState('');

  const uniqueCategories = new Set(['Category 1', 'Category 2', 'Category 3']);

  const handleCategoryChange = (category) => {
    setSelectedCategory(category);
    setIsDropdownOpen(false);
  };

  return (
    <View style={styles.container}>
      <TouchableOpacity onPress={() => setIsDropdownOpen(!isDropdownOpen)}>
        <Text>Open Dropdown</Text>
      </TouchableOpacity>
      <Dropdown
        data={uniqueCategories}
        isDropdownOpen={isDropdownOpen}
        handleCategoryChange={handleCategoryChange}
        style={{
          top: 40,
          left: 10,
          backgroundColor: 'white',
          zIndex: 2,
          padding: 10,
        }}
      />
      <Text>Selected Category: {selectedCategory}</Text>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
  },
});

export default App;

Props

data (Array)

An array of unique categories or items to display in the dropdown.

isDropdownOpen (Boolean)

A boolean indicating whether the dropdown should be open.

handleDataChange (Function)

A callback function that gets called when an item is selected from the dropdown.

style (Object)

Accepts custom styles to customize the appearance of the dropdown.

License

This project is licensed under the ISC License - see the LICENSE file for details.